qt_add_harmonyos_permission

Ajoute une autorisation HarmonyOS à l'exécutable cible.

La commande est définie dans le composant « Core » du paquet « Qt6 », qui peut être chargé comme suit :

find_package(Qt6 REQUIRED COMPONENTS Core)

Cette commande a été introduite dans Qt 6.12.

Syntaxe

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

Si les commandes sans version sont désactivées, utilisez plutôt qt6_add_harmonyos_permission(). Elle prend en charge le même ensemble d'arguments que cette commande.

Description

Cette commande ajoute une autorisation HarmonyOS à l’exécutable ` target `. L’autorisation est inscrite dans le tableau ` requestPermissions ` du manifeste ` module.json5 ` généré lors de la compilation du paquet HAP. Utilisez cette commande pour demander des autorisations supplémentaires en plus des autorisations par défaut fournies par les modules Qt auxquels votre application est liée.

Pour obtenir la liste des noms d’autorisations disponibles et de leurs exigences, consultez la documentation relative aux autorisations des applications HarmonyOS.

Arguments

NAME est l’identifiant de l’autorisation, par exemple ohos.permission.CAMERA. Il s’agit du seul argument obligatoire.

REASON est le message affiché à l’utilisateur lorsque le système demande une autorisation de type « user_grant ». Il accepte soit une chaîne littérale, soit une référence de ressource de type « $string:<name> » qui renvoie à une chaîne localisée issue des fichiers de ressources de l’application. La spécification de « REASON » entraîne la génération d’un bloc « usedScene » pour l’autorisation.

USED_SCENE_ABILITIES Il s'agit de la liste des capacités qui utilisent l'autorisation. Si elle est omise alors qu'un bloc « usedScene » est émis, la valeur par défaut est « QAbility », qui correspond à la seule capacité hébergeant une application Qt.

USED_SCENE_WHEN Définit quand l’autorisation est accessible. Les valeurs acceptées sont inuse (l’autorisation n’est utilisée que lorsque l’application est au premier plan) et always (l’autorisation est également utilisée en arrière-plan). Si ce paramètre est omis lors de l’émission d’un bloc usedScene, la valeur par défaut est inuse.

Les mots-clés « USED_SCENE_ABILITIES » et « USED_SCENE_WHEN » correspondent directement aux champs « abilities » et « when » de l’objet « usedScene » de l’autorisation dans le fichier « module.json5 » généré.

Exemple

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
)