Merge pull request #36 from wmorgue/userdefaults

Translation for UserDefaults article

Author: wmorgue

.yaspellerrc.json

@@ -59,6 +59,7 @@
     "RoundedProgressViewStyle",
     "inGracePeriod",
     "AppStore",
+    "AppGroup",
     "willAutoRenew",
     "autoRenewPreference",
     "expirationReason",
@@ -90,6 +91,7 @@
     "DnD",
     "LibraryContentProvider",
     "UserProfileLibrary",
+    "UserDefaults",
     "titleEdgeInsets",
     "SparrowKit",
     "imageEdgeInsets",

en/meta/articles.json

@@ -89,5 +89,17 @@
         ],
         "updated_date": "11.02.2022",
         "added_date": "11.02.2022"
+    },
+    "how-to-delete-userdefaults-on-macos-catalyst" : {
+        "title" : "How to clean up UserDefaults for Mac Catalyst",
+        "description" : "How to remove data for Catalyst application including AppGroup, Realm and UserDefaults.",
+        "category" : "development",
+        "author" : "ivanvorobei",
+        "keywords" : [
+            "UserDefaults",
+            "Catalyst"
+        ],
+        "updated_date" : "14.02.2022",
+        "added_date" : "14.02.2022"
     }
 }

en/tutorials/how-to-delete-userdefaults-on-macos-catalyst.md

@@ -0,0 +1,55 @@
+To reset a macOS Catalyst application you need to know the name of the user folder, the application bundle, the AppGroup, and the suit for UserDefaults (if you use it). In the tutorial I will use the following examples:
+
+User folder `ivanvorobei`, app bundle `by.ivanvorobei.apps.debts`, AppGroup identifier `group.by.ivanvorobei.apps.debts`.
+
+Be careful to use the values from your application.
+
+## Clean up UserDefaults
+
+If you want to delete the default `UserDefaults` open a terminal and enter the command:
+
+```swift
+// Delete `UserDefaults` completely
+defaults delete by.ivanvorobei.apps.debts
+
+// Delete from `UserDefaults` by key
+defaults delete by.ivanvorobei.apps.debts key
+```
+
+For custom domain use the following command:
+
+```swift
+// Created like this
+// UserDefaults(suiteName: "Custom")
+defaults delete suit.name
+```
+
+## AppGroup
+
+If you use an `AppGroup` you need to delete the following folders:
+
+```swift
+/Users/ivanvorobei/Library/Group Containers/group.by.ivanvorobei.apps.debts
+/Users/ivanvorobei/Library/Application Scripts/group.by.ivanvorobei.apps.debts
+```
+
+If you store in the default path, it will be the following directory:
+
+```swift
+/Users/ivanvorobei/Library/Containers/by.ivanvorobei.apps.debts
+```
+
+## Realm mobile database
+
+The `Realm` database files are stored as regular files. They are either in the AppGroup or in the default directory. By performing the steps above, the database will be deleted.
+
+## Other directories
+
+I found more folders, but I don't know what they are for. I will leave the paths here:
+
+```swift
+/Users/ivanvorobei/Library/Application Scripts/group.by.ivanvorobei.apps.debts
+/Users/ivanvorobei/Library/Developer/Xcode/Products/by.ivanvorobei.apps.debts (macOS)
+```
+
+If you know what they are for or know more folders, let me know - I'll update the tutorial.