Wear OS 앱 디버그

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

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

시계에서 개발자 옵션 사용

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

  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. 시계와 개발 머신을 동일한 네트워크에 연결합니다.

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