This package makes it easy for an React Native App to ensure that the Android device's system settings are properly configured for the app's location needs. If your app needs to request location, the device needs to enable the appropriate system settings, such as GPS or Wi-Fi scanning. Rather than directly enabling services such as the device's GPS, your app specifies the required level of accuracy/power consumption, and the device automatically makes the appropriate changes to system settings.
yarn add react-native-location-enablerimport LocationEnabler from 'react-native-location-enabler';
const {
PRIORITIES: { HIGH_ACCURACY },
useLocationSettings,
} = LocationEnabler;
// React Component
const App = () => {
const [enabled, requestResolution] = useLocationSettings(
{
priority: HIGH_ACCURACY, // default BALANCED_POWER_ACCURACY
alwaysShow: true, // default false
needBle: true, // default false
},
false /* optional: default undefined */
);
return (
<View>
{!enabled && (
<Button
onPress={requestResolution}
title="Request Resolution Location Settings"
/>
)}
</View>
);
};import LocationEnabler from "react-native-location-enabler"
const {
PRIORITIES: { HIGH_ACCURACY },
addListener,
checkSettings,
requestResolutionSettings
} = LocationEnabler
// Adds a listener to be invoked when location settings checked using
// [checkSettings] or changed using [requestResolutionSettings]
const listener = addListener(({ locationEnabled }) =>
console.log(`Location are ${ locationEnabled ? 'enabled' : 'disabled' }`);
);
// Define configuration
const config = {
priority: HIGH_ACCURACY, // default BALANCED_POWER_ACCURACY
alwaysShow: true, // default false
needBle: false, // default false
};
// Check if location is enabled or not
checkSettings(config);
// If location is disabled, prompt the user to turn on device location
requestResolutionSettings(config);
// ...
// Removes this subscription
listener.remove();Clone the repo
git clone https://github.com/YsnKsy/react-native-location-enabler.git && cd react-native-location-enablerInstall npm dependencies
yarnStart Metro ( javascript bundler )
yarn example startInstall and launch example app on the device
yarn example android
PRIORITIES
import LocationEnabler from 'react-native-location-enabler';
const {
HIGH_ACCURACY,
BALANCED_POWER_ACCURACY,
LOW_POWER,
NO_POWER,
} = LocationEnabler.PRIORITIES;Static object contain a list quality of service for location updates. If your application wants high accuracy location it should set prioprity to 'HIGH_ACCURACY'. If you want negligible power impact, but to still receive location updates when available, then set priority to 'NO_POWER'.
import LocationEnabler from 'react-native-location-enabler';
const {
useLocationSettings,
PRIORITIES: { HIGH_ACCURACY },
} = LocationEnabler;
const [enabled, requestResolution] = useLocationSettings({
priority: HIGH_ACCURACY, // optional: default BALANCED_POWER_ACCURACY
alwaysShow: true, // optional: default false
needBle: true, // optional: default false
});
console.log(`Location are ${enabled ? 'enabled' : 'disabled'}`);
// ...
if (!enabled) {
requestResolution();
}Hook let you check the user's device location status 'on' / 'off' and method let you display an activity where they can turn location 'on'.
import LocationEnabler from 'react-native-location-enabler';
const {
checkSettings,
PRIORITIES: { HIGH_ACCURACY },
} = LocationEnabler;
checkSettings({
priority: HIGH_ACCURACY, // optional: default BALANCED_POWER_ACCURACY
alwaysShow: true, // optional: default false
needBle: true, // optional: default false
});Checking if the user's device location is turned on / off.
import LocationEnabler from 'react-native-location-enabler';
const {
requestResolutionSettings,
PRIORITIES: { HIGH_ACCURACY },
} = LocationEnabler;
requestResolutionSettings({
priority: HIGH_ACCURACY, // optional: default BALANCED_POWER_ACCURACY
alwaysShow: true, // optional: default false
needBle: true, // optional: default false
});Display an activity where they can turn location 'on' using a location request.
import LocationEnabler from 'react-native-location-enabler';
let listener = null;
function cb(result) {
const { locationEnabled } = result;
console.log(`Location are ${locationEnabled ? 'enabled' : 'disabled'}`);
if (listener !== null) {
// remove listener when you finish
listener.remove();
}
}
listener = LocationEnabler.addListener(cb);Adds a listener to be invoked when onChangeLocationSettings are emitted. An optional calling context may be provided. The data arguments emitted will be passed to the listener function.
Press the STAR button 😀 and see the contributing guide to learn how to contribute to the repository and the development workflow.
See the code of conduct guide.
See the MIT License
![dependabot[bot] avatar](https://avatars.githubusercontent.com/in/29110?v=4 "dependabot[bot]")
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent