سلام دوستان
من مدتها قصد داشتم توی ویرگول خودم نوشتن رو شروع کنم اما به دلایل مختلفی هیچوقت تا الان نشد که این اتفاق بیفته! تا اینکه چند روز پیش خبر منتشر شدن کتابخونهی جدید DataStore که بخشی از مجموعهی Jetpack هست رو خوندم.
از اونجایی که این کتابخونه مزایای بسیار زیادی نسبت به SharedPreferences داره، و آموزش فارسی برای پیادهسازیش هنوز منتشر نشده(یعنی من ندیدم?)، تصمیم گرفتم این مقاله رو بنویسم.
پس خیلی حرف نمیزنم و میرم سر اصل مطلب.
کتابخونهی DataStore عضو جدیدی از خانوادهی Jetpack هست که بر پایهی Kotlin coroutines و Flow ساخته شده و به عنوان جایگزین SharedPreferences معرفی شده.

خب قبل اینکه بخوام بگم چرا، این جدول مقایسه رو ببینید:

خب حالا وقت جواب دادنه! معایب SharedPreferences که توی DataStore رفع شدن:
اگه به بهروزرسانیهای جزئی، یکپارچگی دسترسی به اطلاعات یا پشتیبانی از مجموعه دادههای بزرگ یا پیچیده نیاز دارید بهتره (و باید) از Room استفاده کنید. DataStore برای مجموعه دادههای ساده و کوچک ایدهآل هست، مثل ذخیره تنظیمات یا اطلاعات کاربری جزئی در نرمافزار.
اینجا فعلا روش پیادهسازی بدون Proto رو آموزش میدم که مقاله خیلی طولانی و حوصله سر بر نشه :)
۱. اضافه کردن dependency به build.gradle:
// Preferences DataStore implementation "androidx.datastore:datastore-preferences:1.0.0-alpha01"
۲. ساختن دیتااستور:
// with Preferences DataStore val dataStore: DataStore<Preferences> = context.createDataStore( name = "settings" //نام دلخواه )
۳. ذخیرهی اطلاعات در دیتااستور:
dataStore.edit {preferences -> preferences[KEY] = value }
به جای KEY باید کلید مربوطه و به جای value مقدار اون رو قرار بدید، مثلا:
KEY: "language" value: "fa"
۴. خواندن اطلاعات ذخیره شده:
val language: Flow<String?> get() = dataStore.data.map { preferences -> preferences[KEY] }
بالاتر گفتم که این کتابخونه بر پایهی Kotlin coroutines و Flow ساخته شده، پس باید برای خوندن اطلاعات نوع متغیر رو به صورت بالا تعریف کنیم، و داخل تابع getter دیتای مربوط به KEY دلخواه خودمون رو دریافت کنیم.

اگر قصد مهاجرت از SharedPreferences به DataStore رو دارید و میخواید دیتای قدیمی رو به دیتااستور منتقل کنید، کافیه کد زیر رو (قبل از انجام هر عملیاتی با DataStore) بنویسید:
val dataStore: DataStore<Preferences> = context.createDataStore( name = "settings" // نام دلخواه, migrations = listOf(SharedPreferencesMigration(context, "settings_preferences")) )
امیدوارم این مقاله براتون مفید بوده باشه.
موفقتر باشید ❤
منبع: Prefer Storing Data with Jetpack DataStore