We created this module to allow us to query for specific device settings. For example we wanted to know if the GPS is on/off without using 'react-native' 'geolocation' since using it will trigger a permission pop up.
We wanted to make the distinction between the two:
- Permission is not allowed for our application.
- Setting is disabled for the entire device.
This way we can prompt the user to go to the correct place in the settings application and make sure our application is aware that the user disables/enables a setting or denies/grants a permission.
Currently we've only added a way to extract the 'location' setting. We will add more in the future based on our requirements.
react-native example
for both Android and iOS.
$ npm install react-native-settings --save
$ react-native link react-native-settings
In your manifest file under:
<application>
add the following:
<receiver android:name="io.rumors.reactnativesettings.receivers.GpsLocationReceiver">
<intent-filter>
<action android:name="android.location.PROVIDERS_CHANGED" />
<category android:name="android.intent.category.DEFAULT" />
</intent-filter>
</receiver>
<receiver android:enabled="true" android:name="io.rumors.reactnativesettings.receivers.AirplaneModeReceiver">
<intent-filter>
<action android:name="android.intent.action.AIRPLANE_MODE"/>
</intent-filter>
</receiver>
- In XCode, in the project navigator, right click
Libraries
➜Add Files to [your project's name]
- Go to
node_modules
➜react-native-settings
and addRNSettings.xcodeproj
- In XCode, in the project navigator, select your project. Add
libRNSettings.a
to your project'sBuild Phases
➜Link Binary With Libraries
- Run your project (
Cmd R
)<
- Open up
android/app/src/main/java/[...]/MainActivity.java
- Add
import com.reactlibrary.RNSettingsPackage;
to the imports at the top of the file - Add
new RNSettingsPackage()
to the list returned by thegetPackages()
method
- Append the following lines to
android/settings.gradle
:include ':react-native-settings' project(':react-native-settings').projectDir = new File(rootProject.projectDir, '../node_modules/react-native-settings/android')
- Insert the following lines inside the dependencies block in
android/app/build.gradle
:compile project(':react-native-settings')
import RNSettings from 'react-native-settings'
RNSettings.getSetting(RNSettings.LOCATION_SETTING).then(result => {
if (result == RNSettings.ENABLED) {
console.log('location is enabled')
} else {
console.log('location is disabled')
}
})
import RNSettings from 'react-native-settings'
RNSettings.getSetting(RNSettings.AIRPLANE_MODE_SETTING).then(result => {
if (result == RNSettings.ENABLED) {
console.log('airplane mode is enabled')
} else {
console.log('airplane mode is disabled')
}
})
import RNSettings from 'react-native-settings'
RNSettings.openSetting(RNSettings.ACTION_LOCATION_SOURCE_SETTINGS).
then((result) => {
if (result === RNSettings.ENABLED) {
console.log('location is enabled')
}
RNSettings.openSetting(RNSettings.ACTION_AIRPLANE_MODE_SETTINGS).
then((result) => {
if (result === RNSettings.ENABLED) {
console.log('airplane mode is enabled')
}
import RNSettings from 'react-native-settings'
import { DeviceEventEmitter } from 'react-native'
_handleGPSProviderEvent = (e) => {
if (e[RNSettings.LOCATION_SETTING] === RNSettings.DISABLED) {
console.log('Location was disabled')
}
}
_handleAirplaneModeEvent = (e) => {
if (e[RNSettings.AIRPLANE_MODE_SETTING] === RNSettings.ENABLED) {
console.log('airplane mode was enabled')
}
}
DeviceEventEmitter.addListener(RNSettings.GPS_PROVIDER_EVENT, this._handleGPSProviderEvent)
DeviceEventEmitter.addListener(RNSettings.AIRPLANE_MODE_EVENT, this._handleAirplaneModeEvent)