datastore-preferences/androidx.datastore.preferences/SharedPreferencesMigration

SharedPreferencesMigration

@JvmOverloads
fun SharedPreferencesMigration(produceSharedPreferences: () -> SharedPreferences, keysToMigrate: Set<String> = MIGRATE_ALL_KEYS): SharedPreferencesMigration<Preferences>(source)

Creates a SharedPreferencesMigration for DataStore.

Note: This migration only supports the basic SharedPreferences types: boolean, float, int, long, string and string set. If the result of getAll contains other types, they will be ignored.

Parameters

produceSharedPreferences

Should return the instance of SharedPreferences to migrate from.

keysToMigrate

The list of keys to migrate. The keys will be mapped to datastore.Preferences with their same values. If the key is already present in the new Preferences, the key will not be migrated again. If the key is not present in the SharedPreferences it will not be migrated. If keysToMigrate is not set, all keys will be migrated from the existing SharedPreferences.

@JvmOverloads
fun SharedPreferencesMigration(    context: Context,     sharedPreferencesName: String,     keysToMigrate: Set<String> = MIGRATE_ALL_KEYS): SharedPreferencesMigration<Preferences>(source)

Creates a SharedPreferencesMigration for DataStore.

If the SharedPreferences is empty once the migration completes, this migration will attempt to delete it.

Parameters

context

Context used for getting SharedPreferences.

sharedPreferencesName

The name of the SharedPreferences.

keysToMigrate

The list of keys to migrate. The keys will be mapped to datastore.Preferences with their same values. If the key is already present in the new Preferences, the key will not be migrated again. If the key is not present in the SharedPreferences it will not be migrated. If keysToMigrate is not set, all keys will be migrated from the existing SharedPreferences.