Qt 文档

Neptune 3 UI - 配置

为了可维护性，UI 配置被拆分为多个 YAML 文件，如下表所述

文件	描述
`am-config-neptune.yaml`	定义了中央控制台显示和集群特定配置。例如，内置应用及其运行时（本地或 QML）、导入路径、UI 特定的配置（如全屏模式），以及主 QML 文件（如果它是 QML 运行时）。此 YAML 文件配置 Neptune 3 UI 使用 "neptune" 风格。
`am-config-lucee.yaml`	与 `am-config-neptune.yaml` 类似，但此 YAML 文件配置 Neptune 3 UI 使用 "lucee" 风格。
`info.yaml`	定义了特定应用的配置，如主 QML 文件及其导入。有关更多信息，请参阅清单定义。

以下代码是 am-config-neptune.yaml 文件的示例

formatVersion: 1
formatType: am-configuration
---
# basic AM functionality - the builtin apps are in 'apps'.
# installations will go into the standard QStandardPath AppLocalDataLocation
# (e.g. ~/.local/share/Luxoft Sweden AB/Neptune UI) /am hierarchy

applications:
  builtinAppsManifestDir: "${CONFIG_PWD}/apps"
  installedAppsManifestDir: "${stdpath:AppLocalDataLocation}/neptune3-ui/manifests"
  installationDir: "${stdpath:AppLocalDataLocation}/neptune3-ui/apps"
  documentDir: "${stdpath:AppLocalDataLocation}/neptune3-ui/docs"

# QML apps will be able to import from modules...

runtimes:
qml:
    importPaths: [ "${CONFIG_PWD}/imports_shared" ]
    environmentVariables:
    QT_PLUGIN_PATH: ${CONFIG_PWD}
    SERVER_CONF_PATH: ${CONFIG_PWD}/server.conf
native:
    importPaths: [ "${CONFIG_PWD}/imports_shared" ]
    environmentVariables:
    QT_PLUGIN_PATH: ${CONFIG_PWD}
    SERVER_CONF_PATH: ${CONFIG_PWD}/server.conf

# ... as well as the SystemUI

ui:
    fullscreen: no
    style: "${CONFIG_PWD}/styles/neptune"
    iconThemeName: "neptune"
    iconThemeSearchPaths: [ "${CONFIG_PWD}/imports_shared/assets/icons" ]
    mainQml: "${CONFIG_PWD}/Main.qml"
    importPaths: [ "${CONFIG_PWD}/imports_shared", "${CONFIG_PWD}/imports_system", "${CONFIG_PWD}/sysui" ]
    windowIcon: "${CONFIG_PWD}/imports_shared/assets/icons/neptune/sysui/ic-menu-home.png"

systemProperties:
    public:
        showCluster: yes
        showHUD: yes
        devMode: yes
        hardwareVariant: 'high'
        #Qt Safe Renderer settings
        qsrEnabled: no
        qsrServerAddress: '127.0.0.1'
        qsrServerPort: '1111'
        showSystemAppsInLauncher: no
    private:
        appStoreServerUrl: 'http://demoappsdeploy.qt.io:8514'
        orientation: 'Portrait'
        adjustSizesForScreen: yes

# development setup: no security
flags:
    noSecurity: yes
    noUiWatchdog: yes

此 YAML 文件包含用于显示除中央控制台之外的屏幕的系统属性选项，例如仪表集群或平视显示器（HUD）。默认情况下启用这些屏幕。将 showCluster 或 showHUD 设置为 no，以让 Neptune 3 UI 知道不应显示这些屏幕。

您还可以将 devMode 选项设置为 yes 或 no，以在 Neptune 3 UI 中启用或禁用开发模式。启用后，Sheets 应用将包含在应用程序启动器中，开发人员可以看到 Neptune 3 UI 所支持的所有组件，以开发应用。

enableCursorManagement 选项可以设置为 yes 或 no，以在 Neptune 3 UI 的中央控制台仅启用或禁用光标支持。启用后，可以使用除了触摸之外的其他输入方法（例如键盘或游戏手柄）导航中心控制台。

可以使用 hardwareVariant 参数指定使用的硬件类型。根据变体，功能将根据硬件是否支持它们来启用或禁用。目前，此参数接受两个值：high 或 low。如果设置为 low，则禁用一些性能密集型的图形效果，这些效果会导致类似 Raspberry Pi 等低端设备上的帧率变低。

要启用 Qt 安全渲染器，可以将 qsrEnabled 设置为 yes，这允许您在集群应用中加载安全提示。有关更多信息，请参阅 Neptune 3 UI - Qt 安全渲染器集成。

showSystemAppsInLauncher 参数可以让您在启动器中显示或隐藏系统应用，例如集群、HUD 或气候应用。

adjustSizesForScreen 参数用于修改中央控制台窗口和仪表集群窗口的大小。当目标平台是桌面且未使用全屏模式时，此调整通常是必需的。

如果您想使用 Qt 汽车套件部署服务器，请将 appStoreServerUrl 参数设置为包含您的服务器的基 URL 以及端口号。当前默认值为 http://demoappsdeploy.qt.io:8514。

所有这些选项都可以从命令行通过将参数传递给 appman 工具进行配置。更多信息，请参阅 Qt 应用程序管理器配置。

appman --option 'ui: { fullscreen: no }'

注意：更改 YAML 文件后，您必须为您的目标重新生成 Yocto 映像。更多详细信息，请参阅构建自己的嵌入式 Linux 映像。

©2019 瑞典卢森堡 AB。本文件中包含的文档贡献的版权属于其各自所有者。
提供的文档根据 Free Software Foundation 发布的 GNU 自由文档许可版 1.3 的条款进行许可。
Qt 和相应的标志是芬兰 Qt 公司及其/或其他国家的商标。所有其他商标均为其各自所有者的财产。