디스크에 새 안드로이드 빌드를 가지고 있고, 브라우저 버전이 괜찮아 보이고, 이제 실제 장치에 넣고 싶은데요. 내부 테스트 업로드 후에요. 안드로이드 스튜디오가 인덱싱을 마치기까지요. 바로 지금.
그것이 ADB Capacitor이 빌드된 APK와 실제 전화 사이의 가장 짧은 경로가 됩니다. Capacitor 또는 Ionic과 함께 작업하는 경우 이 명령은 편의 기능에서 벗어나 일반적인 피드백 루프의 일부가 됩니다. 이 명령은 네이티브 플러그인, 권한, 스플래시 동작, 깊이 링크, 웹뷰의 특이점 및 브라우저가 알려주지 않는 모든 것을 확인하는 방법입니다.
목차
- ADB Install이 테스트에 가장 직접적인 경로가 된 이유
- ADB Install을 사용하기 위해 환경을 준비하는 방법
- ADB Install APK 워크플로우의 핵심
- ADB Install 플래그를 마스터하는 방법 (빠른 워크플로우를 위한)
- 일반적인 설치 실패를 해결하는 방법
- Capacitor 개발자를 위한 완전한 예시
ADB 설치는 테스트에 가장 직접적인 경로입니다.
Android 앱을 오래 개발할수록, Play 스토어를 테스트 경로로 사용하지 않게 됩니다. 루틴 반복 시 너무 느립니다. 특히 권한提示, 플러그인 브리지 문제, 레이아웃 버그가 단일 장치에서만 나타날 때.
ADB Android의 일부로 2008년 Android 1.0부터 ADB와 같은 방법으로 APK를 직접 장치에 배포하는 표준 방식이다. 2024년 Android의 글로벌 시장 점유율은 70%를 넘어섰다.이러한 워크플로우가 모바일 팀이 광범위한 장치 혼합에 작업하는 이유 중 하나는 공식 Android Debug Bridge 문서에서 언급한 것과 같다. 실제 개발을 위해 가치가 간단하다:.
스토어의 마찰을 피한다:
- 리뷰 큐가 없고 테스트 트랙 지연이 없다. 테스트하는 건 정확히 생성한 빌드이다:
- debug, 릴리즈 후보, 또는 한 번의 branch 빌드. 즉시 피드백을 받는다:
- 설치, 런치, 로그를 검사, 반복. 실제 규칙:
__CAPGO_KEEP_0__ 이 질문이 "이 APK가 물리적 안드로이드 기기에서 작동합니까?" 인 경우
adb install일반적으로 가장 먼저 생각하는 답변이야.
이것은 Capacitor와 Ionic에서 더욱 중요합니다. 브라우저 실행은 웹层 렌더링이 되는지 알려줍니다. 그러나 안드로이드 권한 처리가 잘 되는지, 플러그인 초기화가 깨끗하게 되는지, 기존 설치에 저장된 데이터를 깨뜨리지 않고 앱이 업데이트되는지 알려주지 않습니다.
명령어 자체는 작습니다:
adb install path/to/app.apk
__CAPGO_KEEP_0__을 유용하게 만드는 것은 문법이 아니라 제어입니다. 직접 설치할 수 있고, 기존 앱 위에 재설치할 수 있고, 이전 빌드 테스트할 수 있고, 터미널을 떠나지 않고 패키지 수준의 오류를 진단할 수 있습니다. 이것이 __CAPGO_KEEP_0__을 유용하게 만드는 이유입니다. ADB 설치하여 APK를 설치합니다. 실제 팀 워크플로우에서 "시작하기" 단계가 끝난 후에도 계속 나타납니다.
Capgo 환경을 Adb에 준비하는 방법
ADB 문제의 대부분은 시작 단계에서 설치 문제가 아니라 설정 문제입니다. 기계가 찾을 수 없는 adb__CAPGO_KEEP_0__ , __CAPGO_KEEP_0__ 기기 인증이 되지 않았거나 제조사에서 알려지지 않은 설정이 하나 더 추가되었습니다.
컴퓨터에 플랫폼 도구를 설치하세요
Android Studio를 완전히 설치할 필요가 없습니다. ADB를 실행하기 위해 SDK 플랫폼 도구가 필요합니다.그리고 터미널이 그 위치를 알 수 있어야 합니다.
Windows, macOS, Linux에서 가장 깨끗한 설정은 동일합니다:
- Google에서 Platform Tools를 다운로드하세요. 압축 파일을 안정적인 위치에 압축 해제하세요.
- 폴더를 PATH에 추가하여 터미널 창에서 어디서나
- 작동하도록 하세요. 새로운 __CAPGO_KEEP_0__ 기기를 설정할 때, 이
adb설정은 도움이 될 것입니다.
If you’re setting up a Capacitor machine from scratch, this 안드로이드 앱의 Capacitor 설정 가이드 은 더 광범위한 도구 체인에 유용한 동반자입니다.
터미널을 사용하여 명령어가 사용 가능한지 확인하세요:
adb version
버전이 반환되는 대신 “명령어를 찾을 수 없음”이 반환되면 잘 진행 중입니다.
몇 가지 플랫폼에 특정한 습관이 도움이 됩니다:
- Windows: Platform Tools 폴더를 변경되지 않는 경로에 넣고 환경 변수에 폴더 경로를 추가하세요.
- macOS: shell 프로파일에 폴더 경로를 추가하세요.
.zshrc. - Linux: shell config에 폴더 경로를 추가하고 shell을 다시 로드하세요.
장치에서 올바른 설정을 활성화하세요.
장치 측면도 중요합니다. 중요한 전제 조건은 USB 디버깅을 활성화하는 것입니다. USB 디버깅 통해 개발자 옵션, 빌드 번호를 7번 탭하여 활성화합니다.Xiaomi 장치의 MIUI에서 USB 디버깅을 활성화하려면 USB를 통해 설치, ADB 설정에 대한 이.
dev.to
- 참고 자료를 참조하세요. 그럼 짧은 체크리스트가 남습니다: __CAPGO_KEEP_0__
- __CAPGO_KEEP_0__ 7번을 7번 클릭하세요. __CAPGO_KEEP_0__을 활성화하세요:
- ADB가 필요로 하는 설정입니다. __CAPGO_KEEP_0__를 주의 깊게 지켜보세요.
- Xiaomi는 classic 예시입니다. __CAPGO_KEEP_0__으로 신뢰할 수 있는 케이블로 연결하세요.
충전 전용 케이블은 시간을浪費합니다.
폰의 프롬프트도 케이블과 마찬가지로 중요합니다. 'USB 디버깅을 허용합니까?'를 놓치면 컴퓨터는 장치를 볼 수 있지만 ADB는 여전히 허용되지 않습니다.
Android에서 컴퓨터와 신뢰할 수 있는지 여부를 묻는 첫 번째 연결 시, 이를 수락하고 개발용 컴퓨터라면 영구적으로 허용하세요. 그럼으로써 설치 경로가 단축됩니다. 설치 경로가 단축된 후, 다음 명령어의 성공 가능성을 확인하는 단일 체크를 건너뛰는 것은 일반적인 실수입니다.
ADB 장치 연결 상태를 터미널에 표시하는 Dell 노트북과 함께 연결된 Android 스마트폰이 옆에 있습니다.
설치하기 전에 장치 확인하세요.
먼저 이 명령어를 실행하세요:
adb devices
연결된 시리얼 번호와 건강한 장치 상태를 확인하고 싶습니다. 만약 장치가 비인증으로 나타나면, 그 상태를 고치기 전에 설치를 시도하지 마세요.
디버그, QA, 릴리즈 후보 출력을 처리하는 팀에게는, 어떤 종류의 빌드를 푸시하는지 명확하게 하기에도 도움이 됩니다. 이 빌드 종류에 대한 모바일 앱 빌드 종류 는 폴더에 비슷한 이름의 APK가 많을 때 좋은 참고 자료입니다.
설치 명령어를 실행하세요.
기본 명령어는 간단합니다:
adb install path/to/your-app.apk
경로에 공백이 포함되어 있다면, 쉘에서 따옴표로 감싸세요. APK가 같은 폴더에 있다면, 명령어는 thậm chí 더 짧아집니다:
adb install app-debug.apk
정상적인 실행은 터미널에 스트리밍 설치 메시지와 성공 메시지를 보여주면 됩니다. 그게 바로 설치가 성공적으로 완료되었고 패키지 매니저가 APK를 받아들이고 설치를 완료했음을 확인하는 출력입니다.
실행 흐름을 확인하고 싶다면, 이 walkthrough를 참조하세요:
스트리밍 설치가 수동 푸시와 패키지 매니저 설치보다 좋은 이유는?
아래에서 보면 adb install 는 파일을 복사하는 것보다 더 많은 일을 하고 있습니다. 내부적으로는 APK를 /data/local/tmp, pm install를 호출하고, 그리고 임시 파일을 삭제합니다. 스트리밍 워크플로우는 와 같은 터미널 출력에 반영됩니다. 예를 들어 “스트리밍 설치 중” 를“성공”
로 표시합니다. 이는 adb push 에서 설명한 구현 세부 사항에 따라 요약됩니다. 이것은
- 와 를 호출하는 오래된 두 단계의 습관보다 더 깨끗합니다. 일상적인 실무에서 스트리밍 설치에는 몇 가지 이점이 있습니다:
- 장치 잡기: 임시 파일이 자동으로 삭제됩니다.
- 오류 가능성 감소: 파일을 실수로 푸시하고 다른 파일을 설치하는 일이 없습니다.
Capacitor를 사용할 수 있다면 사용하세요. 수동 푸시 및 셸 설치는 특수한 경우에 유용하지만, 일반적인 앱 테스트의 기본 경로가 아닙니다.
adb installADB 설치 APK 워크플로우의 핵심 루프는 다음과 같습니다: 장치 확인, 설치 실행, 성공 확인, 앱 실행, 다음 빌드 후 반복.
ADB 설치 플래그를 마스터하는 방법
기본 명령어는 APK를 전화기에 가져옵니다. 플래그는 개발을 위한 실제 프로세스인지, 개발자가 저항하는지 결정합니다.
빠른 워크플로우를 위한 일반적인 ADB 설치 플래그와 사용 방법
플래그
| 설명 | __CAPGO_KEEP_0__ | 일반적인 사용 사례 |
|---|---|---|
-r |
기존 앱을 재설치하여 앱 데이터를 유지할 수 있는 경우에만 앱 데이터를 유지합니다. | 일일 디버그 빌드에 대한 반복 |
-d |
버전 다운그레이드를 허용합니다. | 롤백 시나리오 또는 이전 빌드 테스트 |
-g |
설치 시간에 런타임 권한을 부여합니다. | 카메라, 저장소, 위치 및 유사한 기능을 테스트할 때 테스트 속도를 높입니다. |
정규 개발에서 가장 중요한 플래그는 -r.
기존에 설치된 패키지를 업데이트할 때 새로운 APK를 충돌하는 설치 시도로 대신하여 대체할 수 없기 때문에 자주 실패하는 경우가 많습니다. 따라서 많은 개발자들은 adb install -r app-debug.apk 기본적인 근육 기억을 만들 것입니다.
일상 개발에서 가장 중요한 플래그는
-r Capacitor 앱을 테스트하고 몇 시간에 걸쳐 여러 번 빌드를 다시 빌드하는 경우, 앱을 매번 삭제하는 것은 느리고 유용한 지역 상태를 삭제합니다. 재설치하면 계속 진행할 수 있습니다.
-d 실제로 필요할 때는 더 상황에 맞춰서 사용하지만, 필요할 때는 정말 필요합니다. 이 기능은 회귀 테스트, 롤백 연습, 또는 이전 빌드가 레거시 데이터베이스를 열 수 있는지 확인하는 데 유용합니다.
-g 이 기능은 품질 향상 플래그입니다. 앱이 권한을 조작하는 초기 단계에서 자동 승인 기능은 장치 설정에서 반복적인 탭을 제거합니다. 권한 테스트를 대신하는 것은 아니지만, 설치 및 런칭을 빠르게 진행할 때 유용합니다.
몇 가지 combination이 자주 사용됩니다:
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버전 이동이 테스트 중인 경우에만.
CLI 측 Capacitor 개발에 대한 더 광범위한 리프레시를 원한다면, 이 Capacitor __CAPGO_KEEP_1__ 명령어와 수정사항에 대한 안내서를 참조하세요. Capacitor CLI 일반 명령어와 수정사항에 대한 안내서 ADB 중심 워크플로우와 잘 맞습니다.
일반적인 설치 오류 해결
ADB는 신뢰할만큼 안정적이므로 반복적인 실패는 일반적으로 특정 문제를 나타냅니다. 문제를 해결하려면 설치 오류를 무작위로 처리하지 마십시오. 일반적으로 인증, 패키지 교체 및 패키지 식별성과 관련된 오류가 집중됩니다.
장치가 인증되지 않은 경우 표시됨
증상:
adb devices표시unauthorized
원인: 전화가 컴퓨터를 신뢰하지 않았거나, 프롬프트가 취소되었습니다.
이 순서로 해결하세요:
- __CAPGO_KEEP_0__ 장치와 잠금 화면을 해제하세요.
- __CAPGO_KEEP_1__ 휴대폰에서 RSA 인증 요청 화면을 찾으세요.
- __CAPGO_KEEP_2__휴대폰에서 인증 요청을 승인하세요.
- 개발 머신에 대해 항상 허용 옵션을 사용하는 것이 좋습니다.
adb kill-server
adb start-server
__CAPGO_KEEP_3__
ADB 서버를 재시작하세요: __CAPGO_KEEP_4__
터미널에서 문제를 기술적으로 보이게 하지만 실제로 문제는 휴대폰 자체에 있습니다.
INSTALL_FAILED_ALREADY_EXISTS
패키지가 이미 존재할 때 증상: __CAPGO_KEEP_5__.
가장 빠른 해결책은:
adb install -r app-debug.apk
업그레이드 대신 깨끗한 설치가 필요하다면 먼저 제거하십시오:
adb uninstall your.package.name
정기적인 반복을 위해 재설치 경로를 사용하십시오. 제거는 지역 앱 상태를 지우거나 첫 번째 실행 동작을 확인할 때만 사용하십시오.
서명과 이전 패키지 상태가 충돌할 때
일부 실패는 APK 파일 자체에 관한 것이 아닙니다. 그것은 패키지에 대한 Android가 기억하는 것입니다.
두 가지 패턴이 자주 나타납니다:
- 서명 불일치: 설치된 앱이 APK를 설치하려는 키와 다른 키로 서명된 경우
- 중복 패키지 상태: 제거 후에도 패키지 잔해가 남아 다음 설치를 막을 수 있습니다.
두 번째 경우가 특히 frustrate 할 수 있습니다. 성공적으로 제거된 것처럼 보이지만, 새로운 Android 버전에서 유산된 제거 동작은 패키지 상태를 남길 수 있습니다. INSTALL_FAILED_DUPLICATE_PACKAGE이것은 legacy 제거 동작에 대한 설명입니다.
실질적인 디버깅 흐름은 다음과 같습니다.
- 먼저 패키지의 정체성을 확인하세요. 패키지 이름이 당신이 생각하는 이름인지 확인하세요.
- 다음으로 서명 일관성을 확인하세요. debug-signed와 release-signed 빌드는 서로 깨끗하게 대체되지 않습니다.
- 그 다음 설치된 패키지를 삭제하세요. 일반적인アン인스톨 경로를 사용하세요.
- 오류가 지속된다면. 오류가 지속된다면, 그것은 패키지 상태가 오래된 것이고, 랜덤 ADB 오류가 아니라는 것을 기억하세요.
debug APK가 일반 개발 도구를 통하지 않고 분배되는 경우, 또 다른 문제가 있습니다. 일부 팀에서는 ADB를 통해 동일한 빌드를 설치할 수 있지만, 메시징 또는 이메일을 통해 수동으로 시드 로드 될 때 빌드가 실패하는 것을 발견합니다. 그럴 때는 Android의 debug-signed 앱에 대한 컨텍스트에 의한 검증과 관련이 있습니다. 그에 대한 자세한 내용은 Android에서 앱 설치 오류를 해결하는 방법에 대한 지침서를 참조하세요.실제로 QA 팀은 내부 디버깅 배포를 위해 ADB를 사용하는 것이 일반적인 수동 시드 로드에 의존하는 것보다 더 좋습니다.
Field note: ADB를 통해 설치가 성공했지만 수동으로 설치를 시도했을 때 설치가 실패하는 경우, APK가 깨진 것은 아님을 가정하지 마세요. signing context와 install path를 먼저 확인하세요.
Capacitor 프로젝트에서 native 및 web layer에서 빌드 및 배포 문제가 지속적으로 발생하는 경우, 이 Capacitor에서 발생하는 Android 빌드 오류를 해결하는 데 도움이 되는 이 안내서를 가까이 두세요. Capacitor 개발자를 위한 완전한 예시 __CAPGO_KEEP_0__ 프로젝트에서 터미널 루프는 일반적으로 짧습니다. native 파일을 동기화하고 Android 앱을 빌드하고 결과 APK를 연결된 장치에 푸시하는 것이 일반적입니다. Android Studio를 열 필요가 없으며 native 디버깅이 필요할 때만 열어주세요.
A Complete Example for Capacitor Developers
Capacitor 프로젝트에서 debug APK를 일반 Android 빌드 단계에서 빌드한 다음, 대체를 허용한 상태로 설치하세요.
이 워크플로는 많은 팀이 사용하는 이유 중 하나입니다. feedback 루프가 짧아지기 때문입니다. CapacitorJS 앱에서 팀이 차등 업데이트를 배포할 때도 이 워크플로를 사용합니다.
npx cap sync android
CapacitorJS 앱에서 팀이 차등 업데이트를 배포할 때도 이 워크플로를 사용합니다.
adb install -r android/app/build/outputs/apk/debug/app-debug.apk
CapacitorJS 앱에서 팀이 차등 업데이트를 배포할 때도 이 워크플로를 사용합니다. CapacitorJS 앱에서 팀이 차등 업데이트를 배포할 때도 이 워크플로를 사용합니다. CapacitorJS 앱에서 팀이 차등 업데이트를 배포할 때도 이 워크플로를 사용합니다. adb install 이는 매우 중요합니다. IBM 연구에서 Android 기반 모바일 팀의 78%가 실시간 JavaScript 및 CSS 수정을 위해 Play Store 제출보다 이를 선호한다고 밝혔습니다. 이에 대한 자세한 내용은 이 비디오 참조를 통해 확인할 수 있습니다. 이 비디오 참조는 기업 워크플로우에서 ADB 기반 APK 설치에 대한 내용을 다룹니다. Android 기반 모바일 팀의 78%가 Play Store 제출보다 ADB 기반 APK 설치를 선호한다고 밝혔습니다. 이 비디오 참조는 ADB 기반 APK 설치에 대한 내용을 다룹니다. 이 설치 가이드는 프로젝트 설정에 대한 워크플로우를 설정하고 있는 경우에 적합합니다..
이 설치 가이드는 프로젝트 설정에 대한 워크플로우를 설정하고 있는 경우에 적합합니다. Capacitor CLI installation guide __CAPGO_KEEP_0__는 앱 스토어 리뷰를 기다리지 않고 JavaScript, CSS, config, 및 asset 수정을 배포하고 싶은 팀에게 적합합니다.
Capacitor는 앱 스토어 리뷰를 기다리지 않고 JavaScript, CSS, config, 및 asset 수정을 배포하고 싶은 팀에게 적합합니다. Capgo Martin Donadieu
