Sideloading and Traffic Inspection on Google TV Streamer: A QA Setup Guide

Source: Dev.to

Motivation

When testing streaming applications on Android‑based TV devices, establishing a reliable workflow for APK deployment and network traffic inspection is essential. This guide covers the full configuration process for Google TV Streamer — from enabling developer access to routing device traffic through Charles Proxy for API validation and debugging.

Prerequisites

• Charles Proxy installed and activated with a valid license.
• Charles SSL certificate downloaded and trusted on your test machine. (In Charles: Help > SSL Proxying > Install Charles Root Certificate.)
• Google TV Streamer has Developer Mode enabled (see Part 1).
• The test machine running Charles and the Google TV Streamer are connected to the same local network.

Part 1: Enable Developer Options and ADB Debugging

1.1 Enable Developer Mode

1. Go to Settings > System > About.
2. Select “Android TV OS Build” seven times.
3. Return to Settings; a new Developer Options entry appears.
4. Open Developer Options and toggle on “Enable developer options”.

1.2 Enable ADB Debugging

Within Developer Options, enable both USB Debugging and Wireless Debugging. Wireless Debugging allows an ADB connection over the local network without a USB cable.

Part 2: ADB Connection and APK Installation

Step 1: Obtain Required Tools

1. Open Wireless Debugging on the device and note the displayed IP address and port (e.g., 192.168.0.10:12345).
2. Download the Android SDK Platform Tools for your OS from the official site.
3. Extract the archive to a folder of your choice (typically platform-tools).
4. Place the target .apk file in the root of the platform-tools folder.

Step 2: Connect via ADB and Install the APK

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

# Connect to the device
adb connect 192.168.0.10:12345

If the device shows an authorization prompt, approve it. Once the connection is confirmed, install the APK:

adb install app.apk

Replace app.apk with the exact filename of your APK. A success message indicates the app is now installed and ready for testing.

Part 3: Charles Proxy Configuration

Configure the Device Proxy

1. On the Google TV Streamer, go to Settings > Wi‑Fi and tap the active Wi‑Fi network.
2. Scroll to Proxy Settings and set the mode to Manual.
3. Enter the following values:

To find your machine’s local IP, in Charles select Help > Local IP Address.

4. Save the settings. Traffic from the Google TV Streamer should now appear in Charles.

Recommended: Disable OS Proxy in Charles

To isolate device traffic, disable the host‑machine proxy:

• macOS: Proxy > macOS Proxy (uncheck)
• Windows: Proxy > Windows Proxy (uncheck)

This removes background noise and ensures the Charles session reflects only the Google TV Streamer’s network activity.

Summary

After completing this setup you will have:

• Wireless APK deployment via ADB for rapid build installation.
• Full network traffic visibility through Charles Proxy for API validation, payload inspection, and network‑layer debugging.

The configuration supports functional, integration, and regression testing workflows on Google TV Streamer and other Android‑based streaming platforms.