【Swift】UserDefaultsをもう少しちゃんと理解する

「UserDefaults消したーーーーい」と思って調べるとこのようなコードと出会った。

```swift
let appDomain = Bundle.main.bundleIdentifier
UserDefaults.standard.removePersistentDomain(forName: appDomain!)
```

なんとなくBundle Identifierを取ってきて指定すると消せるんだなというのはわかるが、UserDefaultsを消すときにBundle Identifierが必要なのかとか色々考えてしまったのでUserDefaultsについて調べてみました。

# バージョン

Xcode: v11.3
Swift: v.5.3.2
iOS: v14.4

# 対象読者

- iOSアプリ開発初心者

- UserDefaultsをなんとなく使っている人

# 内容

## UserDefaultsとは

UserDefaultsはユーザーごとの設定など保存するために提供されたKey-Valueストアです。また、UserDefaultsに保存された値は、削除しない限り永続的に保存され続けます。

ご存知ではあると思いますが、ユーザー個人のデータを保存する簡易的なデータベースみたいな感じですね。

## Bundle IdentifierとUserDefaultsの関係は？

本題です。

結論から言うと、UserDefaultsを介して保存されるアプリ毎の設定を格納するファイル名にBundle Identifierが使われるという関係です。つまり、**UserDefaultsはデータの保存領域で、Bundle Identifierはその領域の識別子として使われるという関係です。**

### つまりどういう事？

ここからはコードを使って説明します。

UserDefaultsは初めて書き込みが行われた時に`アプリのRoot/Library/Preferences`に `Bundle Identifier名.plist`というファイルをデバイス内に生成します。

まず、`アプリのRoot/Library/Preferences`に`Bundle Identifier名.plist`が生成されていないことを確認しましょう。

`Library/Preferences`までのパスは`FileManager`を使うことで取得できます。

```swift:ViewController.swift
class ViewController: UIViewController {

	override func viewDidLoad() {
		super.viewDidLoad()
		getFileNamesFromPreferences() // 何も出力されない
	}

	func getFileNamesFromPreferences() {
		
		// Libraryまでのファイルパスを取得
		let filePath = FileManager.default.urls(for: .libraryDirectory, in: .userDomainMask)[0]
		
		// filePathにPreferencesを追加
		let preferences = filePath.appendingPathComponent("Preferences")
		
		// Library/Preferences内のファイルのパスを取得
		guard let fileNames = try? FileManager.default.contentsOfDirectory(at: preferences, includingPropertiesForKeys: nil) else {
			return
		}
		
		// Library/Preferences内のファイル名を出力
		fileNames.compactMap { fileName in
			print(fileName.lastPathComponent)
		}
	}
}

```



### Bundle Identifier名.plistを生成してみる

UserDefaultsに値を保存することでBundle Identifier名.plistが生成されるか実際に確認してみましょう。

```diff_swift:ViewController.swift
import UIKit

class ViewController: UIViewController {

	override func viewDidLoad() {
		super.viewDidLoad()
		getFileNamesFromPreferences() // 何も出力されない
+       UserDefaults.standard.set("Value1", forKey: "test") // UserDefaultsに値を保存
+       getFileNamesFromPreferences() // com.test.UserDefaults.plist
	}

	func getFileNamesFromPreferences() {
		
		// Libraryまでのファイルパスを取得
		let filePath = FileManager.default.urls(for: .libraryDirectory, in: .userDomainMask)[0]
		
		// filePathにPreferencesを追加
		let preferences = filePath.appendingPathComponent("Preferences")
		
		// Library/Preferences内のファイルのパスを取得
		guard let fileNames = try? FileManager.default.contentsOfDirectory(at: preferences, includingPropertiesForKeys: nil) else {
			return
		}
		// Library/Preferences内のファイル名を出力
		fileNames.compactMap { fileName in
			print(fileName.lastPathComponent)
		}
	}
}
```

お手元で実行してみるとプロジェクトの`Bundle Identifier名.plist`が保存されていることがわかると思います。

ちなみに`preferences`の値を使ってターミナルからも確認できます。

### removePersistentDomain(forName:)

UserDefaultsに書き込みを行った際に生成される.plistファイルはBundle Identifier名でドメイン(簡単に言うと領域, 区画みたいなやつ)として認識されるみたいで、ドメイン名を指定することでドメイン内の値をすべて消すことができるみたいです。

```diff_swift:ViewController.swift
import UIKit

class ViewController: UIViewController {

	override func viewDidLoad() {
		super.viewDidLoad()
		getFileNamesFromPreferences() // 何も出力されない
		UserDefaults.standard.set("Value1", forKey: "test") // UserDefaultsに値を保存
		getFileNamesFromPreferences() // com.test.UserDefaults.plist
+		UserDefaults.standard.removePersistentDomain(forName: "com.test.UserDefaults.plist") // ドメイン内の値を全て削除
+		getFileNamesFromPreferences() // com.test.UserDefaults.plist
	}

	func getFileNamesFromPreferences() {
		
		// Libraryまでのファイルパスを取得
		let filePath = FileManager.default.urls(for: .libraryDirectory, in: .userDomainMask)[0]
		
		// filePathにPreferencesを追加
		let preferences = filePath.appendingPathComponent("Preferences")
		
		// Library/Preferences内のファイルのパスを取得
		guard let fileNames = try? FileManager.default.contentsOfDirectory(at: preferences, includingPropertiesForKeys: nil) else {
			return
		}
		// Library/Preferences内のファイル名を出力
		fileNames.compactMap { fileName in
			print(fileName.lastPathComponent)
		}
	}
}

```

実行結果からわかるように、.plistファイル自体は削除されないみたいです。

# 終わりに

今回はUserDefaultsの内部構造に踏み込んでみました。

iOSの勉強は初めてからずっと心にあったモヤモヤが解消されてよかったです。

みなさんの参考になれば幸いです。



# 参考文献

[swift - アプリ内で保存したファイルの一覧を取得したい - スタック・オーバーフロー](https://ja.stackoverflow.com/questions/40381/%E3%82%A2%E3%83%97%E3%83%AA%E5%86%85%E3%81%A7%E4%BF%9D%E5%AD%98%E3%81%97%E3%81%9F%E3%83%95%E3%82%A1%E3%82%A4%E3%83%AB%E3%81%AE%E4%B8%80%E8%A6%A7%E3%82%92%E5%8F%96%E5%BE%97%E3%81%97%E3%81%9F%E3%81%84)

[Swift5でDocumentディレクトリのファイルにアクセスする - Qiita](https://qiita.com/morimorim/items/301cd85f83523b3bb56e)

[【Swift】URLでパスを扱うときに便利なプロパティとメソッド - Qiita](https://qiita.com/toshi586014/items/52b87c034e411681ca7b)

[UserDefaults under the hood 💁🏻‍ | by Aaina jain | Swift India | Medium](https://medium.com/swift-india/userdefaults-under-the-hood-457461c8d262)