이 페이지는 Cloud Translation API를 통해 번역되었습니다.

Wear OS 앱 디버그

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

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

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

시계에서 개발자 옵션 사용

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

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

Wi-Fi를 사용하여 디버그

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

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

시계의 설정을 엽니다.
연결 > Wi-Fi를 탭합니다.
네트워크를 선택하고, 필요한 경우 비밀번호를 입력합니다.
참고: 시계와 개발 머신을 동일한 네트워크에 연결해야 합니다. 모든 액세스 포인트가 적합한 것은 아닙니다. adb를 지원하도록 방화벽이 올바르게 구성된 액세스 포인트를 사용해야 할 수도 있습니다.

Wi-Fi 디버깅 사용

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

디버거를 시계와 페어링

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

페어링이 완료되면 Wear OS 기기의 무선 디버깅 화면의 페어링된 기기 목록에 호스트 컴퓨터가 표시됩니다.

디버거를 시계에 연결

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

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

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

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

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

휴대전화에서 Wear OS 호환 앱을 엽니다.
고급 설정까지 스크롤한 후 탭하여 고급 설정 옵션을 확인합니다.
블루투스를 통해 디버깅을 사용 설정합니다. 다음 상태 메시지가 옵션 아래에 표시됩니다.
```
Host: disconnected
Target: connected
```

이 시점에서는 개발 머신(호스트)이 시계(타겟)와 통신하지 않습니다. 연결을 완료해야 합니다.

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

디버거를 시계에 연결

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

USB 케이블을 사용해 휴대전화를 개발 머신에 연결합니다.
디버거에서 다음 두 명령어를 실행합니다.
```
adb forward tcp:4444 localabstract:/adb-hub
adb connect 127.0.0.1:4444
```
참고: IP 주소 127.0.0.1을 사용해야 합니다. 개발 머신에서 사용 가능한 포트를 사용하고 두 명령어에 모두 동일한 포트를 사용합니다. 이 예에서 포트는 4444입니다.
connect 명령어를 입력하면 시계에서는 ADB 디버깅을 허용하는지 확인하라는 메시지를 표시합니다.
휴대전화에서 Wear OS 호환 앱의 상태 표시가 다음과 같은지 확인합니다.
```
Host: connected
Target: connected
```

이제 시계가 디버거에 연결되었으며 디버깅을 시작할 수 있습니다.

블루투스를 사용하여 시계를 디버그하는 경우 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 기기에서 동영상을 녹화하세요.

시계에서 RAW 프레임을 녹화합니다.

adb shell screenrecord --time-limit 30 --output-format raw-frames --verbose /sdcard/video.raw

RAW 파일을 개발 머신에 복사합니다.
```
adb pull /sdcard/video.raw video.raw
```
ffmpeg를 사용하여 RAW 파일을 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 웹사이트를 참고하세요.

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

Wear OS 앱 디버그

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

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

시계에서 개발자 옵션 사용

Wi-Fi를 사용하여 디버그

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

Wi-Fi 디버깅 사용

디버거를 시계와 페어링

디버거를 시계에 연결

블루투스를 통해 디버그

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

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

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

디버거를 시계에 연결

Wear OS용 화면 녹화 사용