install-app

📁 ingpdw/pdw-android-dev-tool 📅 6 days ago
1
总安装量
1
周安装量
#47001
全站排名
安装命令
npx skills add https://github.com/ingpdw/pdw-android-dev-tool --skill install-app

Agent 安装分布

mcpjam 1
claude-code 1
replit 1
junie 1
windsurf 1
zencoder 1

Skill 文档

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 설치해줘”
  • “에뮬레이터에 앱 실행해줘”