【Swift】UserDefaultsの使い方とは?データの保存/削除/取得/更新方法
この記事からわかること
- SwiftでUIKit使用時UserDefaultsの使い方と実装方法
- UserDefaultsとは?
- アプリが停止してもデータを保持させるには?
- CRUD処理(保存/更新/取得/削除)する方法
- UserDefaultsのデータ保存場所とは?
- UserDefaultsのデータを閲覧する方法
index
[open]
\ アプリをリリースしました /
友達や家族の誕生日をメモ!通知も届く-みんなの誕生日-
posted withアプリーチ
アプリが停止してもデータを保持させるために使用できるUserDefaults
の使い方と実装方法をまとめていきたいと思います。
iOSアプリで端末(ローカル)にデータを永続的に保存する方法
Swiftではアプリ内からデータを永続的に保存する手段がいくつか存在します。
- テキストファイル
- UserDefaults
- Realm Swift(ライブラリ)
- Keychain
それぞれに一長一短がありますが、今回はUserDefaults
を使用した方法をまとめていきます。
UserDefaultsとは?
「UserDefaults」とはいわゆるアプリ内に生成されるデータベースのようなものでアプリが停止してもデータを保持することが可能になっています。
アプリを削除しない限りデータが失われることが無いので、半永続的に管理したいデータやアプリを停止しても保持していたい値などを格納しておくことで簡単に再利用可能になっています。
格納するデータは文字列のキー値と任意の値との関係性を持って保持されてます。
Swift:UserDefaultsの使い方
Swiftでは「UserDefaults」を操作するためのインターフェース(CRUD操作など)を提供しているUserDefaults
クラスが用意されています。
class UserDefaults : NSObject
保存できるデータ型はString
、Int
、Bool
、Array
、Dictionary
、Data
、Date
です。独自のクラスや構造体形式ではそのまま保存することができませんがData型に変換することで保存することも可能です。
CRUD操作
ここからはUIKitを使用している場合にUserDefaultsを操作する方法をまとめていきます。SwiftUIを使用している場合は@AppStorage
というプロパティラッパーを使用することで操作することができます。
CRUD操作をする前にまずUserDefaultsクラスのインスタンスを生成しておきます。UserDefaultsクラスはシングルトンパターンになっているのでstandard
メソッドを使用してインスタンスに参照します。
// インスタンスを生成
let userDefaults = UserDefaults.standard
おすすめ記事:【GoF】23種類のデザインパターンとは?Swiftでよく使う活用例
登録・更新
データを登録するにはset
メソッドを使用します。引数には実際に保存しておきたい値とキーとなる文字列を渡します。
userDefaults.set("foo", forKey: "sample")
格納する値のデータ型によって自動でオーバーライドされたメソッドが呼び出されるのでデータ型によって変更する必要はありません。
既に格納済みの値を更新したい時もset
メソッドを使って上書きすることができます。
一度に複数登録する
データを一度に複数登録するにはregister
メソッドを使用します。引数には辞書型でキーと値を複数渡すことができます。
userDefaults.register(defaults: ["DataStore": "default"])
取得
既にデータベースに格納している値を取得する際はその値のデータ型に応じたメソッドを呼び出す必要があります。
userDefaults.string(forKey: "キー")
userDefaults.integer(forKey: "キー")
userDefaults.float(forKey: "キー")
userDefaults.double(forKey: "キー")
userDefaults.bool(forKey: "キー")
userDefaults.url(forKey: "キー")
userDefaults.array(forKey: "キー")
userDefaults.dictionary(forKey: "キー")
userDefaults.data(forKey: "キー")
userDefaults.stringArray(forKey: "キー")
userDefaults.object(forKey: "キー")
削除
データを削除するにはremoveObject
メソッドを使用します。削除するデータはキー文字列で指定するので保存されている値によってメソッドを変更する必要はありません。
userDefaults.removeObject(forKey: "sample")
UserDefaultsの注意点と保管場所
データを扱う上で便利なUserDefaultsですが取り扱いには注意が必要です。
- 大量のデータを保存しない
- 重要なデータを保存しない
UserDefaultsに過度なデータを入れるとアプリのパフォーマンスが著しく低下する可能性があるようです。
UserDefaultsがどこにデータを保管しているかというとアプリインストール時にデバイス内に生成されるサンドボックス構造になったファイル群の中の/AppData/Library/Preferences/
です。この中にプロパティリスト形式の[bundle-identifier].plist
というファイル名で保存されます。アプリ情報を設定する「info.plist」なんかがプロパティリストでは有名ですね。
おすすめ記事:【Swift】プロパティリスト(plist)とは?自作方法と読み込み
おすすめ記事:iOSのファイルシステム:サンドボックス構造とは?
├── AppData
│ ├── Documents
│ ├── Library
│ ├── Application Support
│ ├── Caches
│ ├── Preferences ★
│ ├── Saved Application State
│ └── SplashBoard
│ ├── SystemData
│ └── tmp
プロパティリストは値1つを参照したいだけでもファイル全体を読み込む必要があり、値を更新した際にはファイル全体を書き換える必要があるのでファイル容量が多いほど圧迫してしまいます。
公式ドキュメントではUserDefaultsに対する容量制限とかはなさそうですが使いすぎないように注意することをおすすめします。
また中に格納されている情報は知見のある人だと閲覧できてしまうため秘密にしたい情報などの格納は避けた方が無難です。
確認する方法
おすすめ記事:AppDataディレクトリを確認する方法
まだまだ勉強中ですので間違っている点や至らぬ点がありましたら教えていただけると助かります。
ご覧いただきありがとうございました。