qt_add_harmonyos_permission

Fügt der Ziel-Ausführungsdatei eine HarmonyOS-Berechtigung hinzu.

Der Befehl ist in der Komponente „ Core “ des Pakets „ Qt6 “ definiert, das wie folgt geladen werden kann:

find_package(Qt6 REQUIRED COMPONENTS Core)

Dieser Befehl wurde in Qt 6.12 eingeführt.

Übersicht

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

Wenn versionslose Befehle deaktiviert sind, verwenden Sie stattdessen „ qt6_add_harmonyos_permission() “. Dieser Befehl unterstützt dieselben Argumente wie der vorliegende Befehl.

Beschreibung

Der Befehl fügt der ausführbaren Datei „ target “ eine HarmonyOS-Berechtigung hinzu. Die Berechtigung wird beim Erstellen des HAP-Pakets in das Array „ requestPermissions “ des generierten Manifests „ module.json5 “ geschrieben. Verwenden Sie diesen Befehl, um zusätzliche Berechtigungen anzufordern, die über die Standardberechtigungen hinausgehen, die von den Qt-Modulen bereitgestellt werden, mit denen Ihre Anwendung verknüpft ist.

Eine Liste der verfügbaren Berechtigungsnamen und ihrer Anforderungen finden Sie in der Dokumentation zu HarmonyOS-Anwendungsberechtigungen.

Argumente

NAME ist die Berechtigungskennung, zum Beispiel ohos.permission.CAMERA. Dies ist das einzige erforderliche Argument.

REASON ist die Meldung, die dem Benutzer angezeigt wird, wenn das System um die Berechtigung „ user_grant “ bittet. Es akzeptiert entweder eine literale Zeichenkette oder eine „ $string:<name> “-Ressourcenreferenz, die zu einer lokalisierten Zeichenkette aus den Ressourcendateien der Anwendung aufgelöst wird. Die Angabe von „ REASON “ bewirkt, dass für die Berechtigung ein „ usedScene “-Block ausgegeben wird.

USED_SCENE_ABILITIES ist die Liste der Fähigkeiten, die die Berechtigung nutzen. Wird sie bei der Ausgabe eines „ usedScene “-Blocks weggelassen, wird standardmäßig „ QAbility “ verwendet – dies ist die einzige Fähigkeit, die eine Qt-Anwendung hostet.

USED_SCENE_WHEN Legt fest, wann auf die Berechtigung zugegriffen wird. Die zulässigen Werte sind „ inuse “ (die Berechtigung wird nur genutzt, solange sich die Anwendung im Vordergrund befindet) und „ always “ (die Berechtigung wird auch im Hintergrund genutzt). Wird dieser Parameter bei der Ausgabe eines „ usedScene “-Blocks weggelassen, wird standardmäßig „ inuse “ verwendet.

Die Schlüsselwörter „ USED_SCENE_ABILITIES “ und „ USED_SCENE_WHEN “ entsprechen direkt den Feldern „ abilities “ und „ when “ des Objekts „ usedScene “ der Berechtigung in der generierten Datei „ module.json5 “.

Beispiel

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
)