일반 업데이트 문제
설치 단계 및 이 플러그인의 전체 마크다운 가이드가 포함된 설정 프롬프트 복사하기.
업데이트 체크가 실패했을 때, Capgo 일반적으로 Capgo을 반환합니다. error code와 함께 message in the /updates 응답. 이 페이지는 가장 일반적인 실패와 가장 빠른 수정 방법을 설명합니다.
먼저 읽으세요
제목 ‘먼저 읽으세요’no_new_version_available정상 상태이며, 실패가 아닙니다.- 많은 ‘업데이트가 발견되었지만 적용되지 않았습니다’ 보고는 캐시 지연이 아닌 정책/구성 거부로 특히 응답이 명시적일 때 발생합니다.
errorcode. - 사용
npx @capgo/cli@latest app debug문제를 재현하는 동안 요청/응답 세부 정보를 보려면
일반적인 실패 코드
제목 ‘일반적인 실패 코드’disable_auto_update_to_major
disable_auto_update_to_major원인
채널이 주요 업그레이드를 차단하고 (disable_auto_update = major) 디바이스의 기본 버전보다 높은 대상 버전입니다.
일반적인 증상
version: 1.0.8 with old: 0.0.0 디바이스가 기본 버전 0.0.0, 따라서 주요 업그레이드는 거부됩니다.
해석 방법
백엔드에서는 디바이스 기본 버전과 대상 버전을 비교하여 주요 버전을 비교합니다. old and 대상 version.
- If target is
1.0.1기본선 major는1(예를 들어1.0.0). - 목표가
10.0.1기본선 major는10(예를 들어10.0.0).
Fix 옵션 A (권장): 기기 기본선 major
설정 plugins.CapacitorUpdater.version 에서 capacitor.config.* 그것은 MAJOR 배포하고 싶은 번들 MAJOR와 일치하도록 (예를 들어 1.0.0 for 1.0.1, 10.0.0 그 다음에 설치된 앱에 이 설정을 적용하세요: 10.0.1).
실행
- Rebuild and reinstall the native app.
npx cap sync. - Fix option B: channel 정책을 완화하세요
Allow cross-major auto-updates in channel settings (only if that rollout strategy is intentional).
관련 문서:
버전 대상 설정: 주요 버전 간 자동 업데이트 비활성화
disable_auto_update_to_minor / disable_auto_update_to_patch
원인채널 정책이 더 엄격합니다 (
Fix option B: channel 정책을 완화하세요minor 또는 제공되는 업데이트보다 최신 버전입니다. patch수정
현재 정책과 호환되는 번들을 업로드하거나
- __CAPGO_KEEP_0__에 있는 채널 정책을 변경합니다.
- change channel policy in dashboard/CLI.
채널: 자동 업데이트 전략 비활성화
disable_auto_update_to_metadata
원인채널이 메타데이터 기반 타겟팅을 사용하고 (
) 디바이스의 기준이 요구되는 것보다 낮습니다.version_number수정 min_update_version.
Related docs:
- 기기 기본선 (
CapacitorUpdater.version)과 설치된 네이티브 앱 버전을 일치시키거나 - 조정
min_update_version/ 채널 전략.
관련 문서:
disable_auto_update_under_native
제목 ‘disable_auto_update_under_native’원인
채널이 네이티브 기본선 아래로의 다운그레이드를 방지합니다.
해결
- 네이티브 기본선보다거나 그 이상의 버전의 배포본을 업로드하거나
- ‘네이티브 아래’ 다운그레이드 보호를 해당 채널에 비활성화합니다.
관련 문서:
cannot_update_via_private_channel
제목: "개인 채널을 통해 업데이트할 수 없습니다"원인
선택된/기본 채널은 장치 자체 할당을 허용하지 않습니다.
해결
- 다른 채널을 사용하여 자체 할당을 허용하거나 채널을 공개/자체 할당을 허용하도록 하세요.
- 관련 문서:
채널: 앱에서 setChannel() 사용
unknown_version_build / semver_error
원인Cause
기기 기본 버전이 누락되거나( ) 또는 유효하지 않은 semverunknownFix 설정.
유효한 semver
- 예를 들어
plugins.CapacitorUpdater.version기기와 네이티브 앱을 동기화하고 다시 빌드합니다. 관련 문서: 채널: 버전 관리 및 채널1.2.3. - 문제 해결: 업데이트 적용되지 않음
__CAPGO_KEEP_0__
unsupported_plugin_version
지원되지 않는 플러그인 버전원인
업데이터 플러그인의 버전이 현재 백엔드 요구 사항에 맞지 않습니다.
수정
- 업그레이드
@capgo/capacitor-updater. - 실행
npx cap sync. - 네이티브 앱을 재설치합니다.
disabled_platform_ios / disabled_platform_android
지원되지 않는 플랫폼원인
채널에서 해당 플랫폼 업데이트를 비활성화했습니다.
수정
- 채널에서 플랫폼 토글을 활성화하세요.
disable_prod_build / disable_dev_build / disable_device / disable_emulator
제한된 빌드 / 제한된 개발 빌드 / 제한된 장치 / 제한된 에뮬레이터원인
채널은 현재 빌드 유형 또는 런타임 대상이 허용되지 않습니다.
수정
- 채널 옵션 (, )을 테스트 대상과 일치시킵니다.
allow_prod,allow_dev,allow_device,allow_emulatorkey_id_mismatch
key_id_mismatch
원인앱 구성과 번들 암호화 워크플로우의 디바이스 키와 암호화 키가 다릅니다.
수정
앱 구성과 번들 암호화 워크플로우의 암호화 키/공개 키를 동일하게 사용합니다.
- no_channel / null_channel_data
no_channel / null_channel_data
원인원인
장치에 대한 유효한 채널이 해결되지 않았습니다.
수정
- 클라우드 기본 채널을 설정하거나
- 테스트 빌드의 경우
defaultChannel장치에 대한 채널 오버라이드 할당 - 관련 문서:
채널
on_premise_app
원인백엔드에서 HTTP 429이 반환되었습니다.
Fix on_premise_app. 이 상황이 세 가지 경우에 발생합니다.
- Capgo에 등록된 App ID가 존재하지 않습니다. — 기기에서 전송된 값이 등록되지 않았기 때문에 백엔드에서 해당 값을 알 수 없습니다.
app_idApp이 내부 서버로 설정되어 있습니다. - — App이 존재하지만 업데이트 설정이 내부 서버로 구성되어 __CAPGO_KEEP_0__ 클라우드 엔드포인트는 해당 App을 제공하지 않습니다. — the app exists but is configured for self-hosted updates, so the Capgo cloud endpoint refuses to serve it.
- — App의 조직이 더 이상 활성 구독을 보유하고 있지 않습니다. 일반적인 오류
__CAPGO_KEEP_1__와 동일한 오류가 반환됩니다.
(in plugins.CapacitorUpdater.appId ) 또는 __CAPGO_KEEP_0__ 대시보드에 등록된 App ID와 일치하지 않는 오류입니다. 백엔드는 “알 수 없는 App”과 “내부 서버 App”을 구분할 수 없기 때문에 동일한 오류를 반환합니다. capacitor.config.ts) or a mismatch with the app ID registered in the Capgo dashboard. The backend cannot distinguish “unknown app” from “on-premise app”, so it returns the same error code.
수정
- 설정된 __CAPGO_KEEP_0__ 대시보드 (대소문자 구분)에서 정확히 일치하는지 확인합니다.
app_idmatches exactly what is shown in the Capgo dashboard (case-sensitive). - 앱이 자체 호스팅 업데이트 엔드포인트 대신 __CAPGO_KEEP_0__ 클라우드 URL 대신 설정되어 있다면
npx @capgo/cli@latest app add. - 계획이 만료된 경우, 계획을 갱신하거나 업그레이드하세요.
plugins.CapacitorUpdater.updateUrlto your self-hosted update endpoint instead of the Capgo cloud URL. - ‘빠른 진단 체크리스트’라는 섹션
빌드에 대한 앱 ID 및 채널이 정확한지 확인하세요.
확인- 설치된 네이티브 앱 버전과 일치하는지 확인합니다.
- __CAPGO_KEEP_0__
CapacitorUpdater.version__CAPGO_KEEP_0__ - Confirm channel policy (
disable_auto_update) matches intended rollout. - Confirm platform/build target toggles allow this device.
- Run
npx @capgo/cli@latest app debugand read backend error code.
Need more help?
Section titled “Need more help?”Keep going from Common Update Problems
If you are using]} (Note: Korean translation of the given text) 1. Confirm channel policy (, ) matches intended rollout. -> 2. 채널 정책 (, )이 예상된 롤아웃과 일치하는지 확인합니다. 3. Confirm platform/build target toggles allow this device. -> 4. 플랫폼/빌드 대상 토글이 이 기기를 허용하는지 확인합니다. 5. Run -> 6. 실행 7. and read backend error __CAPGO_KEEP_0__. -> 8. 및 백엔드 에러 __CAPGO_KEEP_0__를 읽습니다. 9. Need more help? -> 10. 더 도움이 필요하십니까? 11. Section titled “Need more help?” -> 12. “더 도움이 필요하십니까?”라는 제목의 섹션 13. Troubleshooting -> 14. 문제 해결 15. How to get support -> 16. 지원 방법 17. Keep going from Common Update Problems -> 18. 일반 업데이트 문제에서 계속 진행 19. Section titled “Keep going from Common Update Problems” -> 20. “일반 업데이트 문제에서 계속 진행”라는 제목의 섹션 21. If you are using -> 22. 만약에 사용 중이시면 (Note: The above translations are provided as a general guideline and may vary based on the specific context and requirements.) The final JSON object with translations is: { 일반적인 업데이트 문제 __CAPGO_KEEP_0__을 __CAPGO_KEEP_1__과 연결하여 @capgo/capacitor-업데이터를 사용하여 @capgo/capacitor-업데이터를 사용하여 capgo 네이티브 기능을 사용하는 경우 Capgo 플러그인 디렉토리 Capgo 플러그인 디렉토리에서 Capgo 제품 워크플로우를 사용하는 경우 Capacitor 플러그인에 의해 Capgo으로 Capacitor 플러그인에 의해 Capacitor 제품 워크플로우를 사용하는 경우 Capgo의 구현 세부 정보를 사용하는 경우 플러그인을 추가하거나 업데이트하는 경우 플러그인을 추가하거나 업데이트하는 경우의 구현 세부 정보를 사용하는 경우 아이오닉 엔터프라이즈 플러그인 대안 아이오닉 엔터프라이즈 플러그인 대안의 제품 워크플로우를 사용하는 경우