此模块提供适用于原生 ActivityView 类的 C++ 和 QML 包装器。提供了一个 Qt Quick 插件，以便通过 QML 访问。

Android 的 ActivityView 是一个用于在另一 Activity 中显示 Android 的 Activity 的便捷类。它直接提供嵌入式应用或活动的正确渲染和事件处理。它创造了在一个应用中嵌入另一个应用的可能性。例如，同时在内应用中显示地图应用和音乐播放器。

使用模块

使用 Qt 模块需要链接到模块库，无论是直接链接还是通过其他依赖项。

使用 CMake 构建

使用 find_package() 和 target_link_libraries() 命令从 Qt6 软件包中定位并链接所需的模块组件

find_package(Qt6 COMPONENTS AndroidActivityView)
target_link_libraries(mytarget PUBLIC Qt::AndroidActivityView)

使用 qmake 构建

将 androidactivityview 添加到 QT 变量中

QT += androidactivityview

C++ API

要包含模块类的定义，对于 C++ 使用以下指令

#include <QtAndroidActivityView>

QML API

对于 QML 类型，将以下导入语句添加到您的 .qml 文件中

import QtAndroidAutomotive.ActivityView

权限

模块需要 Android 权限才能正常工作。有关更多详细信息，请参阅 Qt Android Activity View 模块中的权限。

API 参考

到 API 参考 materials 的链接

• C++ 类
• QML 类型

示例

• Qt Android Activity View 示例

活动视图已知问题和限制

由于 ActivityView 需要特殊权限并依赖于私有 Android API，因此使用它的应用程序必须使用平台密钥签名。

Android 10

由提供的 packageName 和 className 解析的活动必须将 resizeableActivity 属性设置为 true 才能正确启动为嵌入式活动。此外，如果该活动不属于本应用程序的所有者，则必须允许嵌入。这项规则也适用于从嵌入式活动中启动的活动。否则，新活动可能无法正确运行，例如，可能以全屏方式启动。