/** * Copyright (c) Meta Platforms, Inc. and 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 */ import type { PermissionStatus, PermissionType, } from './NativePermissionsAndroid'; import NativeDialogManagerAndroid from '../NativeModules/specs/NativeDialogManagerAndroid'; import NativePermissionsAndroid from './NativePermissionsAndroid'; import invariant from 'invariant'; const Platform = require('../Utilities/Platform'); 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', READ_VOICEMAIL: 'com.android.voicemail.permission.READ_VOICEMAIL', WRITE_VOICEMAIL: 'com.android.voicemail.permission.WRITE_VOICEMAIL', USE_SIP: 'android.permission.USE_SIP', PROCESS_OUTGOING_CALLS: 'android.permission.PROCESS_OUTGOING_CALLS', BODY_SENSORS: 'android.permission.BODY_SENSORS', BODY_SENSORS_BACKGROUND: 'android.permission.BODY_SENSORS_BACKGROUND', 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', READ_MEDIA_IMAGES: 'android.permission.READ_MEDIA_IMAGES', READ_MEDIA_VIDEO: 'android.permission.READ_MEDIA_VIDEO', READ_MEDIA_AUDIO: 'android.permission.READ_MEDIA_AUDIO', WRITE_EXTERNAL_STORAGE: 'android.permission.WRITE_EXTERNAL_STORAGE', BLUETOOTH_CONNECT: 'android.permission.BLUETOOTH_CONNECT', BLUETOOTH_SCAN: 'android.permission.BLUETOOTH_SCAN', BLUETOOTH_ADVERTISE: 'android.permission.BLUETOOTH_ADVERTISE', ACCESS_MEDIA_LOCATION: 'android.permission.ACCESS_MEDIA_LOCATION', ACCEPT_HANDOVER: 'android.permission.ACCEPT_HANDOVER', ACTIVITY_RECOGNITION: 'android.permission.ACTIVITY_RECOGNITION', ANSWER_PHONE_CALLS: 'android.permission.ANSWER_PHONE_CALLS', READ_PHONE_NUMBERS: 'android.permission.READ_PHONE_NUMBERS', UWB_RANGING: 'android.permission.UWB_RANGING', POST_NOTIFICATIONS: 'android.permission.POST_NOTIFICATIONS', NEARBY_WIFI_DEVICES: 'android.permission.NEARBY_WIFI_DEVICES', }); /** * `PermissionsAndroid` provides access to Android M's new permissions model. * * See https://reactnative.dev/docs/permissionsandroid */ class PermissionsAndroid { PERMISSIONS: {| ACCEPT_HANDOVER: string, ACCESS_BACKGROUND_LOCATION: string, ACCESS_COARSE_LOCATION: string, ACCESS_FINE_LOCATION: string, ACCESS_MEDIA_LOCATION: string, ACTIVITY_RECOGNITION: string, ADD_VOICEMAIL: string, READ_VOICEMAIL: string, WRITE_VOICEMAIL: string, ANSWER_PHONE_CALLS: string, BLUETOOTH_ADVERTISE: string, BLUETOOTH_CONNECT: string, BLUETOOTH_SCAN: string, BODY_SENSORS: string, BODY_SENSORS_BACKGROUND: string, CALL_PHONE: string, CAMERA: string, GET_ACCOUNTS: string, NEARBY_WIFI_DEVICES: string, POST_NOTIFICATIONS: string, PROCESS_OUTGOING_CALLS: string, READ_CALENDAR: string, READ_CALL_LOG: string, READ_CONTACTS: string, READ_EXTERNAL_STORAGE: string, READ_MEDIA_IMAGES: string, READ_MEDIA_VIDEO: string, READ_MEDIA_AUDIO: string, READ_PHONE_NUMBERS: 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, UWB_RANGING: 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 { 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#check */ check(permission: PermissionType): Promise { 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#explain) * and then shows the system permission dialog * * @deprecated */ async requestPermission( permission: PermissionType, rationale?: Rationale, ): Promise { 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#request */ async request( permission: PermissionType, rationale?: Rationale, ): Promise { 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[incompatible-exact] (>=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#requestmultiple */ requestMultiple( permissions: Array, ): 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;