FAQ
자주 묻는 질문.
ADB나 Android platform-tools를 설치해야 하나요?
아니요. USB에서는 ADBKit이 WebUSB로 브라우저에서 기기와 직접 통신하므로 platform-tools, 데스크톱 앱, 브라우저 확장 프로그램이 필요 없습니다. Wi-Fi와 네트워크 연결에는 컴퓨터에서 작은 ADBKit 에이전트를 실행해야 하며, 설치는 한 줄이면 됩니다.
ADBKit은 무료인가요?
네. 현재 제공되는 모든 기능은 무료이며 계정이 필요 없습니다. 화면 제어, 키보드 입력, 스크린샷, 녹화, APK 설치, logcat, 셸, 파일 전송, 여러 기기 연결이 모두 포함됩니다. 자동화를 위한 유료 Pro 요금제는 추후 제공할 예정입니다.
기기 데이터가 서버로 전송되나요?
아니요. 화면 프레임, 로그, 파일, APK, 기기 식별자는 브라우저, 컴퓨터, 기기 사이에서만 오갑니다. USB로 직접 가거나 내 네트워크의 에이전트를 거칩니다. ADBKit에는 이 데이터를 수신하는 서버가 없습니다.
어떤 브라우저를 지원하나요?
USB에서는 Google Chrome, Microsoft Edge 등 WebUSB를 지원하는 Chromium 기반 데스크톱 브라우저를 지원합니다. Firefox와 Safari는 WebUSB를 지원하지 않습니다. 페이지는 HTTPS로 열어야 합니다.
기기가 연결되지 않는 이유는 무엇인가요?
USB에서는 대부분 Android Studio, scrcpy, adb 서버 같은 다른 프로그램이 이미 연결을 사용하고 있기 때문입니다. 해당 프로그램을 종료하고(또는 “adb kill-server”를 실행하고), USB 디버깅이 켜져 있는지 확인한 뒤 기기에 표시되는 메시지를 승인하세요. Wi-Fi에서는 에이전트가 실행 중인지, 휴대전화와 컴퓨터가 같은 네트워크에 있는지 확인하세요. 어느 단계에서 막혔는지는 연결 화면에 표시됩니다.
휴대전화에 무언가가 설치되나요?
화면을 표시하고 제어하기 위해 ADBKit은 오픈소스 scrcpy 서버 헬퍼를 기기의 임시 위치에 복사합니다. 직접 APK를 설치하지 않는 한 어떤 앱도 설치되지 않습니다.
무선으로 사용할 수 있나요?
네, 두 가지 방법이 있습니다. 기존 TCP/IP는 모든 Android에서 작동하며 켜려면 USB 케이블이 한 번 필요합니다. 무선 디버깅(Android 11 이상)은 코드나 QR 코드로 페어링하며 케이블이 필요 없습니다. 브라우저는 스스로 네트워크 연결을 열 수 없어서 컴퓨터에서 작은 에이전트가 실행되며, 시작 방법은 연결 화면에 나와 있습니다. 소스 코드는 이 사이트에 공개되어 있습니다.
여러 기기를 동시에 연결할 수 있나요?
네, 최대 6대까지 USB와 네트워크 연결을 자유롭게 섞어 쓸 수 있습니다. 기기마다 탭이 하나씩 생기고, 선택한 탭만 영상을 스트리밍하므로 나머지는 가볍게 유지됩니다.
키보드로 기기에 입력할 수 있나요?
네. 화면을 클릭하고 입력하세요. 악센트가 있는 글자와 비라틴 문자도 입력됩니다. Esc는 뒤로 가기이며, 텍스트 필드에서는 Ctrl+A, C, V, X가 동작합니다.
ADBKit은 “adbkit” npm 패키지와 같은 것인가요?
아니요. adbkit npm 패키지는 Node.js 라이브러리입니다. adbkit.com의 ADBKit은 독립적인 브라우저 작업 공간이며 해당 패키지와 관련이 없습니다.