rmrs / react-native-settings

Allows access to various Android and iOS device settings using React Native
MIT License
226 stars 35 forks source link
android react-native settings xcode

react-native-settings

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:

  1. Permission is not allowed for our application.
  2. 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 (and airplane mode on Android). We will add more in the future based on requirements.

react-native example for both Android and iOS.

Getting started

$ npm install react-native-settings --save

Mostly automatic installation

$ react-native link react-native-settings

Android

In your MainApplication.java file register the receivers:

...

import android.content.IntentFilter;
import io.rumors.reactnativesettings.RNSettingsPackage;
import io.rumors.reactnativesettings.receivers.GpsLocationReceiver;
import io.rumors.reactnativesettings.receivers.AirplaneModeReceiver;

...

public class MainApplication extends Application implements ReactApplication {

  ...

  @Override
  public void onCreate() {

    ...

    registerReceiver(new GpsLocationReceiver(), new IntentFilter("android.location.PROVIDERS_CHANGED"));
    registerReceiver(new AirplaneModeReceiver(), new IntentFilter("android.intent.action.AIRPLANE_MODE"));
  }
}

Manual installation

iOS

  1. In XCode, in the project navigator, right click LibrariesAdd Files to [your project's name]
  2. Go to node_modulesreact-native-settings and add RNSettings.xcodeproj
  3. In XCode, in the project navigator, select your project. Add libRNSettings.a to your project's Build PhasesLink Binary With Libraries
  4. Run your project (Cmd+R)<

Android

  1. Open up android/app/src/main/java/[...]/MainApplication.java
  1. 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')
  1. Insert the following lines inside the dependencies block in android/app/build.gradle:
  implementation project(':react-native-settings')

Usage

Android and iOS

Getting a setting

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');
  }
});

Android only

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');
  }
});

RNSettings.getSetting(RNSettings.CAPTIONING_SETTINGS).then(result => {
  if (result == RNSettings.ENABLED) {
    console.log('captioning is enabled');
  } else {
    console.log('captioning is disabled');
  }
});
Open settings application in a specific setting
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');
    }
  },
);

RNSettings.openSetting(RNSettings.ACTION_CAPTIONING_SETTINGS).then(result => {
  if (result === RNSettings.ENABLED) {
    console.log('captioning is enabled');
  }
});
Listen to setting change event (when applicable)
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');
  }
};

_handleCaptioningEvent = e => {
  if (e[RNSettings.CAPTIONING_SETTINGS] === RNSettings.ENABLED) {
    console.log('captioning was enabled');
  }
};

DeviceEventEmitter.addListener(
  RNSettings.GPS_PROVIDER_EVENT,
  this._handleGPSProviderEvent,
);
DeviceEventEmitter.addListener(
  RNSettings.AIRPLANE_MODE_EVENT,
  this._handleAirplaneModeEvent,
);
DeviceEventEmitter.addListener(
  RNSettings.CAPTIONING_EVENT,
  this._handleCaptioningEvent,
);