Google TV Streamer 的侧载与流量检查：QA 设置指南

Source: Dev.to

动机

在 Android 电视设备上测试流媒体应用时，建立可靠的 APK 部署和网络流量检查工作流至关重要。本指南涵盖 Google TV Streamer 的完整配置过程——从开启开发者访问到通过 Charles Proxy 路由设备流量，以进行 API 验证和调试。

前置条件

• 已安装 Charles Proxy 并激活有效许可证。
• 已下载 Charles SSL 证书 并在测试机器上信任。（在 Charles 中：Help > SSL Proxying > Install Charles Root Certificate。）
• Google TV Streamer 已启用开发者模式（见第 1 部分）。
• 运行 Charles 的测试机器与 Google TV Streamer 连接在 同一局域网。

第 1 部分：启用开发者选项和 ADB 调试

1.1 启用开发者模式

1. 前往 设置 > 系统 > 关于。
2. 连点 “Android TV OS Build” 七次。
3. 返回 设置；此时会出现新的 开发者选项 条目。
4. 打开 开发者选项 并切换 “启用开发者选项”。

1.2 启用 ADB 调试

在 开发者选项 中，同时启用 USB 调试 和 无线调试。无线调试允许在局域网内无需 USB 线即可进行 ADB 连接。

第 2 部分：ADB 连接与 APK 安装

步骤 1：获取所需工具

1. 在设备上打开 无线调试，记录显示的 IP 地址和端口（例如 192.168.0.10:12345）。
2. 从官方站点下载适用于你操作系统的 Android SDK Platform Tools。
3. 将压缩包解压到任意文件夹（通常为 platform-tools）。
4. 将目标 .apk 文件放置在 platform-tools 文件夹根目录下。

步骤 2：通过 ADB 连接并安装 APK

# Navigate to the platform-tools directory
cd path/to/platform-tools

# Connect to the device
adb connect 192.168.0.10:12345

如果设备弹出授权提示，请予以批准。连接确认后，执行安装：

adb install app.apk

将 app.apk 替换为你的 APK 的完整文件名。出现成功信息即表示应用已安装并可进行测试。

第 3 部分：Charles Proxy 配置

配置设备代理

1. 在 Google TV Streamer 上，进入 设置 > Wi‑Fi 并点击当前连接的 Wi‑Fi 网络。
2. 滑动至 代理设置，将模式设为 手动。
3. 输入以下数值：

要获取机器的本地 IP，可在 Charles 中选择 Help > Local IP Address。

4. 保存设置。此时 Google TV Streamer 的流量应会出现在 Charles 中。

推荐：在 Charles 中禁用系统代理

为仅捕获设备流量，关闭主机机器的代理：

• macOS： Proxy > macOS Proxy（取消勾选）
• Windows： Proxy > Windows Proxy（取消勾选）

这样可以去除后台噪声，确保 Charles 会话仅反映 Google TV Streamer 的网络活动。

总结

完成此套配置后，你将拥有：

• 通过 ADB 的 无线 APK 部署，实现快速构建安装。
• 通过 Charles Proxy 的 完整网络流量可视化，用于 API 验证、负载检查以及网络层调试。

该配置支持在 Google TV Streamer 以及其他基于 Android 的流媒体平台上进行功能、集成和回归测试工作流。