1.2.1 • Published 5 years ago

react-native-gps-state-tootsweet v1.2.1

Weekly downloads
6
License
-
Repository
github
Last release
5 years ago

React Native GPS State

React Native Listener for GPS status changes

This lib will emitevent wheneaver the GPS status change, like when the permission was rejected or user disable Location service in system Settings.

Instalation

  1. Add library to project
    • yarn add react-native-gps-state
    • OR npm install --save react-native-gps-state
  2. Link library to project

    • react-native link react-native-gps-state

If the link fails, do a manual setup:

Android

android/settings.gradle

include ':react-native-gps-state'
project(':react-native-gps-state').projectDir = new File(rootProject.projectDir, '../node_modules/react-native-gps-state/android')

android/app/build.gradle

dependencies {
   ...
   compile project(':react-native-gps-state')
}

MainApplication.java

On top, where imports are:

import br.com.dopaminamob.gpsstate.GPSStatePackage;

Add the new GPSStatePackage() class to your list of exported packages.

@Override
protected List<ReactPackage> getPackages() {
    return Arrays.asList(
            new MainReactPackage(),
            new GPSStatePackage(),
    );
}

Usage

Constants

PlatformStatus CodeConstantDescription
IOS/Android0NOT_DETERMINEDThe user has not yet made a choice regarding whether this app can use location services.
IOS/Android1RESTRICTEDThis app is not authorized to use location services.
IOS/Android2DENIEDThe user explicitly denied the use of location services for this app or location services are currently disabled in Settings.
IOS/Android3AUTHORIZEDThis app is authorized to use location services.
IOS3AUTHORIZED_ALWAYSThis app is authorized to start location services at any time.
IOS4AUTHORIZED_WHENINUSEThis app is authorized to start most location services while running in the foreground

Methods

Open the system Settings to enable user to toggle Location on.

The parameter openInDetails (android only) is used to open app details screen (android M+ only), so the user can toggle the permission in Permissions tab.

//openInDetails defaults to true
GPSState.openSettings(openInDetails:boolean);
//Get the current GPS state
GPSState.getStatus().then((status)=>{

});

Listeners

import GPSState from 'react-native-gps-state';
...
componentWillMount(){
	GPSState.addListener((status)=>{
		switch(status){
			case GPSState.NOT_DETERMINED:
				alert('Please, allow the location, for us to do amazing things for you!');
			break;

			case GPSState.RESTRICTED:
				GPSState.openSettings();
			break;

			case GPSState.DENIED:
				alert('It`s a shame that you do not allowed us to use location :(');
			break;

			case GPSState.AUTHORIZED_ALWAYS:
				//TODO do something amazing with you app
			break;

			case GPSState.AUTHORIZED_WHENINUSE:
				//TODO do something amazing with you app
			break;
		}
	});
}

componentWillUnmount(){
	GPSState.removeListener();
}