Unity Android 디버깅 가이드
이 문서는 Unity에서 Android 기기를 디버깅하는 방법을 설명합니다. 안드로이드 애플리케이션의 디버깅 및 테스트를 위한 다양한 방법과 설정을 다루고 있습니다.
USB 디버깅
Unity는 USB 디버깅을 통해 Android 기기에서 애플리케이션을 디버깅하는 것을 지원합니다. USB 디버깅을 사용하기 위해서는 먼저 개발자 옵션을 활성화해야 합니다.
개발자 옵션 활성화 방법
- Android 기기에서 설정을 엽니다.
- ‘About phone’을 선택하고, ‘Build number’를 여러 번 탭하여 개발자 모드를 활성화합니다.
- ‘Developer options’ 메뉴로 돌아가서 USB 디버깅을 활성화합니다.
USB 연결하기
- USB 케이블을 사용해 Android 기기를 컴퓨터에 연결합니다.
- Windows에서 필요한 USB 드라이버를 설치합니다.
- Unity에서 "Build Settings"를 열고 "Run Device" 드롭다운에서 해당 기기를 선택합니다.
Android 디버그 브리지(ADB)
ADB를 통해 USB 또는 무선으로 Android 기기를 Unity와 연결할 수 있습니다.
USB를 통한 ADB 연결
- Android 기기에서 ADB를 활성화합니다.
- USB 케이블을 사용하여 기기를 Unity가 실행되고 있는 머신에 연결합니다.
- Unity에서 Build Settings를 열고, 기기를 선택합니다.
무선 ADB 연결
- Android 기기에서 ADB를 활성화합니다.
- 기기의 IP 주소를 찾아야 합니다. 방법은 기기 제조업체의 문서를 참조하세요.
- Unity에서 Build Settings를 열고 "Run Device"에서 "Enter IP"를 선택 후 IP 주소와 포트 번호를 입력합니다.
Android 로그 확인
애플리케이션 빌드를 실행할 때 Android는 스택 추적 및 스크립트 로그를 수집합니다. 이러한 로그를 확인하려면 다음 방법 중 하나를 사용할 수 있습니다.
- ADB를 통해 logcat 명령어 실행:
csharp $ adb logcat - Android Logcat 패키지를 사용하여 Unity 전용 창에 애플리케이션 로그를 표시합니다.
유용한 예제
| 항목 | 설명 |
|---|---|
| USB 디버깅 | USB를 통해 Android 기기를 연결하여 디버깅을 진행합니다. |
| 무선 디버깅 | Wi-Fi를 통해 ADB 연결을 설정하여 USB 없이도 디버깅합니다. |
| Logcat | 빌드 실행 시 스크립트 로그 및 에러 메시지를 확인합니다. |
참고 사항
- USB 디버깅을 활성화한 후, 문제가 발생할 경우 USB 드라이버를 확인하세요.
- ChromeOS 기기는 USB 디버깅을 지원하지 않으므로 무선 연결 방법을 사용해야 합니다.
이 문서는 Unity와 Android 디버깅에 대해 간단하게 설명하였으며, 활용에 도움이 되기를 바랍니다.