ADB 설치 및 환경 설정

1. ADB란?

ADB(Android Debug Bridge)는 Android 기기와 컴퓨터 간의 통신을 가능하게 하는 명령줄 도구입니다. 이를 활용하면 앱을 설치하고, 로그를 확인하며, 시스템 파일을 조작하는 등 다양한 작업을 수행할 수 있습니다. 본 포스팅에서는 Windows, macOS, Linux에서 ADB를 설치하는 방법과 환경 설정 방법을 설명하겠습니다.

---

2. Windows, macOS, Linux에서 ADB 설치하기

2.1 Windows에서 ADB 설치

1. Android SDK Platform-Tools 다운로드 페이지에 접속합니다.
2. Windows용 Platform-Tools ZIP 파일을 다운로드합니다.
3. 다운로드한 ZIP 파일을 원하는 디렉토리에 압축 해제합니다.
4. 압축 해제한 디렉토리에 adb.exe가 포함되어 있는지 확인합니다.

2.2 macOS에서 ADB 설치

방법 1: Homebrew 사용

1. Homebrew가 설치되어 있다면 터미널을 열고 다음 명령어를 실행합니다.

   brew install android-platform-tools

2. 설치가 완료되면 다음 명령어를 입력하여 ADB가 정상적으로 설치되었는지 확인합니다.

   adb version

방법 2: 직접 다운로드

1. Android SDK Platform-Tools 다운로드 페이지에서 macOS용 Platform-Tools ZIP 파일을 다운로드합니다.
2. 다운로드한 ZIP 파일을 적절한 디렉토리에 압축 해제합니다.
3. 압축 해제한 폴더로 이동하여 adb 파일이 존재하는지 확인합니다.

2.3 Linux에서 ADB 설치

방법 1: 패키지 매니저 사용

Ubuntu 또는 Debian 계열:

sudo apt update
sudo apt install android-sdk-platform-tools

Fedora 계열:

sudo dnf install android-tools

Arch Linux 계열:

sudo pacman -S android-tools

방법 2: 직접 다운로드

1. Android SDK Platform-Tools 다운로드 페이지에서 Linux용 Platform-Tools ZIP 파일을 다운로드합니다.
2. 압축을 해제한 후, 해당 디렉토리에서 adb 명령어를 실행할 수 있도록 설정합니다.

---

3. ADB 환경 변수 설정 및 실행 확인

ADB 명령어를 터미널이나 명령 프롬프트에서 어디서든 실행하려면 환경 변수를 설정해야 합니다.

3.1 Windows에서 환경 변수 설정

1. ADB가 설치된 디렉토리(예: C:\platform-tools\)의 경로를 복사합니다.
2. 시스템 환경 변수 설정 창을 엽니다.
   • 윈도우 키 + R을 누르고 sysdm.cpl 입력 후 확인을 클릭합니다.
   • 고급 탭에서 환경 변수 버튼을 클릭합니다.
3. 시스템 변수 목록에서 Path를 선택하고 편집 버튼을 클릭합니다.
4. 새로 만들기를 클릭한 후 ADB가 설치된 디렉토리를 추가합니다.
5. 변경 사항을 저장하고 명령 프롬프트를 다시 열어 adb version 명령어를 실행하여 정상적으로 실행되는지 확인합니다.

3.2 macOS 및 Linux에서 환경 변수 설정

1. ADB가 설치된 디렉토리의 경로를 확인합니다.
2. 홈 디렉토리의 ~/.bashrc 또는 ~/.zshrc 파일을 편집합니다.

   nano ~/.bashrc  # 또는 nano ~/.zshrc (zsh 사용 시)

3. 다음 줄을 추가합니다.

   export PATH="$PATH:/your/path/to/platform-tools"

4. 변경 사항을 적용합니다.

   source ~/.bashrc  # 또는 source ~/.zshrc

5. adb version 명령어를 실행하여 정상적으로 동작하는지 확인합니다.

---

4. ADB 명령어 실행을 위한 USB 디버깅 활성화 방법

ADB 명령어를 실행하려면 Android 기기에서 USB 디버깅을 활성화해야 합니다.

1. Android 기기에서 설정 > 휴대전화 정보로 이동합니다.
2. 빌드 번호를 7번 연속으로 터치하여 개발자 옵션을 활성화합니다.
3. 설정 > 시스템 > 개발자 옵션으로 이동하여 USB 디버깅을 활성화합니다.
4. USB 케이블로 PC와 기기를 연결한 후 다음 명령어를 실행하여 정상적으로 인식되는지 확인합니다.

   adb devices

5. 연결된 기기가 device 상태로 표시되면 정상적으로 연결된 것입니다.

---

5. ADB over Wi-Fi 사용법

USB 케이블 없이 ADB를 사용하려면 ADB over Wi-Fi 기능을 활성화해야 합니다.

1. 먼저 USB 케이블로 Android 기기를 컴퓨터에 연결하고 다음 명령어를 실행하여 포트를 열어줍니다.

   adb tcpip 5555

2. Android 기기의 IP 주소를 확인합니다.
   • 설정 > 휴대전화 정보 > 상태 정보에서 IP 주소 확인
   • 또는 명령어 실행:

     adb shell ip -f inet addr show wlan0

3. 다음 명령어를 실행하여 Wi-Fi를 통해 ADB에 연결합니다.

   adb connect <device_ip_address>:5555

4. 연결 상태를 확인합니다.

   adb devices

   • IP 주소와 함께 device 상태가 표시되면 정상적으로 연결된 것입니다.
5. USB 케이블을 제거한 후에도 ADB 명령어를 사용할 수 있습니다.

---

6. 마무리

이제 ADB 설치 및 환경 설정을 완료하고, USB 디버깅 및 Wi-Fi 연결을 통해 기기를 제어하는 방법을 익혔습니다. 이를 활용하여 다양한 ADB 명령어를 실행할 수 있습니다.