Android App Install Skill

연결된 Android 디바이스 또는 에뮬레이터에 앱을 빌드하고 설치하는 스킬입니다.

실행 순서

1. 연결된 디바이스 확인

adb devices

2. 빌드 타입 확인

• Debug 빌드 (기본): 빠른 빌드, 디버깅 가능
• Release 빌드: 최적화된 빌드, ProGuard/R8 적용

3. 앱 빌드 및 설치

Gradle 프로젝트 (권장)

# Debug 빌드 후 설치
./gradlew installDebug

# Release 빌드 후 설치
./gradlew installRelease

# 특정 디바이스에 설치 (여러 디바이스 연결 시)
./gradlew installDebug -Pandroid.injected.build.api=<device_serial>

APK 직접 설치

# 단일 디바이스
adb install app/build/outputs/apk/debug/app-debug.apk

# 특정 디바이스 지정
adb -s <device_serial> install app/build/outputs/apk/debug/app-debug.apk

# 기존 앱 덮어쓰기 (데이터 유지)
adb install -r app-debug.apk

# 다운그레이드 설치
adb install -r -d app-debug.apk

디바이스 관리 명령어

연결된 디바이스 목록

adb devices -l

에뮬레이터 시작

# 사용 가능한 AVD 목록
emulator -list-avds

# 에뮬레이터 실행
emulator -avd <avd_name>

무선 디버깅 연결

# 디바이스 IP로 연결 (Android 11+)
adb pair <ip>:<port>
adb connect <ip>:<port>

설치 후 앱 실행

# 메인 액티비티 실행
adb shell am start -n <package_name>/<activity_name>

# 예시
adb shell am start -n com.example.app/.MainActivity

문제 해결

디바이스가 보이지 않을 때

1. USB 디버깅 활성화 확인
2. USB 케이블 및 포트 확인
3. adb kill-server && adb start-server 실행

설치 실패 시

에러	해결 방법
INSTALL_FAILED_ALREADY_EXISTS	-r 옵션 사용
INSTALL_FAILED_VERSION_DOWNGRADE	-d 옵션 추가
INSTALL_FAILED_INSUFFICIENT_STORAGE	디바이스 저장공간 확보
INSTALL_FAILED_UPDATE_INCOMPATIBLE	기존 앱 삭제 후 재설치

사용 예시

사용자가 다음과 같이 요청하면 이 스킬을 활용합니다:

• "앱 설치해줘"
• "디바이스에 설치해줘"
• "빌드하고 폰에 넣어줘"
• "APK 설치해줘"
• "에뮬레이터에 앱 실행해줘"