Wear OS 앱 디버그

Wear OS 앱을 디버그하기 위해, 이 페이지에 설명된 대로 Wi-Fi 또는 블루투스를 통해 개발용 컴퓨터를 시계에 연결할 수 있습니다. 시계에 USB 포트가 있는 경우 USB를 통해 연결할 수 있습니다.

다음 관련 리소스를 참조하세요.

시계에서 개발자 옵션 사용

시계에서 디버그하려면 먼저 개발자 옵션을 사용 설정해야 합니다. 이 작업은 한 번만 실행하면 됩니다. 개발자 옵션은 중지할 때까지 사용 설정된 상태로 유지됩니다.

  1. 시계의 설정을 엽니다.
  2. 시스템 > 정보를 탭합니다.
  3. 빌드 번호로 스크롤한 다음, 빌드 번호를 7번 탭합니다.
  4. 이제 개발자임을 확인하는 대화상자가 나타납니다.

Wi-Fi를 사용하여 디버그

시작하기 전에 시계에서 개발자 옵션을 사용 설정했는지 확인합니다.

시계를 Wi-Fi 네트워크에 연결

  1. 시계의 설정을 엽니다.
  2. 연결 > Wi-Fi를 탭합니다.
  3. 네트워크를 선택하고, 필요한 경우 비밀번호를 입력합니다.

    참고: 시계와 개발용 컴퓨터를 동일한 네트워크에 연결해야 합니다. 모든 액세스 포인트가 적합한 것은 아닙니다. adb를 지원하도록 방화벽이 올바르게 구성된 액세스 포인트를 사용해야 할 수도 있습니다.

Wi-Fi 디버깅 사용

  1. 시계의 설정을 엽니다.
  2. 개발자 옵션 > Wi-Fi를 통한 디버그를 탭합니다.
  3. 잠시 후 화면에 시계의 IP 주소(예: 192.168.1.100)가 표시됩니다. 다음 단계에서 이 주소가 필요하므로 적어 둡니다.

디버거를 시계에 연결

  1. 시계와 개발용 컴퓨터가 동일한 네트워크에 연결되어 있는지 확인합니다.
  2. 시계의 IP 주소를 사용하여 디버거를 시계에 연결합니다. 예를 들어 IP 주소가 192.168.1.100이면, adb connect 명령과 응답은 다음과 같습니다(포트 번호 5555가 주소에 추가됨).

        adb connect 192.168.1.100
        connected to 192.168.1.100:5555
        

이제 시계가 디버거에 연결되었으며, 디버깅을 시작할 수 있습니다. -s 플래그를 사용하고 포트 번호를 포함해서 시계의 IP 주소를 지정하여 adb 명령을 시계로 전송합니다.

    adb -s 192.168.1.100:5555 <command>
    

에뮬레이터를 사용하지 않고 디버그할 기기 하나만 연결된 경우에는 주소를 지정할 필요가 없습니다.

    adb <command>
    

블루투스를 통해 디버그

블루투스 디버깅은 Android와 페어링된 시계에서만 작동합니다. 시작하기 전에 시계와 휴대전화가 페어링되어 있고 시계에서 개발자 옵션을 사용 설정했는지 확인합니다. 휴대전화에서도 개발자 옵션을 사용 설정했는지 확인해야 합니다. 확인하려면 휴대전화의 설정 메뉴를 열고 휴대전화 정보를 선택한 다음, 빌드 번호를 7번 클릭합니다.

휴대전화에서 USB 디버깅 사용

  1. 휴대전화의 설정 메뉴를 엽니다.
  2. 개발자 옵션을 선택하고 USB 디버깅을 사용 설정합니다.

시계에서 ADB/블루투스 디버깅 사용

  1. 시계의 설정 메뉴를 엽니다.
  2. 개발자 옵션으로 스크롤합니다.
  3. ADB 디버깅이 사용 설정되었는지 확인합니다.
  4. 블루투스를 통한 디버그를 사용 설정합니다.

휴대전화에서 블루투스 디버깅 사용

  1. 휴대전화에서 Wear 호환 앱을 엽니다.
  2. 고급 설정까지 아래로 스크롤한 다음 탭하여 고급 설정 옵션을 봅니다.
  3. 블루투스를 통한 디버깅을 사용 설정합니다. 옵션 아래에 상태 메시지가 나타납니다. 다음 그림과 같습니다.
        Host: disconnected
        Target: connected
        

이 시점에는 개발용 컴퓨터(호스트)가 시계(타겟)와 통신하지 않습니다. 링크를 완료해야 합니다.

참고: 한 번에 하나의 기기에서만 디버그할 수 있습니다. 여러 개의 시계가 페어링되어 있는 경우, 기본 화면에서 선택한 기기에서만 블루투스 디버깅이 사용됩니다.

디버거를 시계에 연결

이 최종 단계에서는 디버거, 휴대전화, 시계를 모두 사용합니다.

  1. USB 케이블을 사용해 휴대전화를 개발용 컴퓨터에 연결합니다.
  2. 디버거에서 다음 두 명령을 실행합니다.
        adb forward tcp:4444 localabstract:/adb-hub
        adb connect 127.0.0.1:4444
        

    참고: IP 주소 127.0.0.1을 사용해야 합니다. 개발용 컴퓨터에서 사용 가능한 모든 포트를 사용할 수 있습니다. 두 명령에서 동일한 포트를 사용해야 합니다. 이 예제에서 포트는 4444입니다.

  3. connect 명령을 입력한 후 시계를 봅니다. ADB 디버깅을 허용하는지 확인하는 메시지가 표시됩니다.
  4. 휴대전화로 돌아가서 Wear 호환 앱의 상태 표시를 확인합니다. 다음과 같이 나타납니다.
        Host: connected
        Target: connected
        
  5. 이제 시계가 디버거에 연결되었으며, 디버깅을 시작할 수 있습니다.

블루투스를 사용해 시계를 디버그하는 경우, adb는 항상 IP 주소 127.0.0.1과 할당된 포트를 사용합니다. 따라서 모든 adb 명령은 이 형식을 사용합니다(예제를 계속 진행하면 포트는 4444임).

adb -s 127.0.0.1:4444 <command> 

에뮬레이터를 사용하지 않고 디버그할 기기 하나만 연결된 경우에는 주소를 지정할 필요가 없습니다.

    adb <command>
    

Wear에 대해 screenrecord 사용

macOS®로 개발하는 경우, Mac용 Android 도구인 GitHub 프로젝트를 사용하여 Wear 기기에서 동영상을 녹화할 수 있습니다.

또는 다음 단계에 따라 Wear 기기에서 동영상을 녹화할 수 있습니다.

  1. 시계에서 원시 프레임을 녹화합니다.
    adb shell screenrecord --time-limit 30 --output-format raw-frames --verbose /sdcard/video.raw
  2. 원시 파일을 개발용 컴퓨터에 복사합니다.
    adb pull /sdcard/video.raw video.raw
  3. ffmpeg를 사용하여 원시 파일을 MP4로 변환합니다.
    ffmpeg -f rawvideo -vcodec rawvideo -s 400x400 -pix_fmt rgb24 -r 10 -i video.raw -an -c:v libx264 -pix_fmt yuv420p video.mp4

    참고: 다운로드 및 설치 안내는 FFmpeg 웹사이트를 참조하세요.