기가지니 웹앱 로그 관리 가이드 - GiGAGenie-ServiceSDK/UserGuide GitHub Wiki

기가지니 웹앱 로그 관리 가이드

소개

  • 기존 AOSP 기가지니 단말(지니TV 셋톱박스1, 지니TV 셋톱박스2, ...)에서는 단말과 PC를 연결할 수 없어 웹앱 로그 확인이 불가했습니다.
  • AndroidTV 계열 단말부터 일반 사용자도 단말과 PC 연결이 가능해졌기에 3rd Party 웹앱에서 자신이 설정한 로그를 확인할 수 있도록 가이드를 제공하려 합니다.

시작하시기 전에

  • 기가지니 웹앱 로그는 AndroidTV 계열 단말(지니TV 셋톱박스A, 지니TV 셋톱박스3, ...)에서만 지원합니다.
  • 안드로이드 단말과 PC를 연결할때는 adb(Android Debug Bridge)를 사용하며, adb 사용을 위해 Android Platform Tools 설치가 필요합니다.(https://developer.android.com/studio/releases/platform-tools?hl=ko)

단말 설정

  • 기가지니 단말에서 웹앱 로그를 확인하기 위해선 단말과 PC의 연결이 필요합니다.
  • 아래와 같은 단말 설정을 통해 단말과 PC 연결이 가능해집니다.

  1. TV 홈 메뉴에서 톱니바퀴 이미지를 선택하여 단말 설정 화면으로 이동합니다. 7-1

  2. 구글설정 -> 기기 환경설정 -> 정보 -> Android TV OS 빌드에서 7번 선택 시 개발자 옵션이 활성화됩니다.

7-2

  1. 기기 환결설정으로 돌아가 개발자 옵션 메뉴에서 USB 디버깅 옵션 or Ethernet 디버깅을 활성화합니다. (단말 버전에 따라 특정 메뉴가 없을 수 있습니다.) 7-4

일부 단말(ex. KSTB6188)의 경우 위 방법으로 연결 불가능한 경우가 있습니다. 아래 가이드 이용 부탁드립니다.

USB 디버깅 모드

사용방법

  • 단말에 따라 USB 디버깅을 활성화 했을때 Ethernet 연결을 해야할 수 있습니다.
  • USB 디버깅 활성화시
  1. USB 케이블을 통해 기가지니 단말과 PC를 연결합니다.
  2. 연결되었다면 아래 명령어 사용해 확인 가능합니다.

adb devices

List of devices attached

42420004500039 device
  • Ethernet 디버깅 활성화시
  1. adb path 설정 혹은 adb tool이 설치된 경로에서 아래 명령어 입력해 단말 연결

adb connect 단말ip주소:5555
  1. 연결되었다면 아래 명령어 사용해 확인 가능합니다.

adb devices

List of devices attached

ip주소:5555    device
  • 단말 연결후 크롬에서 chrome://inspect/#devices 주소 접속
  • 개발자모드를 통해 웹페이지 접속하면 다음과 같이 웹앱 로그 확인 및 디버깅 설정이 가능합니다. 7-5 7-6

용어정리

  • adb : Android ADB (Android Debug Bridge)는 PC와 스마트 폰 간에 통신을 할 수 있는 명령어 도구입니다.
  • USB 디버깅 : USB로 기가지니 단말과 개발 PC를 연결하면 자동으로 연결됩니다.
  • Ethernet 디버깅 : 원격연결을 위한 설정으로 USB 연결없이 IP주소를 통한 연결이 가능합니다.

참고

  • 단말의 IP주소는 다음과 같이 확인이 가능합니다. 7-7

    adb 사용

  • 다운받은 platform-tools 폴더에서 바로 사용하거나 환경변수 설정을 통해 사용 가능합니다. 7-8

환경변수 설정

  • Windows
    [검색]에서 고급 시스템 설정을 검색하여 선택합니다.
    환경 변수를 누릅니다.
    시스템 변수 섹션에서 PATH 환경 변수를 찾아 선택합니다.
    편집을 누릅니다.
    PATH 환경 변수가 존재하지 않을 경우 새로 만들기를 누릅니다.
    시스템 변수 편집(또는 새 시스템 변수) 창에서 PATH 환경 변수의 값(platform-tools 폴더 위치 - ex. C:\Users\abc\Downloads\platform-tools)을 지정합니다.
    명령 프롬프트 창을 다시 열고 adb 명령어(adb devices, adb connect ...)를 입력합니다.
  • Linux/Mac
    .bash_profile 파일에 path 입력
    export PATH=$PATH:{platform-tools 설치 위치}(ex. export PATH=$PATH:/Users/{사용자}/Library/Android/sdk/platform-tools/)
    저장 후 다음 명령어 입력
    source ./bash_profile
    명령 프롬프트 창을 다시 열고 adb 명령어(adb devices, adb connect ...)를 입력합니다. 7-9