harmony 鸿蒙Open user_grant Permissions

2025-06-12
浏览 (4)

Open user_grant Permissions

All the permissions in this topic are available to all applications and granted by the user.

This type of permissions must be declared in the application installation package and authorized by the user in a dialog box during the running of the application. The application has the permission only after the user has granted the permission.

NOTE “Enable via ACL” is not involved for permissions of the normal level.

Request Mode

The user_grant permissions are permissions granted by users. For details about how to request this type of permissions, see Declaring Permissions > Requesting User Authorization.

ohos.permission.ACCESS_BLUETOOTH

Allows an application to access Bluetooth and use Bluetooth capabilities, such as pairing and connecting to peripheral devices.

Permission level: normal

Authorization mode: user_grant

Valid since: 10

ohos.permission.MEDIA_LOCATION

Allows an application to access geographical locations in the user’s media file.

Permission level: normal

Authorization mode: user_grant

Valid since: 7

ohos.permission.APP_TRACKING_CONSENT

Allows an application to read the open anonymous device identifier (OAID).

Permission level: normal

Authorization mode: user_grant

Valid since: 9

ohos.permission.ACTIVITY_MOTION

Allows an application to read the current workout status of the user, such as detecting whether the user is working out and recording the number of steps the user has taken.

Permission level: normal

Authorization mode: user_grant

Valid since: 7

ohos.permission.CAMERA

Allows an application to use the camera.

Permission level: normal

Authorization mode: user_grant

Valid since: 9

ohos.permission.DISTRIBUTED_DATASYNC

Allows the application data to be exchanged between devices.

Permission level: normal

Authorization mode: user_grant

Valid since: 7

ohos.permission.LOCATION_IN_BACKGROUND

Allows an application running in the background to obtain the device location.

For security purposes, this permission cannot be granted to applications in a dialog box. If an application needs this permission, direct the user to manually grant this permission on the Settings screen.

Procedure:

Declare permissions in the module.json5 file.

You must request the foreground location permission before requesting the background permission. Therefore, you must declare both the ohos.permission.LOCATION_IN_BACKGROUND permission and the foreground location permission. The foreground location permissions include the following: - Request ohos.permission.APPROXIMATELY_LOCATION. - Request ohos.permission.APPROXIMATELY_LOCATION and ohos.permission.LOCATION. 2. Request the foreground location permission from the user through a pop-up window. 3. After the user grants the foreground location permissions, display a message to direct the user to go to the Settings screen to grant the ohos.permission.LOCATION_IN_BACKGROUND permission. 4. The permission is granted to the application if the user selects Always allow on the Settings screen.

Paths: - Path 1: Settings > Privacy > Permission manager > Permissions > Location > Target application - Path 2: Settings > Privacy > Permission manager > Apps > Target application > Location

Permission level: normal

Authorization mode: user_grant

Valid since: 7

ohos.permission.LOCATION

Allows an application to obtain the device location.

Prerequisites: This permission must be requested with ohos.permission.APPROXIMATELY_LOCATION together.

Permission level: normal

Authorization mode: user_grant

Valid since: 7

ohos.permission.APPROXIMATELY_LOCATION

Allows an application to obtain the approximate location information of a device.

Permission level: normal

Authorization mode: user_grant

Valid since: 9

ohos.permission.MICROPHONE

Allows an application to access the microphone.

Permission level: normal

Authorization mode: user_grant

Valid since: 8

ohos.permission.READ_CALENDAR

Allows an application to read Calendar data.

Permission level: normal

Authorization mode: user_grant

Valid since: 8

ohos.permission.WRITE_CALENDAR

Allows an application to add, remove, and modify Calendar events.

Permission level: normal

Authorization mode: user_grant

Valid since: 8

ohos.permission.READ_HEALTH_DATA

Allows an application to read the health data of the user.

Permission level: normal

Authorization mode: user_grant

Valid since: 7

ohos.permission.ACCESS_NEARLINK

Allows an application to use NearLink, such as device pairing and connecting to nearby devices.

Permission level: normal

Authorization mode: user_grant

Valid since: 12

ohos.permission.READ_WRITE_DOWNLOAD_DIRECTORY

Allows an application to access the Download directory and its subdirectories in the user directory.

Currently, this permission is available only to 2-in-1 device applications.

Permission level: normal

Authorization mode: user_grant

Valid since: 11

Changelog: The permission level is system_basic in API version 11, and is changed to normal since API version 12.

ohos.permission.READ_WRITE_DOCUMENTS_DIRECTORY

Allows an application to access the Documents directory and its subdirectories in the user directory.

Currently, this permission is available only to 2-in-1 device applications.

Permission level: normal

Authorization mode: user_grant

Valid since: 11

Changelog: The permission level is system_basic in API version 11, and is changed to normal since API version 12.

ohos.permission.CUSTOM_SCREEN_CAPTURE

Allows an application to capture screen information.

With this permission, the application can perform operations such as taking screenshots and recording on-screen information. Currently, this permission is available only to applications running on tablets and 2-in-1 devices.

Permission level: system_basic

Authorization mode: user_grant

Enable via ACL: true

Valid since: 14