ADB(Android Debug Bridge, 안드로이드 디버그 브리지)는 PC와 Android 기기를 연결하여 명령어를 통해 다양한 작업을 수행할 수 있도록 해주는 Android 공식 디버깅 도구입니다.
LD플레이어 역시 각 인스턴스에서 ADB 디버깅 포트를 제공하기 때문에, 별도의 전용 명령어 도구를 사용하지 않아도 ADB를 통해 앱 설치 및 삭제, 입력 자동화, 화면 캡처, 파일 전송, 기기 정보 확인 등 다양한 작업을 수행할 수 있습니다.
이 글에서는 LD플레이어에서 ADB를 연결하는 방법부터 자주 사용하는 명령어와 실제 활용 방법까지 순서대로 정리해 보겠습니다.
1. LD플레이어 ADB 포트 및 연결 방법
1.1 ADB 포트 확인하기
LD플레이어의 각 인스턴스는 ADB 디버깅을 위한 포트를 사용합니다.
일반적으로 인스턴스 번호에 따라 다음과 같이 포트가 할당됩니다.
| 인스턴스 번호 | 기본 ADB 포트 |
|---|---|
| 0 (메인 인스턴스) | 5554 |
| 1 | 5556 |
| 2 | 5558 |
| 3 | 5560 |
| … | +2씩 증가 |
예를 들어 인스턴스 0이 실행 중이라면 adb devices 명령어에서 일반적으로 다음과 같이 표시됩니다.
adb devices
예:
List of devices attached
emulator-5554 device
여러 인스턴스를 실행하는 경우 인스턴스 1은 emulator-5556, 인스턴스 2는 emulator-5558과 같이 표시될 수 있습니다.
다만 실제 ADB 포트는 PC 환경 및 실행 상태에 따라 달라질 수 있으므로 adb devices의 실제 출력 결과를 기준으로 사용하는 것이 가장 정확합니다.
참고: LD플레이어 9와 LD플레이어 14를 동시에 사용하는 경우
동일한 PC에서 LD플레이어 9와 LD플레이어 14의 인스턴스 0을 동시에 실행하면 ADB 포트 충돌이 발생할 수 있습니다.
두 버전 모두 인스턴스 0에서 동일한 ADB 포트를 사용하기 때문에 먼저 실행된 인스턴스가 정상적으로 등록되고, 나중에 실행된 인스턴스는 ADB 포트가 정상적으로 등록되지 않아
adb devices에서 표시되지 않을 수 있습니다.이 경우 두 버전의 인스턴스 0을 동시에 실행하지 않거나, 한쪽 버전의 에뮬레이터만 실행하는 방법을 권장합니다.
1.2 단일 인스턴스에서 ADB 연결하기
LD플레이어 하나에 ADB를 연결하는 방법은 간단합니다.
Step 1. LD플레이어 설치 폴더 열기
LD플레이어가 설치된 폴더로 이동합니다.
예:
E:\LDPlayer\LDPlayer14
Windows 탐색기의 주소창에 CMD를 입력하고 Enter 키를 누르면 해당 폴더를 기준으로 명령 프롬프트를 바로 실행할 수 있습니다.
Step 2. 연결된 기기 확인
adb devices
정상적으로 연결되어 있다면 다음과 비슷한 결과가 표시됩니다.
E:\LDPlayer\LDPlayer14> adb devices
List of devices attached
emulator-5554 device
Step 3. Android Shell 접속
adb shell
정상적으로 접속되면 다음과 같이 Android Shell 프롬프트가 표시됩니다.
xxx:/ #
이제 Android 시스템에서 다양한 ADB 명령어를 직접 실행할 수 있습니다.
1.3 여러 개의 LD플레이어 인스턴스에 ADB 연결하기
여러 개의 LD플레이어 인스턴스를 동시에 실행하고 있다면 먼저 adb devices를 이용해 각 인스턴스의 포트를 확인해야 합니다.
adb devices
예를 들어 다음과 같이 표시될 수 있습니다.
List of devices attached
emulator-5554 device
emulator-5556 device
emulator-5558 device
특정 인스턴스에 연결하려면 -s <포트> 옵션을 사용합니다.
adb -s emulator-5554 shell
특정 인스턴스에서 앱 목록을 확인하는 경우에는 다음과 같이 사용할 수 있습니다.
adb -s emulator-5554 shell pm list packages -3
TIP
원하는 인스턴스가
adb devices에 표시되지 않는다면 해당 LD플레이어 인스턴스가 실행 중인지 확인한 후adb devices를 다시 실행해 보세요.
2. 여러 기기 연결 시 -s 옵션 사용하기
PC에 여러 대의 Android 기기 또는 여러 개의 LD플레이어 인스턴스가 연결되어 있는 경우, 대상 기기를 지정하지 않고 ADB 명령어를 실행하면 다음과 같은 오류가 발생할 수 있습니다.
adb.exe: more than one device/emulator
이 경우 -s <포트> 옵션을 사용해 작업할 대상을 명시해야 합니다.
예를 들어 emulator-5554를 대상으로 화면을 클릭하려면 다음과 같이 입력합니다.
adb -s emulator-5554 shell input tap 500 500
즉, 여러 기기를 동시에 사용하는 환경에서는 다음과 같은 형식으로 명령어를 작성하면 됩니다.
adb -s <포트> <명령어>
예:
adb -s emulator-5554 shell pm list packages -3
포트 관련 참고
LD플레이어 인스턴스의 ADB 포트는
adb devices에서 확인할 수 있습니다. 매크로나 자동화 프로그램을 작성할 때는 임의로 포트 번호를 지정하기보다 실제adb devices에 표시되는 포트를 기준으로-s옵션을 사용하는 것이 안전합니다.
3. LD플레이어에서 자주 사용하는 ADB 명령어
일부 ADB 명령어는 Android 시스템 권한이 필요할 수 있습니다.
필요한 경우 LD플레이어의 설정 → 기타 → ROOT 권한 활성화에서 ROOT 권한을 먼저 활성화한 후 사용하세요.
아래 명령어는 기본적으로 adb shell에 접속한 상태를 기준으로 설명하지만, 필요에 따라 adb -s <포트>를 앞에 추가하여 특정 인스턴스에서 실행할 수도 있습니다.
3.1 ROOT 권한 활성화
LD플레이어에서 ROOT 권한이 필요한 작업을 수행하려면 먼저 설정에서 ROOT 권한을 활성화해야 합니다.
설정 → 기타 → ROOT 권한 활성화
ADB Shell에 접속한 뒤 프롬프트가 $로 표시된다면 일반 사용자 권한으로 접속된 상태입니다.
adb shell
ROOT 권한이 활성화된 환경에서는 다음과 같이 ADB를 ROOT 모드로 재시작할 수 있습니다.
adb root
그다음 다시 Shell에 접속합니다.
adb shell
정상적으로 ROOT 권한이 적용되었다면 프롬프트가 다음과 같이 #로 표시됩니다.
xxx:/ #
3.2 여러 인스턴스에서 명령어 실행하기
여러 개의 LD플레이어 인스턴스를 사용하는 경우 다음 형식으로 명령어를 실행합니다.
adb -s <포트> <명령어>
예:
adb -s emulator-5554 shell pm list packages -3
PC에 연결된 Android 기기가 하나뿐이라면 -s 옵션을 생략할 수도 있습니다.
adb shell pm list packages -3
3.3 APK 설치 및 삭제
ADB를 이용하면 PC에 있는 APK 파일을 LD플레이어에 직접 설치할 수 있습니다.
APK 설치
adb install C:\xx.apk
APK 덮어쓰기 설치
기존 앱의 데이터를 유지하면서 APK를 다시 설치하려면 -r 옵션을 사용할 수 있습니다.
adb install -r C:\xx.apk
앱 삭제
adb uninstall <패키지명>
여러 인스턴스를 사용하는 경우:
adb -s emulator-5554 install C:\xx.apk
3.4 설치된 앱의 패키지명 확인하기
현재 설치되어 있는 앱의 패키지명을 확인할 때는 pm list packages를 사용할 수 있습니다.
모든 앱 확인
adb shell pm list packages
서드파티 앱만 확인
adb shell pm list packages -3
시스템 앱만 확인
adb shell pm list packages -s
현재 실행 중인 앱 확인
Windows 명령 프롬프트에서는 다음과 같이 사용할 수 있습니다.
adb shell dumpsys window | findstr mCurrentFocus
3.5 Activity 이름 확인하기
특정 앱을 ADB 명령어로 직접 실행하거나 자동화하려면 해당 앱의 Activity 이름이 필요한 경우가 있습니다.
다음 명령어로 확인할 수 있습니다.
adb shell cmd package resolve-activity --brief <패키지명> | tail -n 1
예:
adb shell cmd package resolve-activity --brief com.example.game | tail -n 1
확인한 Activity를 이용하면 다음과 같이 앱을 직접 실행할 수 있습니다.
adb shell am start -n <패키지명>/<Activity명>
3.6 앱 버전 확인하기
특정 앱의 설치 버전 정보를 확인하려면 다음 명령어를 사용할 수 있습니다.
adb shell dumpsys package <패키지명> | findstr version
예:
adb shell dumpsys package com.example.game | findstr version
3.7 앱 데이터 초기화
앱을 삭제하지 않고 저장된 데이터를 초기화하려면 pm clear 명령어를 사용할 수 있습니다.
adb shell pm clear <패키지명>
예:
adb shell pm clear com.example.game
주의
이 명령어를 실행하면 해당 앱의 저장 데이터가 삭제될 수 있으므로 중요한 데이터가 있는 경우 주의해서 사용해야 합니다.
4. ADB를 이용한 입력 자동화
ADB는 화면 터치, 스와이프, 키 입력 등의 동작을 명령어로 실행할 수 있어 게임이나 앱 자동화에도 활용할 수 있습니다.
| 작업 | 명령어 | 설명 |
|---|---|---|
| 키 입력 | adb shell input keyevent <키값> |
지정한 Android 키 이벤트 실행 |
| 문자 입력 | adb shell input text <문자> |
텍스트 입력 |
| 화면 클릭 | adb shell input tap X Y |
지정한 좌표 클릭 |
| 스와이프 | adb shell input swipe X1 Y1 X2 Y2 [TIME] |
지정한 좌표로 스와이프 |
| 길게 누르기 | adb shell input swipe X Y X Y [TIME] |
같은 좌표를 일정 시간 동안 누르기 |
| 앱 실행 | adb shell am start -n <패키지명>/<Activity> |
지정한 Activity 실행 |
키 입력
adb shell input keyevent <키값>
예를 들어 3은 HOME 키, 4는 BACK 키입니다.
adb shell input keyevent 3
adb shell input keyevent 4
문자 입력
adb shell input text hello
참고:
adb shell input text는 기본적으로 한글과 같은 일부 문자를 직접 입력하는 데 제한이 있습니다. 한글 입력이 필요한 경우 별도의 입력 방식이나 자동화 도구가 필요할 수 있습니다.
화면 클릭
adb shell input tap 500 500
500 500은 화면의 X, Y 좌표입니다.
스와이프
adb shell input swipe 300 800 300 300 500
위 명령어는 (300, 800)에서 (300, 300) 방향으로 500ms 동안 스와이프합니다.
길게 누르기
시작점과 끝점을 동일하게 지정하면 특정 좌표를 일정 시간 동안 길게 누르는 방식으로 활용할 수 있습니다.
adb shell input swipe 500 500 500 500 1000
5. PC와 LD플레이어 간 파일 전송
ADB의 push와 pull 명령어를 사용하면 PC와 LD플레이어 사이에서 파일을 주고받을 수 있습니다.
PC → LD플레이어
adb push C:\test.apk /sdcard/
LD플레이어 → PC
adb pull /sdcard/test.apk C:\
Windows 환경에서는 PC의 파일 경로를 입력할 때 Windows 방식의 경로(C:\)를 사용하는 것이 좋습니다.
예:
C:\test.apk
C:\backup\
E:\files\
실제 사용 시 참고
LD플레이어 9 및 LD플레이어 14 환경에서 기본 ADB의
adb push와adb pull을 이용한 파일 양방향 전송을 사용할 수 있습니다.
6. 화면 캡처
ADB를 이용하면 LD플레이어의 현재 화면을 이미지 파일로 저장할 수 있습니다.
먼저 Android 내부 저장 공간에 스크린샷을 저장합니다.
adb shell screencap /sdcard/screen.png
그다음 PC로 파일을 가져옵니다.
adb pull /sdcard/screen.png C:\
결과적으로 screen.png 파일이 PC의 C:\ 경로에 저장됩니다.
7. 화면 녹화
screenrecord를 사용하면 LD플레이어 화면을 동영상으로 녹화할 수 있습니다.
adb shell screenrecord /sdcard/test.mp4
녹화를 종료하려면 명령 프롬프트에서 Ctrl + C를 누릅니다.
녹화가 끝난 후 PC로 파일을 가져옵니다.
adb pull /sdcard/test.mp4 C:\
8. LD플레이어 및 Android 기기 정보 확인
ADB를 이용하면 현재 Android 환경의 다양한 시스템 정보를 확인할 수 있습니다.
모델명
adb shell getprop ro.product.model
제조사
adb shell getprop ro.product.brand
보드 정보
adb shell getprop ro.product.board
Android 버전
adb shell getprop ro.build.version.release
화면 해상도
adb shell wm size
그래픽 렌더링 정보
adb shell dumpsys SurfaceFlinger | findstr "GLES"
이러한 명령어는 자동화 프로그램이나 테스트 스크립트를 작성할 때 현재 LD플레이어의 Android 환경을 확인하는 용도로 활용할 수 있습니다.
9. 개발자 옵션 비활성화
ADB를 이용해 Android의 개발자 옵션을 비활성화할 수도 있습니다.
adb shell settings put global development_settings_enabled 0
10. ADB 실전 활용 예시
앞에서 살펴본 명령어를 조합하면 LD플레이어에서 다양한 자동화 작업을 구성할 수 있습니다.
| 목적 | 명령어 |
|---|---|
| 현재 인스턴스 클릭 | adb shell input tap 500 500 |
| 특정 인스턴스 클릭 | adb -s emulator-5554 shell input tap 500 500 |
| 영어 텍스트 입력 | adb shell input text hello |
| 화면 스와이프 | adb shell input swipe 300 800 300 300 500 |
| HOME 화면으로 이동 | adb shell input keyevent 3 |
| 이전 화면으로 이동 | adb shell input keyevent 4 |
| Android 버전 확인 | adb shell getprop ro.build.version.release |
| 시스템 설정 실행 | adb shell am start -n com.android.settings/.Settings |
| PC에서 APK 설치 | adb install C:\test.apk |
| 앱 데이터 초기화 | adb shell pm clear <패키지명> |
| 파일을 LD플레이어로 전송 | adb push C:\conf.txt /sdcard/ |
| 파일을 PC로 가져오기 | adb pull /sdcard/conf.txt C:\ |
| 스크린샷 저장 | adb shell screencap /sdcard/s.png |
| 스크린샷 PC로 가져오기 | adb pull /sdcard/s.png C:\ |
마무리
ADB는 LD플레이어를 단순히 실행하고 사용하는 것뿐만 아니라, 앱 설치 및 삭제, 화면 조작, 파일 전송, 스크린샷, 화면 녹화, 시스템 정보 확인 등 다양한 작업을 명령어로 자동화할 수 있는 강력한 도구입니다.
특히 여러 개의 LD플레이어 인스턴스를 동시에 운영하거나 반복적인 작업을 자동화해야 하는 경우 adb -s <시리얼 번호>를 활용하면 원하는 인스턴스를 정확하게 지정할 수 있습니다.
ADB를 처음 사용하는 사용자라면 먼저 다음 세 가지 명령어부터 익혀두는 것을 추천합니다.
adb devices
adb shell
adb -s <포트> <명령어>
이 세 가지를 이해하면 이후 APK 설치, 앱 실행, 터치 자동화, 파일 전송 등 대부분의 ADB 작업을 보다 쉽게 활용할 수 있습니다.