실제 장치에 APK를 설치하기 위해 Android 빌드를 디스크에 저장했습니다. 브라우저 버전은 괜찮지만, 내부 테스트 업로드 후 Android Studio가 인덱싱을 완료하기 전에.
그것은 Adb ADB가 APK를 실제 전화와 연결하는 가장 짧은 경로가 됩니다. Capacitor 또는 Ionic과 함께 작업하는 경우, 이 명령은 편의 기능에서 벗어나 피드백 루프의 일부가 됩니다. 브라우저가 알려주지 않는 네이티브 플러그인, 권한, 스플래시 동작, 깊이 링크, WebView의 특이점, 등 모든 것을 확인하는 방법입니다.
목차
- ADB 설치는 테스트에 가장 직접적인 경로입니다.
- Adb Install이 테스트에 가장 직접적인 경로가 된 이유
- 장치 설정을 활성화하는 방법
- Adb Install Flag를 마스터하는 방법
- 설치 실패를 해결하는 방법
- Capacitor 개발자를 위한 완전한 예시
Adb Install이 테스트에 가장 직접적인 경로인 이유
Android 앱을 오랫동안 개발한다면, Play Store를 테스트 경로로 사용하지 않게 됩니다. 이는 일상적인 반복 작업에서 너무 느립니다. 특히, 권한 표시, 플러그인 브리지 문제, 또는 단일 장치에서만 나타나는 레이아웃 버그를 확인할 때입니다.
ADB Android에서부터 2008년 Android 1.0부터, 그리고 여전히 기기에게 APK를 직접 배포하는 표준 방법입니다. Android의 글로벌 시장 점유율은 2024년 70%를 넘어섰습니다. 70%, 이 워크플로우가 광범위한 기기 혼합에 걸쳐 작업하는 모바일 팀에 중심적인 이유입니다. 이는 Android Debug Bridge 공식 문서에서 언급한 바와 같습니다. official Android Debug Bridge 문서.
실제 개발에서 가치가 간단합니다:
- 스토어의 마찰을 피합니다: 리뷰 큐, 테스트 트랙 지연이 없습니다.
- 테스트하는 건 정확히 생성한 빌드입니다: debug, 릴리스 후보, 또는 한 번의 branch 빌드.
- 즉시 피드백을 받을 수 있습니다: 설치, 실행, 로그를 검사, 반복.
실용적인 규칙: 질문이 “이 APK가 물리적 Android 기기에서 작동합니까?” 라면
adb install일반적으로 첫 번째 대답이 되어야 합니다.
Capacitor와 Ionic 작업에서 이게 더 중요합니다. 브라우저 실행은 웹层 렌더링 여부를 알려줍니다. 그러나 Android 권한 처리가 작동하는지, 플러그인 초기화가 깨끗하게 진행되는지, 기존 설치에 대한 업데이트가 저장된 데이터를 깨트리지 않고 진행되는지 여부는 알려주지 않습니다.
명령어 자체는 간단합니다:
adb install path/to/app.apk
이것이 유용한 것은 문법이 아니라 제어입니다. 설치를 직접 진행할 수 있고 기존 앱 위에 재설치할 수 있습니다. 이전 빌드 테스트도 가능하고 패키지 수준의 오류를 진단할 수 있습니다. 그만큼 ‘ADB 설치 APK’라는 문구가 실제 팀 워크플로우에서 오랜 시간 동안 계속해서 등장하는 이유입니다. ADB를 위한 환경 설정 ADB 문제의 대부분은 시작 단계에서 설치 문제가 아니라 설정 문제입니다. 기계가 찾을 수 없는
ADB 환경 설정
ADB 환경 설정 adb, 장치가 인증되지 않았거나 OEM이 알려지지 않은 토글을 추가했습니다.
컴퓨터에 플랫폼 도구를 설치하세요.
ADB를 실행하기 위해 Android Studio 전체 설치가 필요하지 않습니다. 필요합니다 SDK 플랫폼 도구, 그러면 터미널에서 그 위치를 알 수 있어야 합니다.
Windows, macOS, Linux에서 가장 깨끗한 설정은 동일합니다:
- Google에서 플랫폼 도구를 다운로드하세요. 압축 파일을 풀어주세요.
- 안정적인 위치에 풀어주세요. 폴더를 PATH에 추가하세요.
- PATH에 폴더를 추가하세요 이것은
adb어떤 터미널 창에서도 작동합니다.
Capacitor 기기를 처음부터 설정하는 경우 이 Capacitor 앱을 위한 안드로이드 설정 가이드 은 더 광범위한 도구 체인에 대한 유용한 동반자입니다.
터미널을 사용하여 명령어가 사용 가능한지 확인하세요:
adb version
버전이 반환되는 대신 “명령어를 찾을 수 없음”이 반환되면 잘되었습니다.
몇 가지 플랫폼에 특정한 습관이 도움이 됩니다:
- Windows: Platform Tools 폴더를 변경되지 않는 경로에 넣고 환경 변수에 해당 폴더를 추가하세요.
- macOS: shell 프로파일에 폴더 경로를 추가하세요.
.zshrc. - Linux: shell config에 동일한 경로를 추가하고 shell을 다시 로드하세요.
장치에서 설정을 올바르게 활성화하세요
장치 쪽도 중요합니다. 중요한 전제 조건은 USB 디버깅을 활성화하는 것입니다. USB 디버깅을 개발자 옵션 , 개발자 옵션을 활성화하려면빌드 번호를 7번 탭하세요 Xiaomi 장치의 MIUI에서, 또한USB를 통해 설치 , 이 설명서에 설명된 대로 활성화하세요이 ADB 설정 참고 자료 (dev.to).
그것은 짧은 체크리스트를 남긴다:
- 개발자 옵션 활성화: 빌드 번호를 7번 탭하세요.
- USB 디버깅 활성화: ADB가 필요로 하는 설정입니다.
- 제조사 특수 옵션을 확인하세요: Xiaomi가 대표적인 예입니다.
- 신뢰할 수 있는 케이블로 연결하세요: 충전 전용 케이블은 시간을浪費합니다.
휴대폰의 프롬프트도 케이블과 마찬가지로 중요합니다. 'USB 디버깅 허용?'을 놓치면 컴퓨터는 장치를 볼 수 있지만 ADB는 여전히 허용되지 않습니다.
첫 연결 시 안드로이드는 컴퓨터를 신뢰할지 여부를 묻습니다. 이를 수락하고, 개발 환경이면 영구적으로 허용하세요. 이 프롬프트를 건너뛸 경우 나중에 워크플로우가 실패하고 더 복잡하게 보이게 됩니다.
ADB 설치 APK 워크플로우의 핵심
설정 완료 후 설치 경로는 짧습니다. 일반적인 오류는 다음 명령어의 성공 가능성을 알리는 하나의 확인을 건너뛰는 것입니다.
장치 확인하기
이것을 먼저 실행하세요:
adb devices
연결된 시리얼 번호와 건강한 장치 상태를 확인하고 싶습니다. 장치가 비인가 상태로 나타나면, 설치를 시도하기 전에 권한을 수정하세요.
디버그, QA, 릴리즈 후보 출력을 다루는 팀에게는, 푸시하는 빌드 종류에 대해 명확하게 알려주기에도 도움이 됩니다. 폴더에 비슷한 이름의 APK가 많다면, 모바일 앱 빌드 종류 는 좋은 참고 자료입니다.
설치 명령어 실행
기본 명령어는 간단합니다:
adb install path/to/your-app.apk
경로에 공백이 포함되어 있다면, 쉘에서 따옴표로 감싸세요. APK가 현재 폴더에 있다면, 명령어는 thậm chí 더 짧아집니다:
adb install app-debug.apk
정상적인 실행은 터미널에서 스트리밍 설치 메시지를 표시하고 성공 메시지를 표시합니다. 그게 바로 당신이 원하는 출력입니다. 그것은 패키지 관리자가 APK를 수락하고 설치를 완료했음을 확인하기 때문입니다.
다음은 실제 흐름을 확인하기 위해 워크숍입니다:
스트리밍 설치가 수동 푸시 및 Pm 설치보다 좋은 이유
아래에서 보면 adb install APK를 /data/local/tmp를 호출하고 pm install를 호출한 다음 임시 파일을 삭제합니다. 스트리밍 워크플로는 터미널 출력에 반영됩니다. 예를 들어 “스트리밍 설치 중” 를 표시하고 를 표시합니다.이것은 이전 설정 참고서에서 요약된 구현 세부 사항에 따라 결정됩니다.
그것이 중요합니다. 그것은 이전의 두 단계의 습관인 수동 푸시 및 Pm 설치보다 더 깨끗합니다. adb push 그리고 패키지 매니저 명령어를 직접 호출합니다. 일상적인 실무에서 스트리밍 설치는 몇 가지 이점이 있습니다:
- 더욱 적은 수동 작업: 한 명령어로 전송 및 설치를 처리합니다.
- 더욱 적은 장치 오염: 임시 파일은 자동으로 삭제됩니다.
- 더욱 적은 오류: 파일을 하나만 푸시하고 다른 파일을 설치하는 오류를 피할 수 있습니다.
사용할 수 있다면 사용하세요.
adb install수동 푸시 및 셸 설치는 특수한 경우에 유용하지만, 일반적인 앱 테스트의 기본 경로가 아닙니다.
ADB 설치 APK 워크플로우의 핵심 루프는 다음과 같습니다: 장치 확인, 설치 실행, 성공 확인, 앱 실행, 다음 빌드 후 반복합니다.
ADB 설치 플래그를 마스터하는 방법: 더 빠른 워크플로우를 위한 방법
ADB 설치 플래그를 이해하는 것은 개발을 위한 워크플로우를 더 빠르게 만드는 것입니다. 기본 명령어는 APK를 폰에 가져옵니다. 플래그는 개발을 위한 실제 프로세스인지, 개발자가 싸우게 하는지 결정합니다.
ADB 설치 플래그와 사용 방법
| 플래그 | 설명 | 일반적인 사용 사례 |
|---|---|---|
-r |
이미 설치된 앱을 재설치하여 데이터를 유지할 수 있는 경우 | 일일 디버그 빌드에 대한 반복 |
-d |
버전 다운그레이드 허용 | 테스트 롤백 시나리오 또는 이전 빌드 |
-g |
설치 시간에 런타임 권한 부여 | 카메라, 저장소, 위치 및 유사한 기능을 위한 테스트 속도 향상 |
정규 개발에서 가장 중요한 플래그는 -r.
그렇지 않으면 이미 설치된 패키지를 업데이트할 때 새로운 APK를 충돌하는 설치 시도로 대신하여 대체하는 것이 아닌 경우에 업데이트 시도가 실패하는 이유입니다. 따라서 많은 개발자들은 adb install -r app-debug.apk 기본적인 습관이 됩니다.
일상 개발에서 중요한 플래그는 무엇인가요?
-r Capacitor 앱을 테스트하고 여러 번 빌드하는 경우, 매번 앱을 삭제하고 재설치하는 것은 느리고 유용한 로컬 상태를 삭제합니다. 재설치는 계속 진행할 수 있게 해줍니다.
-d 이 플래그는 상황에 따라 사용됩니다. 그러나 필요할 때는 정말 필요합니다. 회귀 테스트, 롤백 연습, 또는 이전 빌드가 레거시 데이터베이스를 올바르게 열 수 있는지 확인할 때 유용합니다.
-g 이 플래그는 품질 향상 플래그입니다. 앱이 권한을 초기에 접촉하면 자동 권한 부여는 장치 설정에서 반복적인 탭을 제거합니다. 권한 테스트를 대신하지는 않지만 설치 및 런칭을 빠르게 진행할 때 유용합니다.
몇 가지 combinations이 자주 발생합니다:
adb install -r app-debug.apk
adb install -r -g app-debug.apk
adb install -r -d older-build.apk
플래그는 모두 트레이드 오프가 있습니다. 편리함은 실제 사용자 조건을 숨길 수 있습니다. 모든 권한을 자동으로 부여하는 경우 런타임 권한의 Edge Case를 놓치거나, 항상 이전 데이터를 재설치하는 경우 첫 번째 런칭 문제를 놓치게 됩니다.
경험이 많은 팀들은 습관을 나누어 사용합니다:
- 빠른 루프 빌드: 사용
-r일정한 경우-g. - 정확한 상태 확인: 첫 번째로アン스톨을 해제하고, 후에 최신 버전으로 설치하세요.
- 롤백 테스트: 사용
-d버전이 이동하는 것이 테스트되는 경우에만 사용하세요.
Capacitor 개발의 명령줄 측면에 대한 더 폭넓은 리프레셔를 원한다면, 이 Capacitor __CAPGO_KEEP_1__ 명령어와 수정사항에 대한 안내서 일반적인 Capacitor CLI 명령어와 수정사항 일반적인 설치 오류 해결
설치 오류 해결
Android Debug Bridge (ADB) 설치 오류와 개발자에게 해결책을 제공하는 일반적인 오류 해결 목록입니다.
증상:
__CAPGO_KEEP_0__
adb devices표시unauthorized
원인: 전화가 컴퓨터를 신뢰하지 않았거나, 프롬프트가 취소되었습니다.
해결 방법은 다음과 같습니다.
- 장치와 다시 연결하세요. 잠금 화면을 취소하세요.
- 휴대폰에서 RSA 인증 프롬프트를 찾으세요. 프롬프트를 승인하세요.
- 개발자 머신에 대해 항상 허용하기 옵션을 선택하는 것이 좋습니다.문제가 해결되지 않으면 ADB 서버를 재시작하세요:
- 터미널에서 문제가 기술적으로 보이지만 실제 해결책은 종종 휴대폰 자체에 있습니다.
adb kill-server
adb start-server
패키지가 이미 존재할 때
이미 설치된 패키지가 존재할 때
증상:
INSTALL_FAILED_ALREADY_EXISTS
이 경우 일반적으로 설치 중인 패키지에 대해 existing 패키지에 대하여 replace flag를 사용하지 않고 설치하려고 할 때입니다. 이 일반적인 함정은 이 ADB 설치 오류에 대한 Stack Overflow 토론 .
가장 빠른 해결책은 다음과 같습니다.
adb install -r app-debug.apk
업그레이드 대신 clean 설치가 필요하다면 먼저 제거하십시오.
adb uninstall your.package.name
정기적인 반복에서 reinstall 경로를 사용하십시오. uninstall은 앱의 로컬 상태를 삭제하거나 첫 번째 실행 동작을 확인하기 위해 사용하십시오.
서명과 이전 패키지 상태 충돌
일부 오류는 APK 파일 자체에 관한 것이 아닙니다. Android가 기억하는 패키지에 관한 것입니다.
두 가지 패턴이 자주 나타납니다.
- 서명 불일치: 설치된 앱은 APK에서 다른 키로 서명된 경우입니다.
- 중복 패키지 상태: 설치 후 제거된 패키지 잔해가 다음 설치를 방해합니다.
두 번째 경우가 특히 짜증스럽습니다. 성공적으로 제거된 것처럼 보이지만 생존할 수 있습니다. 새로운 안드로이드 버전에서, 레거시 제거 동작은 패키지 상태를 남길 수 있습니다. 이는 다음의 설명에서 언급된 것과 같습니다. INSTALL_FAILED_DUPLICATE_PACKAGE실용적인 진단 흐름은 다음과 같습니다.
첫 번째로 패키지 식별을 확인하세요:
- 설치된 패키지의 이름이 실제로 무엇인지 확인하세요. 다음으로 서명 일관성을 확인하세요:
- 디버그 빌드와 릴리스 빌드가 깨끗하게 대체되지 않습니다. 그 다음 설치된 패키지를 제거하세요:
- 일반적인 제거 경로를 사용하세요. 오류가 지속된다면:
- 이 오류는 패키지 상태가 오래된 것이 아니라 랜덤 ADB 오류가 아닙니다. 실용적인 진단 흐름은 다음과 같습니다.
ADB를 통해 설치하는 debug APK는 일반 개발 도구 외부에서 배포되는 경우 다른 문제가 있습니다. 일부 팀은 ADB를 통해 동일한 빌드를 설치하지만 메시징 또는 이메일에서 수동으로 시드 로드할 때 실패하는 것을 발견합니다. 이 동작은 Android의 debug로 서명된 앱의 컨텍스트에 의존하는 Android의 검증에 관련이 있습니다. 이 동작은 이 기사를 통해 설명됩니다. Android 앱 설치 오류를 해결하는 방법에 대한 안내서. 실제로 QA 팀은 ADB를 사용하여 내부 디버그 배포를 선호하는 것이 좋습니다. ad hoc 수동 시드 로딩에 의존하는 대신.
Field note: ADB를 통해 빌드가 설치되지만 수동으로 탭을 클릭하여 설치되지 않으면 APK가 깨진 것으로 생각하지 마십시오. 서명 컨텍스트와 설치 경로를 먼저 확인하십시오.
Capacitor 프로젝트가 네이티브 및 웹层에서 빌드 및 배포 문제를 지속적으로 발생하는 경우, Android 빌드 오류를 해결하는 Capacitor의 이 문제 해결 가이드를 참고하십시오. Capacitor 개발자들을 위한 완전한 예시 __CAPGO_KEEP_0__ 프로젝트에서 터미널 루프는 일반적으로 짧습니다. 네이티브 파일을 동기화하고 Android 앱을 빌드한 다음 연결된 장치에 결과 APK를 푸시합니다. Android Studio를 열지 않는 한 네이티브 디버깅이 필요할 때만.
Capacitor 개발자들을 위한 완전한 예제
In a Capacitor project, the terminal loop is usually short. You sync native files, build the Android app, and push the resulting APK to a connected device without opening Android Studio unless you need native debugging.
__CAPGO_KEEP_0__
npx cap sync android
__CAPGO_KEEP_0__
adb install -r android/app/build/outputs/apk/debug/app-debug.apk
이러한 워크플로우는 많은 팀들이 사용하는 이유는 feedback loop이 짧기 때문입니다. CapacitorJS 앱에서 팀이 차등 업데이트를 배포할 때 adb install IBM 연구에서 78%의 Android 기반 모바일 팀이 실시간 JavaScript 및 CSS修정에 대해 Play Store 제출보다 중요하다고 여겼습니다. 이 비디오 참조는 ADB 기반 APK 설치를 위한 기업 워크플로우에 대해 다룹니다. .
프로젝트 설정을 아직 시작하지 않았다면, Capacitor CLI 설치 가이드 이것이 시작점입니다.
팀이 Capacitor을 사용하고 JavaScript, CSS, config, 및 asset修정을 배포하고 싶다면, Capgo Live Update
