[Android] adb 명령어 실행 방법 (adb: command not found 문제 해결법)

adb 명령어 실행 방법 (adb: command not found 문제 해결법)

들어가며

• 터미널에 @adb@ 관련 명령을 실행했을 때 다음과 같은 오류가 발생할 경우 해결하는 방법을 정리해본다.

$ adb --version

bash: adb: command not found

 

 

ADB(Android Debug Bridge)

개념

• 안드로이드 기기와 컴퓨터 간의 연결을 관리하고 디버깅 작업을 수행할 수 있게 해주는 명령줄(CLI) 도구
• 안드로이드 개발 과정에서 필수적으로 사용되며, 아래와 같은 작업에 사용된다.

☑️ 안드로이드 기기와의 통신
☑️ 앱 설치 및 테스트
☑️ 디버깅 
☑️ 파일 전송 
☑️ 쉘 명령 실행
☑️ 포트 포워딩

• ADB는 Android SDK에 포함되어 있으며, 안드로이드 스튜디오(Android Studio)를 설치하면 자동으로 함께 설치된다.
• 리액트 네이티브(React Native) 엑스포(Expo) 에서는 안드로이드 앱을 디버깅하거나 에뮬레이터에서 앱을 실행할 때 ADB를 사용하여 연결을 관리한다.

 

문제 해결 방법

• 안드로이드 스튜디오(Android Studio)를 설치하면 ADB는 자동으로 함께 설치된다.
• 따라서 터미널에서 @adb@ 명령을 실행하면 실행이 되어야 하지만, 만약 실행이 안될 경우 아래와 같이 환경 변수를 추가해준다.

 

Windows

• [환경 변수]의 [시스템 변수]에서 @Path@ 항목을 선택하고 아래의 경로를 추가해준다.

C:\Users\<사용자명>\AppData\Local\Android\Sdk\platform-tools

환경 변수 > 시스템 변수 > Path 환경 변수 편집 > 새로 만들기

 

MacOS / Linux

• 터미널에서 환경 설정 파일을 연 후, 아래와 같이 작성해준다.
  • macOS : @~/.zshrc@ 또는 @~/.bash_profile@
  • Linux : @~/.bashrc@ 또는 @~/.profile@

export ANDROID_HOME=/<SDK 경로>
export PATH=$ANDROID_HOME/platform-tools:$PATH

 

• 파일을 저장하고 터미널에서 설정을 적용시킨다.

source ~/.zshrc     # macOS (zsh)
source ~/.bashrc    # Linux 또는 bash

 

• 이제 @adb@ 명령이 실행되는 것을 확인할 수 있다.

adb 명령이 실행되는 모습

 

참고 사이트

Android 디버그 브리지(adb)  |  Android Studio  |  Android Developers

adb command not found