Apps Kit SDK logoApps Kit SDK
ドキュメント · iOS への組み込み

7. ローカル設定(PreferencesManager)

内部では NSUserDefaults を使用しています。同じメソッド群を持つクラスが 2 つあります。PreferencesManager と AppsKitSDKPreferencesManager のどちらでも動作しますが、読み取りと書き込みを両方のクラスに分散させず、どちらか一方に統一してください。

swift
// Booleans, Ints, Strings, Float, Long all live under the same "addInPreferences" family.
// These look unusual but are the real generated parameter labels — Swift doesn't support
// overloading purely by parameter type, so each overload gets a distinct label:
PreferencesManager.shared.addInPreferences(key: "onboarding_done", value: true)        // Bool
PreferencesManager.shared.addInPreferences(key: "launch_count", value_: 5)              // Int?  (KotlinInt)
PreferencesManager.shared.addInPreferences(key: "user_name", value__: "Talha")          // String?

// ...or use the explicitly-named variants instead, which read more clearly:
PreferencesManager.shared.addInPreferencesAsLong(key: "last_sync_time", value: Int64(Date().timeIntervalSince1970))
PreferencesManager.shared.addInPreferencesAsFloat(key: "scroll_position", value: 12.5)
PreferencesManager.shared.addInPreferencesAsString(key: "user_name", value: "Talha")

PreferencesManager.shared.getStringPreferences(key: "user_name", defaultValue: "")
PreferencesManager.shared.getIntegerPreferences(key: "launch_count", defaultValue: 0)
PreferencesManager.shared.getBooleanPreferences(key: "onboarding_done", defaultValue: false)
PreferencesManager.shared.getLongPreferences(key: "last_sync_time", defaultValue: 0)
PreferencesManager.shared.getFloatPreferences(key: "scroll_position", defaultValue: 0)

// Remove a single key
PreferencesManager.shared.flushSavedCache(key: "user_name")

// Custom serializable object as JSON
PreferencesManager.shared.getCustomPreference(key: "user_profile", serializer: UserProfile.companion.serializer(), defaultJson: nil)

この保存領域は、AKS が内部フラグ(REMOVE_ADS など)に使用するものと共通です。キーの衝突を避けるため、独自のキーには明確に区別できる名前空間を設けてください。