'adb'은(는) 내부 또는 외부 명령이 아닙니다 오류 해결 방법
adb 실행 시 나오는 "'adb'은(는) 내부 또는 외부 명령…이 아닙니다"와 "adb: command not found" 오류를 해결해요. 윈도우, macOS, 리눅스에서 platform-tools를 설치하고 adb를 PATH에 추가하는 방법을 정리했어요.
adb devices를 입력했더니 윈도우가 이렇게 답해요.
'adb'은(는) 내부 또는 외부 명령, 실행할 수 있는 프로그램, 또는
배치 파일이 아닙니다.영어 윈도우에서는 다음과 같아요.
'adb' is not recognized as an internal or external command,
operable program or batch file.PowerShell에서는 adb : The term 'adb' is not recognized..., macOS나 리눅스에서는 adb: command not found라고 나와요. 모두 같은 뜻이에요. 컴퓨터가 adb 프로그램을 찾지 못한다는 거예요. 설치되어 있지 않거나, adb가 있는 폴더가 PATH에 없는 경우예요.
1단계: platform-tools 받기
ADB는 구글이 무료로 배포하는 Android SDK Platform-Tools 패키지에 들어 있어요.
- 안드로이드 개발자 공식 사이트에서 사용하는 시스템용 Platform-Tools를 내려받으세요.
- 옮기지 않을 위치에 압축을 푸세요. 예를 들어 윈도우는
C:\platform-tools, macOS와 리눅스는~/platform-tools예요.
Android Studio를 설치했다면 이미 있어요. 보통 윈도우는 %LOCALAPPDATA%\Android\Sdk\platform-tools, macOS는 ~/Library/Android/sdk/platform-tools에 있어요.
아무것도 바꾸지 않고 바로 테스트
platform-tools 폴더 안에서 터미널을 열고 그곳에서 adb를 실행하세요.
- 윈도우 명령 프롬프트:
cd C:\platform-tools다음에adb devices - 윈도우 PowerShell:
cd C:\platform-tools다음에.\adb devices(PowerShell은.\가 필요해요) - macOS / 리눅스:
cd ~/platform-tools다음에./adb devices
이렇게 하면 동작한다면 adb는 문제없고 PATH만 빠져 있는 거예요.
2단계: 윈도우에서 platform-tools를 PATH에 추가
- 시작을 누르고 환경 변수를 입력한 다음 시스템 환경 변수 편집(Edit the system environment variables)을 여세요.
- 환경 변수...(Environment Variables...)를 클릭하세요.
- 사용자 변수(User variables)에서 Path를 고르고 편집을 클릭하세요.
- 새로 만들기를 클릭하고
C:\platform-tools(실제 폴더)를 입력하세요. - 모든 창에서 확인을 클릭하세요.
- 터미널을 닫았다가 다시 여세요. 이미 열려 있던 창은 예전 PATH를 그대로 써요.
adb version으로 확인하세요.
2단계: macOS와 리눅스에서 platform-tools를 PATH에 추가
~/.zshrc(macOS)나 ~/.bashrc(대부분의 리눅스 배포판)에 다음 줄을 추가하세요.
export PATH="$HOME/platform-tools:$PATH"새 터미널을 열거나 source ~/.zshrc를 실행한 뒤 adb version으로 확인하세요. macOS에서는 Homebrew(brew install --cask android-platform-tools)로, 데비안이나 우분투에서는 sudo apt install adb로 설치할 수도 있어요.
adb가 여러 개 있을 때
폰 관리 프로그램, 에뮬레이터, 오래된 SDK는 자체 adb를 함께 설치하는 경우가 많아요. 새 adb를 설치했는데도 adb version이 예전 버전을 보여 준다면, 다른 복사본이 PATH에서 먼저 잡히는 거예요. 윈도우에서는 where adb가 모든 복사본을 순서대로 보여 줘요. macOS와 리눅스에서는 which -a adb를 쓰세요. 예전 폴더를 PATH에서 지우거나 새 폴더를 맨 위로 옮기세요. 버전이 섞여 있는 것은 기기가 offline으로 표시되는 흔한 원인이기도 해요.
ADBKit으로 설정 건너뛰기
일상적인 ADB 작업만 필요하다면 컴퓨터에 adb가 없어도 돼요. ADBKit은 Chrome이나 Edge 안에서 USB로 ADB를 실행해요. 실시간 화면, 키보드 입력, logcat, shell, 파일 전송, APK 설치를 설치 없이, PATH 추가 없이 쓸 수 있어요. 소프트웨어를 설치할 수 없는 회사 노트북이라면 이게 가장 쉬운 방법인 경우가 많아요.
adb가 동작하면 다음으로 USB 디버깅을 켜고 ADB 명령어 모음을 가까이 두세요.