التوثيق · AppsKitSDK (AKS) — دليل التكامل مع Android
8. التفضيلات المحلية (PreferencesManager)
يتيح AKS أيضًا الوصول إلى مخزن البيانات البسيط الذي يستخدمه داخليًا لتخزين أزواج المفتاح والقيمة (ويعتمد على multiplatform-settings، أي على SharedPreferences في Android)، لتتمكن من استخدامه لحفظ التفضيلات البسيطة لتطبيقك بدلًا من إضافة تبعية تخزين أخرى:
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)، لذا ينبغي أن تندرج المفاتيح التي تختارها ضمن نطاق أسماء خاص أو أن تكون متميزة عن المفاتيح الموثقة في مواضع أخرى من هذا الدليل، لتجنب تعارض الأسماء.