运行演示应用

本页面介绍了如何使用演示应用和 Google Play 管理中心运行端到端测试。

步骤

要下载 SDK、运行演示应用、验证应用是否正常工作以及在 Google Play 管理中心查看应用中的帧计时信息，请执行以下操作：

下载 SDK .zip 文件并解压。
构建并运行演示应用。
运行监控应用。
创建发布版本。
运行发布版本。
在 Google Play 管理中心查看图表。

构建并运行演示应用

在 Android Studio 中运行 APT Insights 演示应用，以确保一切都正确构建。此项目使用 CMake 进行原生代码构建，并演示了如何使用 gamesdk.cmake 文件，这是最简单的入门方法。

要运行演示应用，请执行以下操作：

将 .zip 文件内容解压到一个文件夹。
打开 Android Studio。
点击文件 > 打开，然后选择 gamesdk/samples/tuningfork/insightsdemo/build.gradle。
等待 Android Studio 同步项目。
连接设备（或创建虚拟设备）以运行示例。在设备上启用开发者选项和 USB 调试。
选择目标设备，然后点击运行。有关详情，请参阅构建并运行您的应用。

图 1. 测试应用成功运行
示例 APK 应该在目标设备上构建并安装。如果遇到错误，请检查以下内容：
- 您拥有支持的 Android SDK 版本；有关详情，请参阅应用模块 build.gradle 文件中的 compileSdkVersion 字段。您可以从 SDK 管理器中的SDK 平台标签页更新 SDK 版本。
- 您拥有支持的 Android NDK 版本；有关详情，请参阅应用模块 build.gradle 文件中的 ndkVersion 字段。您可以从 SDK 管理器中的SDK 工具标签页安装特定版本的 NDK。
- 项目中的 local.properties 文件没有 ndk.dir 条目。此位置由 Android Studio 指定，并使用上述 NDK 版本。如果您有此条目，请清除整行。
- 在更改任何构建设置后，清理项目（构建 > 清理项目）并刷新关联的 C++ 项目（构建 > 刷新关联的 C++ 项目）。

运行监控应用

对于演示应用或任何其他启用了 Tuning Fork 的应用的调试版本，您可以配置应用从本地端点而非 Google Play 服务器发送和接收数据。为此，请在 Tuning Fork 设置中设置 endpoint_uri_override：

#ifndef NDEBUG
   settings.endpoint_uri_override = "https://:9000";
#endif

您还必须在 AndroidManifest.xml 文件中包含以下权限：

<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />

演示应用已包含这些更改（请参阅 insightsdemo.cpp）。

您可以使用此功能来验证应用是否正在发送和接收正确的数据。为此，请同时运行演示应用和 Tuning Fork Monitor 应用。此监控应用充当本地服务器，并显示启用了 Tuning Fork 的应用生成的数据。

要同时运行监控应用和演示应用以验证演示应用是否正常工作，请执行以下操作：

使用 adb 在目标设备上安装 Tuning Fork Monitor 应用 APK：
```
adb install gamesdk/gamesdk/apks/tools/TuningForkMonitor.apk
```
打开监控应用。
按下 Android 主页按钮，将 Tuning Fork Monitor 应用发送到设备后台。
再次运行演示应用，并在前台运行约 30 秒。
切换回 Tuning Fork Monitor 应用。
演示应用在正在运行的应用下显示为 com.tuningfork.insightsdemo 16。点击此条目可查看应用详情和实时遥测数据。

创建发布版本

在 Android Studio 中创建演示应用的发布版本。您将此版本上传到 Google Play 管理中心，以在 Android Vitals 中启用帧计时图表。

在 Google Cloud Console 中启用 Android Performance Parameters API。此 API 使应用能够与 Google Play 通信。您无需限制演示应用的 API 密钥。
请务必将上一步中的 API 密钥复制到 gamesdk/samples/tuningfork/insightsdemo/app/src/main/assets/tuningfork/tuningfork_settings.txt 文件中的 api_key 字段。
演示应用的应用 ID 已被保留，因此无法上传使用该 ID 的 APK。请在应用的 build.gradle 文件中更改此 ID：
```
applicationId "com.tuningfork.your-unique-identifier"
```
清理项目（构建 > 清理项目）并刷新关联的 C++ 项目（构建 > 刷新关联的 C++ 项目）。
为发布版本创建签名配置。
1. 选择文件 > 项目结构 > 模块。
2. 选择签名配置标签页。
3. 添加名为 release 的新配置。
4. 为该配置创建密钥库。
将发布签名配置与发布构建变体关联。
1. 选择文件 > 项目结构 > 构建变体。
2. 选择构建类型标签页。
3. 选择名为 release 的构建类型。
4. 在签名配置框中，选择发布配置变量。
在 Android Studio 项目窗口中，选择 app 目录。（此选择将启用下一步中的菜单选择。）
将活动构建变体更改为 release（构建 > 选择构建变体）。
选择构建 > 构建软件包/APK > 构建 APK。构建完成后，点击定位链接以查找发布 APK。
在 Google Play 管理中心为演示应用创建一个新应用。有关详情，请参阅上传应用。
将发布 APK 上传到内部测试轨道。有关详情，请参阅准备并发布版本。

注意： 您必须将 APK 上传到 Google Play 上的内部测试轨道。否则，隐私过滤器将阻止关联图表的显示。

运行发布版本

选择目标设备，然后点击运行。您必须使用上传到 Google Play 管理中心的同一发布 APK。

让演示应用运行一段时间。Google Play 管理中心可能需要长达 30 分钟才能开始显示数据。通过在 Logcat 窗口中选择信息日志级别来验证数据是否正在上传到服务器。如果您在日志中看到错误，请参阅排查常见错误。

... I/TuningFork:Web: Connecting to:
    https://performanceparameters.googleapis.com/v1/applications/com.tuningfork.yourapp/apks/24:uploadTelemetry
... I/TuningFork: Scene loading 30 (true) took 166 ms
... I/TuningFork:Web: Response code: 200
... I/TuningFork:Web: Response message: OK
... I/TuningFork.GE: UPLOAD request returned 200 {}