Back to Details

install-app

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Android App Install Skill

Android应用安装Skill

연결된 Android 디바이스 또는 에뮬레이터에 앱을 빌드하고 설치하는 스킬입니다.
这是一项用于在已连接的Android设备或模拟器上构建并安装应用的技能。

실행 순서

执行步骤

1. 연결된 디바이스 확인

1. 检查已连接设备

bash
adb devices
bash
adb devices

2. 빌드 타입 확인

2. 确认构建类型

  • Debug 빌드 (기본): 빠른 빌드, 디버깅 가능
  • Release 빌드: 최적화된 빌드, ProGuard/R8 적용
  • Debug构建（默认）：构建速度快，支持调试
  • Release构建：经过优化的构建，已应用ProGuard/R8

3. 앱 빌드 및 설치

3. 应用构建与安装

Gradle 프로젝트 (권장)

Gradle项目（推荐）

bash
undefined
bash
undefined

Debug 빌드 후 설치

构建Debug版本后安装

./gradlew installDebug
./gradlew installDebug

Release 빌드 후 설치

构建Release版本后安装

./gradlew installRelease
./gradlew installRelease

특정 디바이스에 설치 (여러 디바이스 연결 시)

安装到指定设备（多设备连接时）

./gradlew installDebug -Pandroid.injected.build.api=<device_serial>
undefined
./gradlew installDebug -Pandroid.injected.build.api=<device_serial>
undefined

APK 직접 설치

直接安装APK

bash
undefined
bash
undefined

단일 디바이스

单设备场景

adb install app/build/outputs/apk/debug/app-debug.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 -s <device_serial> install app/build/outputs/apk/debug/app-debug.apk

기존 앱 덮어쓰기 (데이터 유지)

覆盖安装现有应用（保留数据）

adb install -r app-debug.apk
adb install -r app-debug.apk

다운그레이드 설치

降级安装

adb install -r -d app-debug.apk
undefined
adb install -r -d app-debug.apk
undefined

디바이스 관리 명령어

设备管理命令

연결된 디바이스 목록

已连接设备列表

bash
adb devices -l
bash
adb devices -l

에뮬레이터 시작

启动模拟器

bash
undefined
bash
undefined

사용 가능한 AVD 목록

查看可用AVD列表

emulator -list-avds
emulator -list-avds

에뮬레이터 실행

启动模拟器

emulator -avd <avd_name>
undefined
emulator -avd <avd_name>
undefined

무선 디버깅 연결

无线调试连接

bash
undefined
bash
undefined

디바이스 IP로 연결 (Android 11+)

通过设备IP连接（Android 11及以上）

adb pair <ip>:<port> adb connect <ip>:<port>
undefined
adb pair <ip>:<port> adb connect <ip>:<port>
undefined

설치 후 앱 실행

安装后启动应用

bash
undefined
bash
undefined

메인 액티비티 실행

启动主Activity

adb shell am start -n <package_name>/<activity_name>
adb shell am start -n <package_name>/<activity_name>

예시

示例

adb shell am start -n com.example.app/.MainActivity
undefined
adb shell am start -n com.example.app/.MainActivity
undefined

문제 해결

故障排除

디바이스가 보이지 않을 때

设备无法识别时

  1. USB 디버깅 활성화 확인
  2. USB 케이블 및 포트 확인
  3. adb kill-server && adb start-server
    실행
  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기존 앱 삭제 후 재설치
错误解决方法
INSTALL_FAILED_ALREADY_EXISTS使用
-r
选项
INSTALL_FAILED_VERSION_DOWNGRADE添加
-d
选项
INSTALL_FAILED_INSUFFICIENT_STORAGE释放设备存储空间
INSTALL_FAILED_UPDATE_INCOMPATIBLE删除现有应用后重新安装

사용 예시

使用示例

사용자가 다음과 같이 요청하면 이 스킬을 활용합니다:
  • "앱 설치해줘"
  • "디바이스에 설치해줘"
  • "빌드하고 폰에 넣어줘"
  • "APK 설치해줘"
  • "에뮬레이터에 앱 실행해줘"
当用户提出以下请求时，可使用本技能：
  • "帮我安装应用"
  • "帮我安装到设备上"
  • "构建后安装到手机上"
  • "帮我安装APK"
  • "帮我在模拟器上启动应用"