# Android 기기에서의 디버깅

> Debug your application on an Android device via a USB or wireless connection.

Unity는 Android 기기에서 애플리케이션을 디버깅하는 다음의 방법을 지원합니다.

* [USB 디버깅](#usb-debugging)
* [Android 디버그 브리지](#android-debug-bridge)를 통한 유선 및 무선 연결

## USB 디버깅##usb-debugging

Unity는 Android 기기용 USB 디버깅을 지원합니다. USB 디버깅을 사용하려면 기기에서 개발자 옵션을 활성화합니다. 이렇게 하려면 Android의 [개발자 옵션 설정](https://developer.android.com/studio/debug/dev-options) 기술 자료를 참조하십시오.

USB 케이블을 사용하여 기기를 컴퓨터에 연결합니다. Windows 컴퓨터에서 개발하는 경우 기기별 USB 드라이버를 설치해야 할 수 있습니다. 자세한 내용은 기기 제조업체의 웹사이트를 참조하십시오.

설정 프로세스는 Windows와 macOS에서 다릅니다. Android 기기를 SDK에 연결하는 방법에 대한 자세한 내용은 Android 개발자 기술 자료의 [앱 실행](https://developer.android.com/studio/run/device) 섹션을 참조하십시오.

## Android 디버그 브리지##android-debug-bridge

Unity는 Android 기기용 USB 및 무선 연결을 통한 ADB(Android 디버그 브리지)를 지원합니다. 무선 연결은 USB 디버깅을 수행할 수 없거나, 컨트롤러가 Android 기기에 연결되었거나, VR 애플리케이션을 디버깅하고 Android 기기를 VR 키트에 삽입할 때 유용합니다.

### USB를 통해 연결##connect-via-usb

USB를 사용하여 ADB를 통해 Android 기기를 Unity에 연결하려면 다음을 수행합니다.

1. 기기에서 ADB를 활성화합니다. 이를 수행하는 방법에 대한 자세한 내용은 [개발을 위한 기기 설정](https://developer.android.com/studio/run/device#setting-up)을 참조하십시오.
2. USB 케이블을 사용하여 Android 기기를 Unity를 실행하는 머신에 연결합니다.
3. **File** > **Build Profiles**로 이동합니다.
4. Android 빌드 프로파일을 선택하거나 추가합니다.
5. **Run Device** 빌드 설정의 사용 가능한 옵션에서 기기를 선택합니다. 기기가 표시되지 않으면 **Refresh**를 클릭합니다.
6. 애플리케이션을 빌드하고 기기에서 실행하려면 **Build And Run**을 선택합니다.

### 무선으로 연결##connect-wirelessly

ADB를 통해 Android 기기를 Unity에 무선으로 연결하려면 다음을 수행합니다.

1. 기기에서 무선 ADB를 활성화합니다. 자세한 방법은 [Wi-Fi를 사용하여 기기에 연결](https://developer.android.com/studio/run/device#wireless)을 참조하십시오.
2. 기기의 IP 주소를 찾습니다. 이 프로세스는 기기 제조업체에 따라 다릅니다.
3. **File** > **Build Profiles**로 이동합니다.
4. Android 빌드 프로파일을 선택하거나 생성합니다.
5. **Run Device** 빌드 설정에서 **\<Enter IP>** 옵션을 선택합니다.
6. 열리는 창에서 기기의 IP 주소와 포트 번호를 입력합니다. 기기의 포트 번호가 `5555`이면 입력할 필요가 없습니다.
7. **Add**를 선택합니다. Unity가 기기에 연결하면 기기 이름이 **Run Device** 목록에 표시되고 선택됩니다.
8. 애플리케이션을 빌드하고 기기에서 실행하려면 **Build And Run**을 선택합니다.

## Android 로그 확인##view-android-logs

Android 기기에서 애플리케이션 빌드를 실행할 때 Android는 스크립트에서 스택 추적 및 [로그](/engine/6000.0/script-reference/unity-engine/debug/log.md)와 같은 메시지를 수집합니다. 이러한 메시지를 볼 수 있도록 Android는 [로그캣 커맨드 라인 툴](https://developer.android.com/studio/command-line/logcat)을 제공합니다. Unity 애플리케이션에서 이 툴을 사용하려면 다음 중 하나를 수행합니다.

* `logcat` 파라미터를 사용하여 ADB를 실행합니다.

  `$ adb logcat`
* 로그캣 커맨드 라인 툴을 구현하고 Unity 전용 창에 애플리케이션의 메시지를 표시하는 [Android Logcat](https://docs.unity3d.com/Packages/com.unity.mobile.android-logcat@latest/index.html) 패키지를 사용합니다.

자세한 내용은 [Android Logcat](https://docs.unity3d.com/Packages/com.unity.mobile.android-logcat@latest/index.html)을 참조하십시오.