【Swift】UserDefaultsの使い方とは?データの保存/削除/取得/更新方法

この記事からわかること

  • SwiftUIKit使用時UserDefaultsの使い方実装方法
  • UserDefaultsとは?
  • アプリ停止してもデータ保持させるには?
  • CRUD処理(保存/更新/取得/削除する方法
  • UserDefaultsのデータ保存場所とは?

index

[open]

\ アプリをリリースしました /

みんなの誕生日

友達や家族の誕生日をメモ!通知も届く-みんなの誕生日-

posted withアプリーチ

アプリが停止してもデータを保持させるために使用できるUserDefaultsの使い方と実装方法をまとめていきたいと思います。

UserDefaultsとは?

「UserDefaults」とはいわゆるアプリ内に生成されるデータベースのようなものアプリが停止してもデータを保持することが可能になっています。

アプリを削除しない限りデータが失われることが無いので、半永続的に管理したいデータやアプリを停止しても保持していたい値などを格納しておくことで簡単に再利用可能になっています。

格納するデータは文字列のキー値と任意の値との関係性を持って保持されてます。

Swift:UserDefaultsの使い方

Swiftでは「UserDefaults」を操作するためのインターフェース(CRUD操作など)を提供しているUserDefaultsクラスが用意されています。

class UserDefaults : NSObject

保存できるデータ型はStringIntBoolArrayDictionaryDataDateです。独自のクラスや構造体形式ではそのまま保存することができませんがData型に変換することで保存することも可能です。

CRUD操作

ここからはUIKitを使用している場合にUserDefaultsを操作する方法をまとめていきます。SwiftUIを使用している場合は@AppStorageというプロパティラッパーを使用することで操作することができます。

CRUD操作をする前にまずUserDefaultsクラスのインスタンスを生成しておきます。インスタンスの生成にはstandardメソッドを使用します。

// インスタンスを生成
let userDefaults = UserDefaults.standard

登録・更新

データを登録するには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」なんかがプロパティリストでは有名ですね。

├── AppData
│ ├── Documents
│ ├── Library
│        ├── Application Support
│        ├── Caches
│        ├── Preferences ★
│        ├── Saved Application State
│        └── SplashBoard
│ ├── SystemData
│ └── tmp

プロパティリストは値1つを参照したいだけでもファイル全体を読み込む必要があり、値を更新した際にはファイル全体を書き換える必要があるのでファイル容量が多いほど圧迫してしまいます。

公式ドキュメントではUserDefaultsに対する容量制限とかはなさそうですが使いすぎないように注意することをおすすめします。

まだまだ勉強中ですので間違っている点や至らぬ点がありましたら教えていただけると助かります。

ご覧いただきありがとうございました。

searchbox

スポンサー

ProFile

ame

趣味:読書,プログラミング学習,サイト制作,ブログ

IT嫌いを克服するためにITパスを取得しようと勉強してからサイト制作が趣味に変わりました笑
今はCMSを使わずこのサイトを完全自作でサイト運営中〜

自作iOSアプリ

\ アプリをリリースしました /

mapping

自分だけの地図を作ろう!-mapping-

無料posted withアプリーチ

割り勘アプリ-bill-

旅行におすすめ!
割り勘アプリ-bill-

無料posted withアプリーチ

Imakoko

現在地を取得するアプリ!Imakoko

無料posted withアプリーチ

ふるログ

ふるさと納税管理アプリ-ふるログ-

無料posted withアプリーチ

Remind-シンプル通知アプリ-

シンプル通知アプリ-Remind-

無料posted withアプリーチ

CLIPURL

好きな記事をクリップしよう!-CLIPURL-

無料posted withアプリーチ

記録カレンダー

続けたを可視化できるアプリ!記録カレンダー

無料posted withアプリーチ

CART-共有できるお買い物リスト-

CART-共有できるお買い物リスト-

無料posted withアプリーチ

QuickPressPanel

早押しゲーム-QuickPressPanel-

無料posted withアプリーチ

貸し借り管理アプリ

友達とのお金の管理-貸し借り管理アプリ-

無料posted withアプリーチ

みんなの誕生日

友達や家族の誕生日をメモ!通知も届く-みんなの誕生日-

posted withアプリーチ

Githubにて
iOSアプリのソースコードを公開中!

自作Webアプリ

子育て知識共有サイト-mikata-

子育て知識共有サイト-mikata-

New Article

index