@getalby/expo-shared-preferences
Advanced tools
Provides a way to access Shared Preferences on Android
Note: This package is based on Liam Andrew's expo-shared-preferences
Provides a way to access Shared Preferences on Android.
expo-secure-store already provides a way to access values in SharedPreferences on Android, however it has built in encryption functionality that is enabled by default for all read and write operations without any way to opt out.
The core React Native API also exposes Settings which allows access to native key value storage on iOS using NSUserDefaults, however there isn't a similarly exposed API for Android (i.e. using SharedPreferences).
Therefore, this package provides a similar API to facilitate basic operations with Android's SharedPreferences without the built in encryption.
By default, expo-shared-preferences will attempt to access the [SharedPreferences](https://developer.android.com/reference/android/content/Context#getSharedPreferences(java.lang.String,%20int) using the following formula for the filename:
context.packageName + ".settings"
If you want to access a different file name, then you can pass the value to name in the options parameter in the methods below.
SharedPreferences.getItemAsync(key)
key: string - The key that was used to store the associated value.
options: SharedPreferenceOptions - (optional) configuration options for accessing SharedPreferences.
Returns: A promise that resolves to the previously stored value, or null if there is no entry for the given key. The promise will reject if an error occured while retrieving the value.
SharedPreferences.deleteItemAsync(key)
key: string - The key that was used to store the associated value.
options: SharedPreferenceOptions - (optional) configuration options for accessing SharedPreferences.
Returns: A promise that will reject if the value couldn't be deleted.
SharedPreferences.setItemAsync(key, value)
key: string - he key to associate with the stored value. Keys may contain alphanumeric characters ., -, and _.
value: string - The value to store. Size limit is 2048 bytes.
options: SharedPreferenceOptions - (optional) configuration options for accessing SharedPreferences.
Returns: A promise that will reject if value cannot be stored on the device.
For managed Expo projects, please follow the installation instructions in the API documentation for the latest stable release. If you follow the link and there is no documentation available then this library is not yet usable within managed projects — it is likely to be included in an upcoming Expo SDK release.
For bare React Native projects, you must ensure that you have installed and configured the expo package before continuing.
npm install @getalby/expo-shared-preferences
Run npx pod-install after installing the npm package.
Contributions are very welcome! Please refer to guidelines described in the contributing guide.
This library uses release-it for versioning management and publishing.
You can trigger the CLI with:
yarn release
FAQs
Provides a way to access Shared Preferences on Android
We found that @getalby/expo-shared-preferences demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 0 open source maintainers collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
Fluent Assertions is facing backlash after dropping the Apache license for a commercial model, leaving users blindsided and questioning contributor rights.
Research
Security News
Socket researchers uncover the risks of a malicious Python package targeting Discord developers.
Security News
The UK is proposing a bold ban on ransomware payments by public entities to disrupt cybercrime, protect critical services, and lead global cybersecurity efforts.