Chromium 브라우저, Node.js, Electron에서 실행되며 WebUSB로 Android 기기에 연결하는 TypeScript 기반 ADB 클라이언트 재구현
mzlogin/awesome-adb
앱 설치, 파일 관리, 로그 조회, 기기 정보 확인에 사용하는 Android Debug Bridge(adb) 명령을 정리한 대규모 영한 참고 자료입니다.
- 스타
- 12,528
- 포크
- 2,288
- 열린 이슈
- 52
- 마지막 커밋
- 지난달
어떤 프로젝트인가요?
awesome-adb는 Android Debug Bridge(adb) 명령을 분류해 정리한 참고 자료입니다. Android 개발자와 테스터, 기기 애호가가 자주 마주치는 상황을 다룹니다. USB 또는 Wi-Fi로 기기 연결하기, APK 설치 및 제거, 패키지 목록 조회 및 비활성화, 앱 데이터 삭제, am 및 pm 도구로 액티비티나 서비스 실행하기 등이 포함됩니다.
연결 및 앱 관리 외에도 파일 푸시와 풀, input 명령으로 키 입력과 텍스트 입력을 시뮬레이션하는 방법, 레벨과 태그별 logcat 출력 필터링, 모델명·배터리·화면 밀도·CPU·메모리 같은 하드웨어 및 시스템 속성 확인 방법을 설명합니다. 자주 발생하는 APK 설치 오류 코드와 그 의미 및 권장 해결 방법도 정리하고, root 권한이 필요한 명령과 Android 버전 및 커스텀 ROM에 따라 달라지는 동작에 관한 참고 사항도 제공합니다.
콘텐츠는 목차가 포함된 Markdown 문서로 관리되며, README에서 영어 버전을 확인할 수 있습니다.
핵심 기능
- 01Android 11+ 무선 디버깅을 포함해 USB 및 Wi-Fi 기기 연결 방법을 다룹니다.
- 02일반적인 INSTALL_FAILED 오류 코드와 해결 방법을 정리한 표와 함께 설치 및 제거 명령을 제공합니다.
- 03pm으로 앱 패키지를 조회하고, 활성화 및 비활성화하고, 데이터를 삭제하는 방법을 설명합니다.
- 04일반적인 시스템 브로드캐스트 액션을 포함해 am으로 액티비티, 서비스, 브로드캐스트를 실행하는 방법을 설명합니다.
- 05키코드 참고 자료와 함께 input 명령으로 키 이벤트와 텍스트 입력을 시뮬레이션하는 방법을 설명합니다.
- 06레벨과 태그별 logcat 출력 필터링, 기기의 하드웨어 및 시스템 속성 확인 방법을 설명합니다.
활용 사례
- 실제 기기나 에뮬레이터에서 APK를 설치, 업데이트하거나 디버깅할 때.
- 여러 곳에 흩어진 자료를 검색하지 않고 특정 작업에 필요한 adb 명령을 찾아볼 때.
- 오류 코드를 권장 해결 방법과 대조해 APK 설치 실패 원인을 진단할 때.
- 테스트를 위해 키 이벤트를 보내거나 브로드캐스트를 트리거하는 등 기기 자동화 스크립트를 작성할 때.
빠른 시작
- 1
Android 기기를 USB로 연결하고 인식되는지 확인합니다
adb devices - 2
APK 파일에서 앱을 설치합니다
adb install <path_to_apk> - 3
설치된 서드파티 앱을 나열합니다
adb shell pm list packages -3
사용 전 알아둘 점
- 이 문서는 명령어 참고 자료이며 소프트웨어 도구가 아니므로 설치 가능한 프로그램이 없습니다.
- 일부 명령어는 Android 버전과 기기의 커스텀 ROM에 따라 달라집니다.
포함된 컬렉션
토픽
자주 묻는 질문
- awesome-adb은(는) 무엇인가요?
- 앱 설치, 파일 관리, 로그 조회, 기기 정보 확인에 사용하는 Android Debug Bridge(adb) 명령을 정리한 대규모 영한 참고 자료입니다. awesome-adb는 Android Debug Bridge(adb) 명령을 분류해 정리한 참고 자료입니다. Android 개발자와 테스터, 기기 애호가가 자주 마주치는 상황을 다룹니다. USB 또는 Wi-Fi로 기기 연결하기, APK 설치 및 제거, 패키지 목록 조회 및 비활성화, 앱 데이터 삭제, am 및 pm 도구로 액티비티나 서비스 실행하기 등이 포함됩니다.
- awesome-adb은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
- awesome-adb은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
- awesome-adb은(는) 아직 유지보수되고 있나요?
- 6개월 이내 업데이트. awesome-adb의 마지막 커밋은 2026년 9월 29일입니다.
- awesome-adb은(는) 어디에 사용할 수 있나요?
- 실제 기기나 에뮬레이터에서 APK를 설치, 업데이트하거나 디버깅할 때. 여러 곳에 흩어진 자료를 검색하지 않고 특정 작업에 필요한 adb 명령을 찾아볼 때. 오류 코드를 권장 해결 방법과 대조해 APK 설치 실패 원인을 진단할 때. 테스트를 위해 키 이벤트를 보내거나 브로드캐스트를 트리거하는 등 기기 자동화 스크립트를 작성할 때.
- awesome-adb는 어떻게 설치하나요?
- Android 기기를 USB로 연결하고 인식되는지 확인합니다: adb devices APK 파일에서 앱을 설치합니다: adb install <path_to_apk> 설치된 서드파티 앱을 나열합니다: adb shell pm list packages -3
- awesome-adb은(는) 어디서 받을 수 있나요?
- 소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/mzlogin/awesome-adb
요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.
관련 프로젝트
브라우저에서 Android 기기를 원격으로 확인하고 제어·관리할 수 있는 셀프 호스팅 웹 앱이며, iOS는 실험적으로 지원합니다.
매뉴얼과 설명, 학습 노트를 제공하는 600개 이상의 Linux 명령어 검색형 레퍼런스로, 웹사이트와 npm 패키지로 배포됩니다.
ws:// 및 wss:// 연결을 위한 명령줄 WebSocket 클라이언트·서버로, netcat, curl, socat처럼 사용할 수 있습니다.
루트 권한이나 기기 내 앱 설치 없이 USB 또는 TCP/IP로 Android 기기를 컴퓨터에 미러링하고 제어합니다.
USB 또는 Wi-Fi로 Android 기기를 표시하고 제어하는 Qt 기반 데스크톱 클라이언트