En esta página

qt_add_harmonyos_permission

Añade un permiso de HarmonyOS al ejecutable de destino.

El comando está definido en el componente « Core » del paquete « Qt6 », que se puede cargar de la siguiente manera:

find_package(Qt6 REQUIRED COMPONENTS Core)

Este comando se introdujo en Qt 6.12.

Nota: Este comando se encuentra en fase de vista previa tecnológica y puede sufrir cambios en futuras versiones.

Nota: Este comando solo debe invocarse si se está desarrollando para la plataforma HarmonyOS.

Sinopsis

qt_add_harmonyos_permission(target
    NAME <permission-name>
    [REASON <reason>]
    [USED_SCENE_ABILITIES <ability> [<ability>...]]
    [USED_SCENE_WHEN inuse | always]
)

Si los comandos sin versión están desactivados, utiliza en su lugar qt6_add_harmonyos_permission(). Admite el mismo conjunto de argumentos que este comando.

Descripción

El comando añade un permiso de HarmonyOS al ejecutable target. El permiso se escribe en la matriz requestPermissions del manifiesto module.json5 generado al compilar el paquete HAP. Utiliza este comando para solicitar permisos adicionales a los permisos predeterminados aportados por los módulos Qt a los que se vincula tu aplicación.

Para consultar la lista de nombres de permisos disponibles y sus requisitos, consulta la documentación sobre permisos de aplicaciones de HarmonyOS.

Argumentos

NAME es el identificador del permiso, por ejemplo, ohos.permission.CAMERA. Es el único argumento obligatorio.

REASON es el mensaje que se muestra al usuario cuando el sistema solicita un permiso « user_grant ». Acepta tanto una cadena literal como una referencia a un recurso de tipo « $string:<name> » que se resuelve en una cadena localizada procedente de los archivos de recursos de la aplicación. Al especificar « REASON », se emite un bloque « usedScene » para dicho permiso.

USED_SCENE_ABILITIES es la lista de capacidades que utilizan el permiso. Si se omite mientras se emite un bloque usedScene, el valor por defecto es QAbility, que es la única capacidad que aloja una aplicación Qt.

USED_SCENE_WHEN Establece cuándo se accede al permiso. Los valores aceptados son inuse (el permiso solo se utiliza mientras la aplicación está en primer plano) y always (el permiso también se utiliza en segundo plano). Si se omite al emitir un bloque usedScene, el valor por defecto es inuse.

Las palabras clave « USED_SCENE_ABILITIES » y « USED_SCENE_WHEN » se corresponden directamente con los campos « abilities » y « when » del objeto « usedScene » del permiso en el archivo « module.json5 » generado.

Ejemplo

qt_add_harmonyos_permission(myapp
    NAME ohos.permission.CAMERA
    REASON "$string:camera_permission_reason"
    USED_SCENE_WHEN inuse
)
qt_add_harmonyos_permission(myapp
    NAME ohos.permission.INTERNET
)

Véase también la API de CMake de Qt para HarmonyOS.

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.