adb devices에 기기가 보이지 않아요.

기기에서 USB 디버깅이 켜져 있는지, USB 연결 시 "디버깅 허용" 팝업을 수락했는지 확인하세요. 그래도 안 되면 adb kill-server 후 adb start-server로 서버를 재시작하고, 윈도우는 제조사 USB 드라이버 설치가 필요할 수 있습니다.

무선으로 연결하려면 어떻게 하나요?

USB로 먼저 연결한 뒤 adb tcpip 5555 → adb connect 기기IP:5555 순서로 실행합니다. Android 11 이상은 개발자 옵션의 "무선 디버깅"에서 페어링 코드 방식(adb pair)으로 USB 없이도 연결할 수 있습니다.

adb는 어디서 설치하나요?

Google이 배포하는 SDK Platform-Tools에 포함되어 있습니다. 압축을 풀고 PATH에 추가하면 별도 설치 없이 바로 사용할 수 있습니다.

ADB 명령어 모음

연결·앱 설치·파일 전송·로그캣까지 핵심 명령어 정리

데이터는 서버로 전송되지 않습니다 — 모든 처리는 브라우저 안에서만 서버 전송 0건

연결·디바이스 확인

기기에서 개발자 옵션 → USB 디버깅을 먼저 활성화해야 합니다.

adb devices

연결된 디바이스 목록을 표시합니다
adb devices -l

모델명 등 상세 정보와 함께 목록을 표시합니다
adb -s 시리얼 shell

여러 대 연결 시 특정 디바이스를 지정해 명령을 실행합니다
adb tcpip 5555

USB로 연결된 기기를 무선(TCP/IP) 모드로 전환합니다
adb connect 192.168.0.10:5555

같은 네트워크의 기기에 무선으로 연결합니다
adb disconnect

무선 연결을 해제합니다
adb kill-server && adb start-server

ADB 서버를 재시작합니다 (기기 인식 오류 해결)
adb usb

무선 모드에서 USB 모드로 복귀합니다

앱 설치·관리

adb install app.apk

APK를 설치합니다
adb install -r app.apk

앱 데이터를 유지하며 재설치(업데이트)합니다
adb install -d app.apk

낮은 버전으로 다운그레이드 설치를 허용합니다
adb uninstall com.example.app

패키지명으로 앱을 제거합니다
adb shell pm list packages

설치된 전체 패키지 목록을 출력합니다
adb shell pm list packages -3

사용자가 설치한 앱만 출력합니다
adb shell pm clear com.example.app

앱의 데이터·캐시를 초기화합니다
adb shell pm path com.example.app

설치된 APK의 경로를 확인합니다
adb shell pm disable-user --user 0 패키지명

루팅 없이 시스템 앱을 비활성화합니다 (pm enable로 복구)

파일 전송

adb push local.txt /sdcard/

PC의 파일을 기기로 복사합니다
adb pull /sdcard/photo.jpg ./

기기의 파일을 PC로 가져옵니다
adb shell ls /sdcard/

기기 저장소의 파일 목록을 확인합니다

화면·입력 제어

adb shell screencap -p /sdcard/s.png

스크린샷을 기기 저장소에 저장합니다
adb exec-out screencap -p > screen.png

스크린샷을 PC로 바로 저장합니다
adb shell screenrecord /sdcard/demo.mp4

화면을 녹화합니다 (Ctrl+C 종료, 기본 최대 3분)
adb shell input tap 500 1200

지정 좌표를 터치합니다
adb shell input swipe 300 1000 300 200

좌표 간 스와이프합니다 (스크롤 자동화)
adb shell input text "hello"

텍스트를 입력합니다 (공백은 %s 로 표기)
adb shell input keyevent 26

키 이벤트를 보냅니다 (26=전원, 3=홈, 4=뒤로)

로그·디버깅

adb logcat

시스템 로그를 실시간으로 출력합니다
adb logcat -c

로그 버퍼를 비웁니다
adb logcat *:E

에러 레벨 이상의 로그만 출력합니다
adb logcat -d > log.txt

현재까지의 로그를 파일로 저장하고 종료합니다
adb logcat --pid=$(adb shell pidof -s 패키지명)

특정 앱의 로그만 필터링합니다
adb bugreport bug.zip

전체 진단 리포트를 zip으로 저장합니다
adb shell dumpsys battery

배터리 상태를 확인합니다
adb shell dumpsys activity top

현재 화면의 액티비티 정보를 확인합니다

시스템 정보·재부팅

adb shell getprop ro.build.version.release

안드로이드 버전을 확인합니다
adb shell getprop ro.product.model

기기 모델명을 확인합니다
adb shell wm size

화면 해상도를 확인합니다 (wm size 1080x1920 으로 변경)
adb shell wm density

화면 DPI를 확인합니다
adb reboot

기기를 재부팅합니다
adb reboot recovery

리커버리 모드로 재부팅합니다
adb reboot bootloader

부트로더(fastboot) 모드로 재부팅합니다
adb sideload update.zip

리커버리에서 OTA 업데이트 파일을 설치합니다

ADB 명령어 사용법

ADB(Android Debug Bridge)는 PC에서 안드로이드 기기를 제어하는 명령줄 도구입니다. 이 페이지는 연결·앱 관리·파일 전송·화면 제어·로그·시스템 여섯 갈래로 핵심 명령어를 정리했고, 복사 버튼으로 터미널에 바로 붙여넣을 수 있습니다.

앱 개발 중이라면 adb install -r 로 빠르게 재설치하고, adb logcat --pid 로 내 앱 로그만 필터링하는 조합을 가장 자주 쓰게 됩니다. 일반 사용자에게는 pm disable-user를 이용한 선탑재 앱 비활성화, screenrecord를 이용한 화면 녹화가 특히 유용합니다.

※ adb root, sideload 등 일부 명령은 기기·빌드에 따라 지원되지 않을 수 있습니다.

자주 묻는 질문

adb devices에 기기가 보이지 않아요.: 기기에서 USB 디버깅이 켜져 있는지, USB 연결 시 "디버깅 허용" 팝업을 수락했는지 확인하세요. 그래도 안 되면 adb kill-server 후 adb start-server로 서버를 재시작하고, 윈도우는 제조사 USB 드라이버 설치가 필요할 수 있습니다.
무선으로 연결하려면 어떻게 하나요?: USB로 먼저 연결한 뒤 adb tcpip 5555 → adb connect 기기IP:5555 순서로 실행합니다. Android 11 이상은 개발자 옵션의 "무선 디버깅"에서 페어링 코드 방식(adb pair)으로 USB 없이도 연결할 수 있습니다.
adb는 어디서 설치하나요?: Google이 배포하는 SDK Platform-Tools에 포함되어 있습니다. 압축을 풀고 PATH에 추가하면 별도 설치 없이 바로 사용할 수 있습니다.

ADB 명령어 사용법

자주 묻는 질문

관련 툴