Mac에서 ADB 및 Fastboot 설치·사용 가이드

무엇을 배우나요

macOS에 ADB와 Fastboot(Platform Tools) 설치 방법
Android 기기에서 개발자 옵션과 USB 디버깅 활성화 방법
터미널에서 기기 연결 확인 및 기본 ADB/Fastboot 명령 사용법
문제 해결 팁, 대체 방법, 역할별 체크리스트, 명령어 요약

사전 준비

macOS가 설치된 컴퓨터(버전 상관: Homebrew 또는 최신 macOS 권장)
Android 기기와 데이터 전송 가능한 USB 케이블
기기에서 개발자 옵션 및 USB 디버깅을 활성화할 권한
플랫폼 툴(ADB/Fastboot)을 다운로드할 디렉터리(예: 데스크탑)

중요: 루팅이나 부트로더 잠금 해제 등은 기기 보증을 무효화할 수 있습니다. 진행 전 필요한 데이터 백업을 권장합니다.

1. Android 기기에서 개발자 옵션과 USB 디버깅 활성화

설정 > 휴대폰 정보(About Phone)로 이동해 ‘빌드 번호(Build number)’ 항목을 찾아 5~7회 연속 탭합니다. 그러면 개발자 옵션이 활성화되었다는 메시지가 표시됩니다.

Android에서 개발자 옵션 활성화 화면

설정으로 돌아가서 ‘시스템 > 고급 > 개발자 옵션’(System > Advanced > Developer Options)을 엽니다.

안드로이드 개발자 옵션 메뉴 화면

‘USB 디버깅(USB Debugging)’을 찾아 토글을 켭니다. 연결 시 기기 화면에 ‘USB 디버깅 허용’ 대화상자가 뜹니다. ‘허용’을 눌러 ADB 연결을 승인하세요.

USB 디버깅 허용 대화상자 예시

2. macOS에 Platform Tools(ADB & Fastboot) 설치하기

옵션 A — 공식 플랫폼 툴 다운로드

Google의 Android SDK Platform Tools(공식 ADB/Fastboot 번들)를 다운로드합니다.
다운로드한 압축 파일을 더블클릭해 추출합니다. 추출된 폴더(예: Platform Tool)를 데스크탑이나 홈 디렉터리에 두면 편합니다.

옵션 B — Homebrew로 설치(간단한 관리)

Homebrew가 설치되어 있다면 터미널에서 다음을 실행합니다:

brew install --cask android-platform-tools

Homebrew 방식은 업데이트 및 제거가 간편합니다.

옵션 C — Android Studio 내 SDK Manager 사용

Android Studio를 이미 사용 중이라면 SDK Manager에서 ‘Android SDK Platform-Tools’를 설치할 수 있습니다. 이 방법은 SDK 및 에뮬레이터 작업을 병행하는 개발자에게 편리합니다.

3. macOS 터미널에서 기본 작업 흐름

기기를 USB로 Mac에 연결합니다.
기기 화면에서 ‘USB 디버깅 허용’을 탭하고, 개인용 컴퓨터라면 ‘이 컴퓨터에서 항상 허용’을 체크하세요.
터미널을 엽니다(Spotlight: command(⌘)+space 입력 후 Terminal 검색).

Mac에서 터미널 열기 화면

플랫폼 툴 폴더로 이동합니다. 예시:

cd /nikhilazza/admin/Desktop/Platform\ Tool

대신 cd 입력 후 폴더를 터미널 창으로 드래그해 경로를 자동으로 입력해도 됩니다.

Platform Tools 디렉터리에서 명령 실행 예시

연결 확인:

./adb devices

또는 Homebrew로 설치한 경우 adb devices만으로도 됩니다.

./adb devices

성공하면 다음처럼 연결된 기기 목록과 식별 코드가 표시됩니다.

adb devices 실행 결과 예시

연결된 기기 목록 예시

유용한 ADB 및 Fastboot 명령 요약(치트시트)

adb devices — PC와 기기 연결 확인
adb reboot recovery — 기기를 리커버리 모드로 재부팅
adb reboot-bootloader — 기기를 부트로더 모드로 재부팅
adb push [source] [destination] — 컴퓨터에서 기기로 파일 복사
adb pull [source] [destination] — 기기에서 컴퓨터로 파일 복사
adb shell [command] — 기기 내 셸을 열거나 명령 실행
fastboot oem unlock — 부트로더 잠금 해제(기기별 차이, 데이터 삭제)
fastboot flash recovery [image.img] — 커스텀 리커버리 이미지 플래시

사용 예시:

./adb push myfile.zip /sdcard/Download/
./adb pull /sdcard/Log.txt ~/Desktop/
./adb shell pm list packages
./fastboot flash boot boot.img

중요: fastboot 관련 명령은 기기가 부트로더 모드여야만 작동합니다. 부트로더 잠금 해제는 데이터 전부를 삭제할 수 있습니다.

대체 접근 방식 및 도구 비교

Homebrew 설치: 간편 설치/제거, 자동 업데이트 이점
Android Studio SDK: SDK 기반 통합 개발 환경을 이미 사용하는 개발자에게 권장
독립 플랫폼 툴 압축 해제: 오프라인 환경이나 특정 버전 고정이 필요한 경우 유리

간단 비교:

사용 편의성: Homebrew > SDK Manager > 수동 압축 해제
버전 통제: 수동 압축 해제 > SDK Manager > Homebrew

문제 해결(자주 발생하는 실패 사례와 해결법)

adb devices가 빈 목록만 반환할 때
- USB 케이블을 데이터 전송 가능한 것으로 교체하세요(일부 케이블은 충전 전용).
- 기기에서 USB 디버깅이 활성화되었는지 확인하세요.
- macOS에서 adb에 접근 권한 요구(보안/개인정보) 창이 떴는지 확인하고 허용하세요.
- ./adb kill-server 후 ./adb start-server로 서버 재시작해 보세요.
‘unauthorized’ 상태
- 기기 화면에서 디버깅 허용 팝업을 확인하고 허용하세요. 팝업이 보이지 않으면 케이블 재연결 또는 USB 설정(파일 전송 모드) 변경을 시도하세요.
fastboot 명령이 작동하지 않을 때
- 기기가 실제로 부트로더/fastboot 모드인지 확인하세요(제조사별 진입 방법 상이).
- mac에서 kext/드라이버 충돌이 있는 경우 시스템 재부팅을 시도하세요.
권한 문제(sudo가 필요한 경우)
- 일반적으로 adb/fastboot는 루트 권한 없이 동작하지만, 특정 디렉터리 작업이나 권한 문제 발생 시 sudo 사용을 고려하세요. (주의: 항상 명령 의미를 확인)

역할별 체크리스트

개발자

Platform Tools 최신 버전 설치
Android Studio와 연동된 SDK 확인
리커버리/부트로더 작업 전 백업 및 테스트 기기 준비

일반 사용자(파일 전송 등)

USB 디버깅 활성화
신뢰할 수 있는 컴퓨터에서만 ‘항상 허용’ 체크
간단한 adb push/pull 사용법 숙지

테스터/QA

adb shell을 통한 로그 수집 방법 숙지
adb logcat 필터링(앱 패키지 기준) 사용 연습

미니 방법론(핵심 단계 요약)

개발자 옵션 활성화 → USB 디버깅 켜기
Platform Tools 설치(또는 Homebrew 설치)
기기 연결 및 디버깅 허용
터미널에서 플랫폼 폴더로 이동 → adb devices로 연결 확인
필요한 adb/fastboot 명령 실행

간단 용어집(한 줄 정의)

ADB: Android Debug Bridge — 기기와 PC 간의 명령/파일 전송 브리지
Fastboot: 부트로더와 통신해 파티션을 플래시하거나 부트 관련 작업을 수행하는 도구
Platform Tools: ADB와 Fastboot를 포함한 구글의 공식 툴 모음

보안 및 권고 사항

신뢰하지 않는 컴퓨터에서는 ‘항상 허용’ 옵션을 사용하지 마세요.
부트로더 잠금 해제(fastboot oem unlock 등)는 기기 데이터를 모두 삭제할 수 있으며, 일부 제조사는 보증을 무효화할 수 있습니다.
민감한 개인 데이터가 있는 경우 명령 실행 전 백업을 권장합니다.

마무리 요약

이 가이드를 따라하면 macOS에서 ADB와 Fastboot를 설치하고 Android 기기와 연결하여 기본적인 디버깅, 파일 전송, 재부팅 및 플래시 작업을 수행할 수 있습니다. 문제가 발생하면 위의 문제 해결 절차를 따르세요. 더 복잡한 작업(루팅, 커스텀 리커버리 설치, 부트로더 잠금 해제 등)은 기기별 문서를 먼저 확인하고 충분히 백업한 뒤 진행하시기 바랍니다.

감사합니다. 질문이나 추가 요청(특정 기기 가이드, 스크립트 예시 등)이 있으면 아래 댓글로 남겨 주세요.

Mac에서 ADB 및 Fastboot 설치 및 사용법