Google TV Streamer에서 사이드로드 및 트래픽 검사: QA 설정 가이드

Source: Dev.to

동기

Android 기반 TV 디바이스에서 스트리밍 애플리케이션을 테스트할 때, 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. Settings > System > About 로 이동합니다.
2. “Android TV OS Build” 를 일곱 번 탭합니다.
3. Settings 로 돌아가면 새로운 Developer Options 항목이 나타납니다.
4. Developer Options 를 열고 “Enable developer options” 를 켭니다.

1.2 ADB 디버깅 활성화

Developer Options 안에서 USB Debugging 과 Wireless Debugging 모두 켭니다. Wireless Debugging은 USB 케이블 없이 로컬 네트워크를 통해 ADB 연결을 가능하게 합니다.

파트 2: ADB 연결 및 APK 설치

단계 1: 필요한 도구 확보

1. 디바이스에서 Wireless Debugging 을 열고 표시되는 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

디바이스에 인증 프롬프트가 표시되면 승인합니다. 연결이 확인되면 APK를 설치합니다:

adb install app.apk

app.apk 를 실제 APK 파일명으로 교체합니다. 성공 메시지가 나오면 앱이 설치된 것이며 테스트를 진행할 수 있습니다.

파트 3: Charles Proxy 설정

디바이스 프록시 구성

1. Google TV Streamer에서 Settings > Wi‑Fi 로 이동한 뒤 현재 연결된 Wi‑Fi 네트워크를 탭합니다.
2. Proxy Settings 로 스크롤하고 모드를 Manual 로 설정합니다.
3. 다음 값을 입력합니다:

머신의 로컬 IP를 확인하려면 Charles에서 Help > Local IP Address 를 선택합니다.

4. 설정을 저장합니다. 이제 Google TV Streamer의 트래픽이 Charles에 표시됩니다.

권장 설정: Charles에서 OS 프록시 비활성화

디바이스 트래픽만 분리해서 보기 위해 호스트 머신의 프록시를 끕니다:

• macOS: Proxy > macOS Proxy (체크 해제)
• Windows: Proxy > Windows Proxy (체크 해제)

이렇게 하면 백그라운드 잡음이 사라지고 Charles 세션에 Google TV Streamer의 네트워크 활동만 나타납니다.

요약

이 설정을 마치면 다음을 수행할 수 있습니다:

• 무선 APK 배포를 ADB를 통해 빠르게 진행하여 빌드를 설치.
• Charles Proxy를 통한 전체 네트워크 트래픽 가시성 확보로 API 검증, 페이로드 검사, 네트워크 레이어 디버깅 가능.

이 구성은 Google TV Streamer 및 기타 Android 기반 스트리밍 플랫폼에서 기능, 통합, 회귀 테스트 워크플로우를 지원합니다.