ADB 기본 명령어 정리

1. ADB란?

ADB(Android Debug Bridge)는 Android 기기와 PC를 연결하여 다양한 디버깅 및 개발 작업을 수행할 수 있도록 도와주는 도구입니다. 이를 활용하면 앱을 설치하거나, 로그를 확인하고, 파일을 전송하는 등의 작업을 손쉽게 수행할 수 있습니다.

ADB는 Android SDK에 포함되어 있으며, 개발자는 이를 통해 기기를 원격으로 조작할 수 있습니다. 이번 글에서는 ADB의 기본적인 명령어들을 정리하고, 각각의 사용법을 설명하도록 하겠습니다.

---

2. ADB 기본 명령어

2.1 ADB 버전 확인

adb version

ADB가 정상적으로 설치되었는지 확인하려면 위 명령어를 실행합니다. 실행하면 현재 설치된 ADB의 버전이 출력됩니다.

예제 실행 결과:

Android Debug Bridge version 34.0.3-10161052
Version 1:8.1.0+r23-5
Installed as /usr/bin/adb

이와 같은 결과가 출력되면 ADB가 정상적으로 동작하는 것입니다.

---

2.2 연결된 기기 목록 확인

adb devices

현재 PC에 연결된 Android 기기 목록을 확인하는 명령어입니다. USB 또는 네트워크를 통해 연결된 모든 기기가 표시됩니다.

예제 실행 결과:

List of devices attached
R3CNA0W8V5  device
emulator-5554  device

위 결과에서 R3CNA0W8V5는 실제 기기이며, emulator-5554는 에뮬레이터를 의미합니다.

만약 unauthorized 상태가 표시된다면, 기기의 USB 디버깅을 활성화하고 PC에서 ADB 연결을 허용해야 합니다.

---

2.3 ADB 서버 재시작

adb kill-server
adb start-server

ADB 서버가 비정상적으로 동작하거나 기기가 제대로 인식되지 않을 때, ADB 서버를 재시작하면 문제를 해결할 수 있습니다.

실행 과정:

1. adb kill-server로 ADB 서버를 종료합니다.
2. adb start-server로 ADB 서버를 다시 시작합니다.
3. adb devices를 실행하여 정상적으로 연결되었는지 확인합니다.

---

2.4 USB 및 네트워크 디버깅 전환

(1) USB 디버깅 모드 설정

adb usb

기본적으로 ADB는 USB를 통해 연결됩니다. 위 명령어를 실행하면 USB 디버깅 모드로 전환됩니다.

(2) 네트워크 디버깅 모드 설정

adb tcpip 5555

기기를 네트워크를 통해 연결하고 싶을 때 사용하는 명령어입니다. 5555는 포트 번호이며, 다른 포트로 변경할 수도 있습니다.

실행 과정:

1. USB로 기기를 연결한 상태에서 adb tcpip 5555를 실행합니다.
2. USB 케이블을 제거하고 네트워크를 통해 기기를 연결할 준비를 합니다.

---

2.5 네트워크를 통한 ADB 연결

adb connect <IP>:5555

USB 없이 네트워크를 통해 기기를 연결하려면 위 명령어를 사용합니다. 여기서 <IP>는 Android 기기의 IP 주소이며, 5555는 포트 번호입니다.

예제 실행:

adb connect 192.168.1.100:5555

예제 실행 결과:

connected to 192.168.1.100:5555

이제 ADB 명령어를 사용하여 기기를 조작할 수 있습니다.

---

3. 추가적인 확인 방법

ADB가 정상적으로 동작하는지 확인하기 위해 다음과 같은 추가 명령어들을 사용할 수 있습니다.

3.1 ADB 쉘 실행

adb shell

Android 기기의 터미널에 직접 접근할 수 있으며, 다양한 시스템 명령어를 실행할 수 있습니다.

예제 실행:

adb shell
$ ls /sdcard

이렇게 하면 내부 저장소의 파일을 직접 확인할 수 있습니다.

3.2 ADB 로그 확인

adb logcat

앱 실행 중 발생하는 로그를 실시간으로 확인할 수 있습니다. 디버깅 과정에서 매우 유용하게 활용됩니다.

---

4. 마무리

이번 글에서는 ADB의 기본적인 명령어에 대해 정리해 보았습니다. ADB는 Android 개발 및 디버깅에 필수적인 도구이며, 기본적인 사용법을 익히면 다양한 작업을 효율적으로 수행할 수 있습니다.