Developer Tools - ADB를 이용한 안드로이드 APK 설치 및 실행

엔지니어 업무를 하면서 로그 분석 등 안드로이드를 다룰 상황이 있습니다.

 

Android Debug Bridge(ADB)는 Android 기기를 제어하고 통신을 도와주는 도구입니다.

ADB를 이용하여 APK 파일을 설치하고 실행할 수 있습니다. 

 

ADB 다운로드 및 설치

1. Android SDK Platform Tools를 다운로드합니다.
2. 다운로드한 ZIP 파일을 압축 해제합니다.
3. 압축 해제된 폴더에 ADB 실행 파일이 포함되어 있습니다.

시스템 환경 변수 설정 (선택 사항)

ADB 명령어를 어디서든 실행할 수 있도록 시스템 환경 변수에 ADB 경로를 추가할 수 있습니다.

• Windows:
  1. 제어판 > 시스템 및 보안 > 시스템 > 고급 시스템 설정 > 환경 변수로 이동합니다.
  2. 시스템 변수에서 Path를 선택하고 편집을 클릭합니다.
  3. ADB 폴더 경로를 새 항목으로 추가합니다.
• macOS 및 Linux: 터미널에서 다음 명령어를 실행하여 .bash_profile 또는 .zshrc 파일에 ADB 경로를 추가합니다.

echo 'export PATH=$PATH:/path/to/adb' >> ~/.bash_profile
source ~/.bash_profile

 

ADB 명령어를 이용해 APK 설치 및 실행

1. 디바이스 연결

PC에 Android 기기를 연결하고 개발자 옵션에 USB 디버깅을 활성화 시킨 뒤 명령어를 입력합니다.

adb devices

출력 값 예시

List of devices attached
520089c948205781	device

2. 설치된 앱 확인

디바이스에 설치된 앱 목록을 확인하려면 아래 명령어를 입력합니다.

adb -s 520089c948205781 shell pm list packages
# -s 옵션으로 디바이스명을 지정

 

3. 액티비티 목록 확인

특정 패키지의 액티비티 목록을 확인하여 실행할 액티비티를 찾습니다.

adb -s 520089c948205781 shell dumpsys package com.tistory.samso | findstr activity // win
adb -s 520089c948205781 shell dumpsys package com.tistory.samso | grep activity  // mac, linux

출력 값 예시

Activity Resolver Table:
        37ec68d com.tistory.samso/com.client.base.MainActivity filter 4c46276
        37ec68d com.tistory.samso/com.client.base.MainActivity filter f9ad111

4. 앱 삭제

기존 설치된 앱을 삭제합니다.

adb -s 520089c948205781 uninstall com.tistory.samso

5. APK 파일 설치

APK 파일을 디바이스에 설치합니다.

adb -s 520089c948205781 install com.tistory.samso_111.apk

6. APP 실행

설치된 앱의 'MainActivity'를 실행합니다.

adb -s 520089c948205781 shell am start -n com.tistory.samso/com.client.base.MainActivity