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

8. ローカル設定(PreferencesManager)

AKS は、内部で使用しているシンプルなキーバリューストアも公開しています。このストアは multiplatform-settings を基盤としており、Android では内部的に SharedPreferences を使用します。ストレージ用の依存関係を別途追加することなく、アプリの簡単な設定の保存に利用できます。

kotlin
// Strings, Ints, Booleans, Longs, Floats
PreferencesManager.addInPreferences("user_name", "Talha")
PreferencesManager.addInPreferences("launch_count", 5)
PreferencesManager.addInPreferences("onboarding_done", true)
PreferencesManager.addInPreferencesAsLong("last_sync_time", System.currentTimeMillis())
PreferencesManager.addInPreferencesAsFloat("scroll_position", 12.5f)

PreferencesManager.getStringPreferences("user_name", "")
PreferencesManager.getIntegerPreferences("launch_count", 0)
PreferencesManager.getBooleanPreferences("onboarding_done", false)
PreferencesManager.getLongPreferences("last_sync_time", 0L)
PreferencesManager.getFloatPreferences("scroll_position", 0f)

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

// Store/retrieve a serializable object as JSON
PreferencesManager.addInPreferences("user_profile", profile, UserProfile.serializer())
PreferencesManager.getCustomPreference("user_profile", UserProfile.serializer())

このストアは、AKS が内部フラグ(REMOVE_ADS など)の保存に使用しているものと共通です。キーの衝突を避けるため、アプリで使用するキーには名前空間を設けるなどして、このガイドの他の箇所に記載されているキーと重複しないようにしてください。