263 lines
8.2 KiB
JavaScript
263 lines
8.2 KiB
JavaScript
/**
|
|
* Copyright (c) Facebook, Inc. and its affiliates.
|
|
*
|
|
* This source code is licensed under the MIT license found in the
|
|
* LICENSE file in the root directory of this source tree.
|
|
*
|
|
* @format
|
|
* @flow strict-local
|
|
*/
|
|
|
|
'use strict';
|
|
|
|
const Platform = require('../Utilities/Platform');
|
|
|
|
import NativeDialogManagerAndroid from '../NativeModules/specs/NativeDialogManagerAndroid';
|
|
import NativePermissionsAndroid from './NativePermissionsAndroid';
|
|
import type {
|
|
PermissionStatus,
|
|
PermissionType,
|
|
} from './NativePermissionsAndroid';
|
|
import invariant from 'invariant';
|
|
|
|
export type Rationale = {
|
|
title: string,
|
|
message: string,
|
|
buttonPositive?: string,
|
|
buttonNegative?: string,
|
|
buttonNeutral?: string,
|
|
...
|
|
};
|
|
|
|
const PERMISSION_REQUEST_RESULT = Object.freeze({
|
|
GRANTED: 'granted',
|
|
DENIED: 'denied',
|
|
NEVER_ASK_AGAIN: 'never_ask_again',
|
|
});
|
|
|
|
const PERMISSIONS = Object.freeze({
|
|
READ_CALENDAR: 'android.permission.READ_CALENDAR',
|
|
WRITE_CALENDAR: 'android.permission.WRITE_CALENDAR',
|
|
CAMERA: 'android.permission.CAMERA',
|
|
READ_CONTACTS: 'android.permission.READ_CONTACTS',
|
|
WRITE_CONTACTS: 'android.permission.WRITE_CONTACTS',
|
|
GET_ACCOUNTS: 'android.permission.GET_ACCOUNTS',
|
|
ACCESS_FINE_LOCATION: 'android.permission.ACCESS_FINE_LOCATION',
|
|
ACCESS_COARSE_LOCATION: 'android.permission.ACCESS_COARSE_LOCATION',
|
|
ACCESS_BACKGROUND_LOCATION: 'android.permission.ACCESS_BACKGROUND_LOCATION',
|
|
RECORD_AUDIO: 'android.permission.RECORD_AUDIO',
|
|
READ_PHONE_STATE: 'android.permission.READ_PHONE_STATE',
|
|
CALL_PHONE: 'android.permission.CALL_PHONE',
|
|
READ_CALL_LOG: 'android.permission.READ_CALL_LOG',
|
|
WRITE_CALL_LOG: 'android.permission.WRITE_CALL_LOG',
|
|
ADD_VOICEMAIL: 'com.android.voicemail.permission.ADD_VOICEMAIL',
|
|
USE_SIP: 'android.permission.USE_SIP',
|
|
PROCESS_OUTGOING_CALLS: 'android.permission.PROCESS_OUTGOING_CALLS',
|
|
BODY_SENSORS: 'android.permission.BODY_SENSORS',
|
|
SEND_SMS: 'android.permission.SEND_SMS',
|
|
RECEIVE_SMS: 'android.permission.RECEIVE_SMS',
|
|
READ_SMS: 'android.permission.READ_SMS',
|
|
RECEIVE_WAP_PUSH: 'android.permission.RECEIVE_WAP_PUSH',
|
|
RECEIVE_MMS: 'android.permission.RECEIVE_MMS',
|
|
READ_EXTERNAL_STORAGE: 'android.permission.READ_EXTERNAL_STORAGE',
|
|
WRITE_EXTERNAL_STORAGE: 'android.permission.WRITE_EXTERNAL_STORAGE',
|
|
});
|
|
|
|
/**
|
|
* `PermissionsAndroid` provides access to Android M's new permissions model.
|
|
*
|
|
* See https://reactnative.dev/docs/permissionsandroid.html
|
|
*/
|
|
|
|
class PermissionsAndroid {
|
|
PERMISSIONS: {|
|
|
ACCESS_BACKGROUND_LOCATION: string,
|
|
ACCESS_COARSE_LOCATION: string,
|
|
ACCESS_FINE_LOCATION: string,
|
|
ADD_VOICEMAIL: string,
|
|
BODY_SENSORS: string,
|
|
CALL_PHONE: string,
|
|
CAMERA: string,
|
|
GET_ACCOUNTS: string,
|
|
PROCESS_OUTGOING_CALLS: string,
|
|
READ_CALENDAR: string,
|
|
READ_CALL_LOG: string,
|
|
READ_CONTACTS: string,
|
|
READ_EXTERNAL_STORAGE: string,
|
|
READ_PHONE_STATE: string,
|
|
READ_SMS: string,
|
|
RECEIVE_MMS: string,
|
|
RECEIVE_SMS: string,
|
|
RECEIVE_WAP_PUSH: string,
|
|
RECORD_AUDIO: string,
|
|
SEND_SMS: string,
|
|
USE_SIP: string,
|
|
WRITE_CALENDAR: string,
|
|
WRITE_CALL_LOG: string,
|
|
WRITE_CONTACTS: string,
|
|
WRITE_EXTERNAL_STORAGE: string,
|
|
|} = PERMISSIONS;
|
|
RESULTS: {|
|
|
DENIED: $TEMPORARY$string<'denied'>,
|
|
GRANTED: $TEMPORARY$string<'granted'>,
|
|
NEVER_ASK_AGAIN: $TEMPORARY$string<'never_ask_again'>,
|
|
|} = PERMISSION_REQUEST_RESULT;
|
|
|
|
/**
|
|
* DEPRECATED - use check
|
|
*
|
|
* Returns a promise resolving to a boolean value as to whether the specified
|
|
* permissions has been granted
|
|
*
|
|
* @deprecated
|
|
*/
|
|
checkPermission(permission: PermissionType): Promise<boolean> {
|
|
console.warn(
|
|
'"PermissionsAndroid.checkPermission" is deprecated. Use "PermissionsAndroid.check" instead',
|
|
);
|
|
if (Platform.OS !== 'android') {
|
|
console.warn(
|
|
'"PermissionsAndroid" module works only for Android platform.',
|
|
);
|
|
return Promise.resolve(false);
|
|
}
|
|
|
|
invariant(
|
|
NativePermissionsAndroid,
|
|
'PermissionsAndroid is not installed correctly.',
|
|
);
|
|
|
|
return NativePermissionsAndroid.checkPermission(permission);
|
|
}
|
|
|
|
/**
|
|
* Returns a promise resolving to a boolean value as to whether the specified
|
|
* permissions has been granted
|
|
*
|
|
* See https://reactnative.dev/docs/permissionsandroid.html#check
|
|
*/
|
|
check(permission: PermissionType): Promise<boolean> {
|
|
if (Platform.OS !== 'android') {
|
|
console.warn(
|
|
'"PermissionsAndroid" module works only for Android platform.',
|
|
);
|
|
return Promise.resolve(false);
|
|
}
|
|
|
|
invariant(
|
|
NativePermissionsAndroid,
|
|
'PermissionsAndroid is not installed correctly.',
|
|
);
|
|
|
|
return NativePermissionsAndroid.checkPermission(permission);
|
|
}
|
|
|
|
/**
|
|
* DEPRECATED - use request
|
|
*
|
|
* Prompts the user to enable a permission and returns a promise resolving to a
|
|
* boolean value indicating whether the user allowed or denied the request
|
|
*
|
|
* If the optional rationale argument is included (which is an object with a
|
|
* `title` and `message`), this function checks with the OS whether it is
|
|
* necessary to show a dialog explaining why the permission is needed
|
|
* (https://developer.android.com/training/permissions/requesting.html#explain)
|
|
* and then shows the system permission dialog
|
|
*
|
|
* @deprecated
|
|
*/
|
|
async requestPermission(
|
|
permission: PermissionType,
|
|
rationale?: Rationale,
|
|
): Promise<boolean> {
|
|
console.warn(
|
|
'"PermissionsAndroid.requestPermission" is deprecated. Use "PermissionsAndroid.request" instead',
|
|
);
|
|
if (Platform.OS !== 'android') {
|
|
console.warn(
|
|
'"PermissionsAndroid" module works only for Android platform.',
|
|
);
|
|
return Promise.resolve(false);
|
|
}
|
|
|
|
const response = await this.request(permission, rationale);
|
|
return response === this.RESULTS.GRANTED;
|
|
}
|
|
|
|
/**
|
|
* Prompts the user to enable a permission and returns a promise resolving to a
|
|
* string value indicating whether the user allowed or denied the request
|
|
*
|
|
* See https://reactnative.dev/docs/permissionsandroid.html#request
|
|
*/
|
|
async request(
|
|
permission: PermissionType,
|
|
rationale?: Rationale,
|
|
): Promise<PermissionStatus> {
|
|
if (Platform.OS !== 'android') {
|
|
console.warn(
|
|
'"PermissionsAndroid" module works only for Android platform.',
|
|
);
|
|
return Promise.resolve(this.RESULTS.DENIED);
|
|
}
|
|
|
|
invariant(
|
|
NativePermissionsAndroid,
|
|
'PermissionsAndroid is not installed correctly.',
|
|
);
|
|
|
|
if (rationale) {
|
|
const shouldShowRationale = await NativePermissionsAndroid.shouldShowRequestPermissionRationale(
|
|
permission,
|
|
);
|
|
|
|
if (shouldShowRationale && !!NativeDialogManagerAndroid) {
|
|
return new Promise((resolve, reject) => {
|
|
const options = {
|
|
...rationale,
|
|
};
|
|
NativeDialogManagerAndroid.showAlert(
|
|
/* $FlowFixMe(>=0.111.0 site=react_native_fb) This comment
|
|
* suppresses an error found when Flow v0.111 was deployed. To see
|
|
* the error, delete this comment and run Flow. */
|
|
options,
|
|
() => reject(new Error('Error showing rationale')),
|
|
() =>
|
|
resolve(NativePermissionsAndroid.requestPermission(permission)),
|
|
);
|
|
});
|
|
}
|
|
}
|
|
return NativePermissionsAndroid.requestPermission(permission);
|
|
}
|
|
|
|
/**
|
|
* Prompts the user to enable multiple permissions in the same dialog and
|
|
* returns an object with the permissions as keys and strings as values
|
|
* indicating whether the user allowed or denied the request
|
|
*
|
|
* See https://reactnative.dev/docs/permissionsandroid.html#requestmultiple
|
|
*/
|
|
requestMultiple(
|
|
permissions: Array<PermissionType>,
|
|
): Promise<{[permission: PermissionType]: PermissionStatus, ...}> {
|
|
if (Platform.OS !== 'android') {
|
|
console.warn(
|
|
'"PermissionsAndroid" module works only for Android platform.',
|
|
);
|
|
return Promise.resolve({});
|
|
}
|
|
|
|
invariant(
|
|
NativePermissionsAndroid,
|
|
'PermissionsAndroid is not installed correctly.',
|
|
);
|
|
|
|
return NativePermissionsAndroid.requestMultiplePermissions(permissions);
|
|
}
|
|
}
|
|
|
|
const PermissionsAndroidInstance: PermissionsAndroid = new PermissionsAndroid();
|
|
|
|
module.exports = PermissionsAndroidInstance;
|