Wear OS 앱 디버그

실제 시계에서 Wear OS 앱을 디버그하려면 Wi-Fi 또는 블루투스를 사용하여 개발 머신을 시계에 연결합니다. 또는 시계에 USB 포트가 있는 경우 USB를 통해 연결합니다.

앱에 이 지원이 필요한 경우 시계, 휴대전화와 같이 여러 기기에 걸쳐 있는 워크플로를 테스트할 수도 있습니다. 테스트를 위해 연결 설정하는 방법을 자세히 알아보려면 휴대전화에 시계 연결을 참고하세요.

참고: 실제 시계가 없다면 Android 스튜디오의 에뮬레이터에서 앱을 실행하고 테스트할 수도 있습니다.

최신 버전의 Wear OS로 업그레이드

앱이 최신 소프트웨어에서 예상대로 작동하는지 확인하려면 테스트 기기에서 기기가 지원하는 최신 버전의 Wear OS를 실행 중인지 확인합니다.

테스트 기기에서 시스템 업데이트를 확인하려면 다음 단계를 완료하세요.

  1. 기기를 Wi-Fi 네트워크에 연결합니다.
  2. 기기 충전을 시작합니다.
  3. 기기의 배터리가 50% 이상 충전될 때까지 기다립니다.
  4. 테스트 기기에서 설정 > 시스템 > 시스템 업데이트로 이동합니다.

    사용할 수 있는 시스템 업데이트가 있으면 테스트 기기에 다운로드되어 설치됩니다.

특정 버전의 Wear OS 설치(선택사항)

앱의 테스트 사례가 특정 버전의 Wear OS에 종속된 경우 USB 데이터 연결을 지원하는 시계에 소프트웨어 이미지를 플래시할 수 있습니다. 예를 들어 Google Pixel Watch 2에 공장 출고 시 이미지 또는 전체 OTA 이미지를 플래시할 수 있습니다.

시계에서 개발자 옵션 사용

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

  1. 시계의 설정을 엽니다.
  2. 시스템 > 정보 > 버전을 탭합니다.
  3. 빌드 번호 항목을 일곱 번 탭합니다.
  4. 이제 개발자임을 확인하는 메시지가 표시됩니다.

Wi-Fi를 사용하여 디버그

시작하기 전에 앞서 설명한 대로 시계에서 개발자 옵션을 사용 설정합니다.

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

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

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

Wi-Fi 디버깅 사용

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

디버거를 시계에 페어링

  1. Wear OS 기기의 시스템 설정에서 무선 디버깅 옵션을 찾습니다. 새 기기와 페어링을 선택합니다.
  2. Wi-Fi 페어링 코드IP 주소 및 포트를 확인합니다.
  3. 개발 머신의 터미널 창에서 다음 명령어를 입력합니다.
    adb pair IP_ADDRESS:PORT
    
  4. 메시지가 표시되면 2단계의 Wi-Fi 페어링 코드를 입력합니다. 단말기에 페어링 성공 여부가 출력됩니다. 예를 들면 다음과 같습니다.
    Enter pairing code: 123456
    Successfully paired to 192.168.1.100:5555
    
페어링하면 호스트 컴퓨터가 Wear OS 기기의 무선 디버깅 화면에 있는 페어링된 기기 목록에 표시됩니다.

디버거를 시계에 연결

  1. 시계와 개발 머신을 동일한 네트워크에 연결합니다.
  2. 시계의 IP 주소와 포트 번호를 사용하여 디버거를 시계에 연결합니다. 예를 들어 IP 주소가 192.168.1.100이고 포트 번호가 5555이면 adb connect 명령어와 그 응답은 다음과 같습니다.

    adb connect 192.168.1.100:5555
    connected to 192.168.1.100:5555
    

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

adb -s 192.168.1.100:5555 <command>

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

adb <command>

블루투스를 통해 디버그

참고: 블루투스 디버깅은 Wear OS 2를 실행하는 Android와 페어링된 시계에서만 작동합니다.

시작하기 전에 시계와 휴대전화를 페어링하고 앞서 설명한 대로 시계에서 개발자 옵션을 사용 설정합니다. 휴대전화의 설정 메뉴를 열고 개발자 옵션을 찾아 휴대전화에서 개발자 옵션이 사용 설정되어 있는지 확인합니다. 필요하다면 휴대전화에서 개발자 옵션을 사용 설정하세요.

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

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

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

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

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

  1. 휴대전화에서 Wear OS 호환 앱을 엽니다.
  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 OS 호환 앱의 상태 표시가 다음을 확인합니다.
    Host: connected
    Target: connected
    
  5. 이제 시계가 디버거에 연결되었으며 디버깅을 시작할 수 있습니다.

블루투스를 사용하여 시계를 디버그하는 경우 adb는 항상 IP 주소 127.0.0.1과 할당된 포트를 사용합니다. 이 예에서 포트는 4444입니다. 모든 adb 명령어는 다음 형식을 사용합니다.

adb -s 127.0.0.1:4444 <command> 

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

adb <command>

Wear OS용 화면 녹화 사용

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

또는 다음 단계에 따라 Wear OS 기기에서 동영상을 녹화하세요.

  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 웹사이트를 참고하세요.