카드가 필요하지 않습니다

업데이트 확인이 실패할 때, Capgo 일반적으로 Capgo과 함께 error code message in the /updates 응답

이 문서를 먼저 읽으세요

• no_new_version_available 정상 상태입니다. 오류가 아닙니다.
• 업데이트가 발견되었지만 적용되지 않은 많은 보고서는 캐시 지연 때문이 아니라 정책/구성 거부 때문입니다. 특히 응답에 명시적인 error code
• Use npx @capgo/cli@latest app debug 문제를 재현하는 동안 사용하세요

일반적인 실패 코드

provider_infrastructure_request_blocked

앱이

앱이 문제를 겪고 있습니다. 블록 제공자 인프라 요청 활성화되어 있는 경우, 요청은 알려진 Google 또는 Apple 데이터 센터 IP 범위에서 시작된 경우 Capgo이 이 요청을 블록합니다. /updates, /stats, 및 /channel_self 을 통해 제공자에서 오는 트래픽이 장치 트래픽으로 처리되는 것을 방지하기 위해.

수정

• 물리 장치에서 일반 사용자 네트워크에서 업데이트를 다시 재현하십시오.
• 이 보호 기능이 활성화된 동안 업데이트어, 통계, 또는 채널-자신의 확인을 위해 cloud-hosted 프로브 또는 제공자 데이터 센터 러너를 사용하지 마십시오.
• 그렇다면 트래픽이 의도적일 경우, 앱의 정보 탭을 열고 블록 제공자 인프라 요청을 끕니다. 테스트가 완료되면 다시 활성화하십시오.

새로운 앱은 기본적으로 이 보호 기능이 활성화되어 있습니다. 이전에 설정이 도입되기 전에 생성된 앱은 활성화할 때까지 이 기능이 비활성화 상태로 유지됩니다.

응답 세부 정보

• /updates 업데이터 응답 계약을 유지하고 HTTP 200. 그 몸체에는 error, message, kind: "blocked", 그리고 provider ("google" 또는 "apple").
• /stats 또는 /channel_self Live Update 429 code. 동일한 오류가 발생하는 경우에 대해 의도적으로 정책 차단으로 간주하고, 일시적인 재시도 조건으로 간주하지 마십시오.

disable_auto_update_to_major

GitHub

Capgodisable_auto_update = major)과 대상 버전의 주요 버전이 기기 기준 버전보다 높습니다.

일반적인 증상

version: 1.0.8 with old: 0.0.0 기기 기준 버전을 보고 있으므로 0.0.0이러한 경우 주요 업그레이드는 거부됩니다.

해석 방법

백엔드에서는 기기 기준 버전과 대상 버전을 비교하여 old 대상이 version.

• 기기 기준 버전의 주요 버전은 1.0.1(예를 들어 1 예를 들어 1.0.0).
• 기기 기준 버전의 주요 버전은 10.0.1, 기본 버전의 메이저 버전은 10 (for example) 10.0.0).

장치 기준점 주요 버전 맞추기

설정 plugins.CapacitorUpdater.version 이러한 capacitor.config.* MAJOR bundle MAJOR (for example) 1.0.0 그렇다면 1.0.1, 10.0.0 그렇다면 10.0.1).

이러한

1. Run npx cap sync.
2. 재빌드 및 네이티브 앱 재설치.

option B: 채널 정책 완화

채널 설정에서 크로스-메이저 자동 업데이트를 허용하십시오 (만약 그 롤아웃 전략이 의도적이라면).

관련 문서:

• 버전 대상 설정: 메이저 버전을 건너 뛰어 자동 업데이트를 비활성화
• 채널: 자동 업데이트 전략 비활성화

disable_auto_update_to_minor / disable_auto_update_to_patch

원인

채널 정책이 더 엄격합니다 (minor 또는 patchHTML 텍스트 조각. HTML 텍스트 조각은 더 긴 Capgo UI 문자열 (부모 키 `alternatives_cta_questions`)에서 나온 것입니다. 페이지/영역: Capacitor live-update 대안 비교 페이지. 역할: 장기 마케팅 또는 법률 문단. 보존: Capgo 제품/브랜드 및 개발자 용어를 정확하게. 메시지 키 `alternatives_cta_questions` (대안 CTA 질문). | HTML 텍스트 조각은 더 긴 Capgo UI 문자열 (부모 키 `appflow_cta_questions`)에서 나온 것입니다. 페이지/영역: Appflow 비교/이동 마케팅 복사본. 역할: 장기 마케팅 또는 법률 문단. 보존: Capgo 제품/브랜드 및 개발자 용어를 정확하게. 메시지 키 `appflow_cta_questions` (Appflow CTA 질문). | HTML 텍스트 조각은 더 긴 Capgo UI 문자열 (부모 키 `capwesome_cta_questions`)에서 나온 것입니다. 페이지/영역: Capawesome 비교 페이지. 역할: 장기 마케팅 또는 법률 문단. 보존: Capgo 제품/브랜드 및 개발자 용어를 정확하게. 메시지 키 `capwesome_cta_questions` (Capwesome CTA 질문). | HTML 텍스트 조각은 더 긴 Capgo UI 문자열 (부모 키 `consulting_faq_subtitle`)에서 나온 것입니다. 페이지/영역: 컨설팅 서비스 페이지. 역할: 섹션 서브 타이틀 또는 태그 라인. 보존: Capgo 제품/브랜드 및 개발자 용어를 정확하게. 메시지 키 `consulting_faq_subtitle` (컨설팅 FAQ 서브 타이틀). | 페이지/영역: Appflow 비교/이동 마케팅 복사본. 역할: 짧은 UI 레이블 또는 네비게이션 아이템. 보존: Capgo 제품/브랜드 및 개발자 용어를 정확하게. 메시지 키 `appflow_plugins_or` (Appflow 플러그인 또는).

• minor 채널 정책이 더 엄격합니다 (version_build. 예시: 1.2.3 -> 1.3.0 은 차단되어 있습니다.
• patch 은 주요, 부, 패치 번호 변경을 포함하여 모든 변경을 차단합니다. 단, 접미사 변경만 허용되며 version_build의 접미사는 동일하게 유지되며, 예를 들어 MAJOR.MINOR.PATCH 또는 1.0.0-beta.1 -> 1.0.0-beta.2 or 1.0.0+build.1 -> 1.0.0+build.2.

수정

• 현재 정책과 호환되는 번들을 업로드하거나
• change channel policy in dashboard/CLI.

관련 문서:

• 채널: 자동 업데이트 전략 비활성화

disable_auto_update_to_metadata

원인

채널은 메타데이터 기반 타겟팅 (version_number)을 사용하고 기기 기본선은 요구된 min_update_version.

수정

• 기기 기본선 (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

원인

장치 기본 버전이 누락되거나 (unknown) 또는 유효하지 않은 semver.

해결

• 설정 plugins.CapacitorUpdater.version to a 유효하지 않은 semver 로 설정하십시오. 1.2.3.
• 네이티브 앱을 동기화하고 재구축하세요.

관련 문서:

• Channels:
• Troubleshooting:

unsupported_plugin_version

Cause

업데이터 플러그인 버전이 현재 백엔드 요구 사항에 맞지 않습니다.

Fix

• Upgrade @capgo/capacitor-updater.
• Run 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_emulator제목: "key_id_mismatch"

key_id_mismatch

원인

앱 번들 암호화 키와 장치 키가 다릅니다.

수정

• 앱 구성과 앱 번들 암호화 워크플로우에서 동일한 암호화 키/공개 키를 사용하십시오.

no_channel / null_channel_data

원인

장치에 대한 유효한 채널이 해결되지 않았습니다.

수정

• 클라우드 기본 채널을 설정하거나
• 테스트 빌드에서 또는 defaultChannel 장치에 대한 채널 오버라이드 할당하십시오.
• 관련 문서:

Fix

• 채널

on_premise_app

원인

백엔드에서 HTTP 429이 반환되었습니다. on_premise_app이러한 상황이 세 가지 있습니다.

1. 앱 ID가 Capgo에 존재하지 않습니다. 이 경우는 app_id 앱이 전송된
2. 앱이 온프레미스로 표시되어 있습니다. 앱이 존재하지만 자체 호스팅 업데이트를 위한 구성이되어 Capgo 클라우드 엔드포인트가 이를 제공하지 않습니다.
3. 조직 플랜이 취소되었습니다. 앱의 조직이 더 이상 활성 구독을 가지고 있지 않습니다.

일반적인 오류

애플리케이션 ID에 대한 plugins.CapacitorUpdater.appId (in capacitor.config.ts) 또는 Capgo 대시보드에 등록된 애플리케이션 ID와 일치하지 않는 경우입니다. 백엔드는 '알 수 없는 애플리케이션'과 '온프레미스 애플리케이션'을 구분할 수 없으므로 code과 같은 오류를 반환합니다.

수정

• 확인 app_id Capgo 대시보드에 표시된 것과 정확히 일치하는지 확인하세요 (대소문자 구분).
• 앱이 아직 등록되지 않았다면, 실행 npx @capgo/cli@latest app add.
• 애플리케이션이 의도적으로 온프레미스 애플리케이션인지 확인하세요. plugins.CapacitorUpdater.updateUrl Capgo 클라우드 URL 대신 Capgo에서 제공하는 업데이트 엔드포인트를 설정하세요.
• 조직 플랜이 만료된 경우 플랜을 갱신하거나 업그레이드하세요.

빠른 진단 체크리스트

1. 빌드에 대한 앱 ID 및 채널이 정확한지 확인하세요.
2. 확인 CapacitorUpdater.version 설치된 네이티브 앱 버전과 일치하는지 확인하세요.
3. 채널 정책이 의도한 롤아웃과 일치하는지 확인하세요.disable_auto_update플랫폼/빌드 대상 설정이 이 기기에 허용하는지 확인하세요.
4. 실행
5. Run npx @capgo/cli@latest app debug and read backend error code.

채널 정책이 의도한 롤아웃과 일치하는지 확인하세요.

• Troubleshooting
• 지원 방법

일반 업데이트 문제에서 계속

이러한 기능을 사용 중이라면 일반 업데이트 문제 @__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-업데이터를 사용하여 native 기능을 사용하는 @capgo/capacitor-업데이터 Capgo native 기능을 사용하는 @capgo/capacitor-업데이터에 대한 native 기능을 사용합니다. Capgo 플러그인 디렉토리에서 제품 워크플로우 Capgo 플러그인들에 의해 __CAPGO_KEEP_1__ Capacitor 플러그인들에 의해 Capgo의 구현 세부 사항 Capacitor 플러그인 구현 세부 사항을 위해 Capgo에 의해 구현됩니다. 플러그인 추가 또는 업데이트 플러그인 추가 또는 업데이트 구현 세부 사항에 대해 아이오닉 엔터프라이즈 플러그인 대체 아이오닉 엔터프라이즈 플러그인 제품 워크플로에 대해