공통 업데이트 문제

업데이트 체크가 실패할 때, Capgo는 일반적으로 error code와 message 에서 /updates 응답입니다. 이 페이지는 가장 일반적인 실패와 가장 빠른 수정 방법을 설명합니다.

먼저 읽어보세요.

• no_new_version_available 정상 상태이며, 실패는 아닙니다.
• 많은 '업데이트가 발견되었지만 적용되지 않았습니다.' 보고는 정책/구성 거부 rather 보다는 캐시 지연 때문입니다. 특히 응답에 명시적인 것이 포함된 경우 error code.
• __CAPGO_KEEP_0__. 사용하여 문제를 재현하는 동안 요청/응답 세부 정보를 확인하세요. npx @capgo/cli@latest app debug 일반적인 실패 코드

제목: 일반적인 실패 코드

provider_infrastructure_request_blocked

앱이

제공자 인프라스트럭처 요청을 차단하고 Google 또는 Apple 데이터 센터 IP 범위에서 요청이 시작된 경우 제공자 활성화가 켜져 있습니다. __CAPGO_KEEP_0__은 이러한 요청을 enabled and the request originated from a known Google or Apple datacenter IP range. Capgo blocks these requests on /updates, /stats으로 차단하여 장치 트래픽으로 처리되는 제공자 트래픽을 방지합니다. /channel_self to prevent provider-originated traffic from being treated as device traffic.

수정

• 물리 장치에서 일반 사용자 네트워크에서 업데이트를 재현하십시오.
• 업데이터, 통계, 채널-self 검사와 같은 업데이트를 위한 클라우드 호스팅 프로브 또는 제공자 데이터 센터 러너를 사용하지 마십시오. 이 보호 기능이 활성화된 동안.
• 그런 트래픽이 의도적일 경우, 앱의 정보 탭을 열고 Block provider infrastructure requests. 테스트가 완료되면 다시 활성화하십시오.

새로운 앱은 이 보호 기능이 기본적으로 활성화되어 있습니다. 제공자 설정이 소개되기 전에 생성된 앱은 활성화되지 않은 상태로 유지되며, 활성화해야 합니다.

응답 세부 정보

• /updates 업데이터 응답 계약을 보존하고 HTTP 200. 그 바디는 업데이터 응답 계약을 보존하고 HTTP error, message, kind: "blocked"또는 provider ("google" __CAPGO_KEEP_0__ "apple").
• /stats 메이저 업그레이드를 자동으로 비활성화 /channel_self 정책 429 with the same error code. Treat this as an intentional policy block, not a transient retry condition.

disable_auto_update_to_major

__CAPGO_KEEP_0__

“disable_auto_update_to_major” 섹션disable_auto_update = major원인

채널이 메이저 업그레이드를 차단하고, 대상 패키지의 메이저 버전이 기기 기본 버전보다 높습니다.

version: 1.0.8 일반적인 증상 old: 0.0.0 __CAPGO_KEEP_0__ 0.0.0이러한 주요 업그레이드는 거부됩니다.

해석 방법

백엔드에서 장치 기준점과 목표를 사용하여 주요 버전을 비교합니다. old 목표가 version.

• 기준점의 주요 버전이 1.0.1(예를 들어 1 목표가 1.0.0).
• 기준점의 주요 버전이 10.0.1(예를 들어 10 수정 옵션 A (권장): 장치 기준점의 주요 버전을 맞춤 10.0.0).

설정

__CAPGO_KEEP_0__ plugins.CapacitorUpdater.version 이것은 capacitor.config.* 그것이 그래서 주요 배포하고 싶은 버전의 bundle MAJOR과 일치합니다 (예를 들어 1.0.0 위 1.0.1, 10.0.0 위 10.0.1).

설치된 앱에 이 설정을 적용하세요:

1. 실행 npx cap sync.
2. 자연스럽게 재빌드하고 재설치된 네이티브 앱.

옵션 B: 채널 정책을 완화하세요

채널 설정에서 크로스-메이저 자동 업데이트를 허용하세요 (만약 그 롤아웃 전략이 의도적일 경우에만).

관련 문서:

• 버전 목표 설정: 주요 버전 간 자동 업데이트 비활성화
• 채널: 자동 업데이트 전략 비활성화

disable_auto_update_to_minor / disable_auto_update_to_patch

원인

채널 정책이 제공되는 업데이트보다 더 엄격합니다 (minor 또는 patch).

• minor 대상 번들에 다른 주요 또는 부가 버전이 있는 경우 기기 기본선에 따라 블록됩니다 (version_build). 예시: 1.2.3 -> 1.3.0 블록됩니다.
• patch 대상 번들에 주요, 부가 또는 패치 번호 변경이 발생하면 version_build. 단, 접미사 변경만 허용됩니다. MAJOR.MINOR.PATCH __CAPGO_KEEP_0__ 1.0.0-beta.1 -> 1.0.0-beta.2 or 1.0.0+build.1 -> 1.0.0+build.2.

Fix

• __CAPGO_KEEP_0__을 업로드하거나
• 설정CLI

관련 문서:

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

disable_auto_update_to_metadata

원인

채널이 메타데이터 기반 타겟팅을 사용하고( ) 기기 기준선이 요구된 것보다 낮습니다.version_numberFix min_update_version.

__CAPGO_KEEP_0__

• 기기 기본선 (CapacitorUpdater.version)을 설치된 네이티브 앱 버전과 일치시키거나
• 조정 min_update_version / 채널 전략.

관련 문서:

• 채널: Auto Update 전략 비활성화

disable_auto_update_under_native

원인

채널이 네이티브 기본선 아래로 다운그레이드를 방지합니다.

수정

• 네이티브 기본선보다 높거나 같은 버전의 배포본을 업로드하거나
• ‘네이티브 아래’ 다운그레이드 보호를 해당 채널에 비활성화합니다.

관련 문서:

• 버전 목표: 자동 다운그레이드 방지

cannot_update_via_private_channel

원인

선택된/기본 채널은 장치 자체 할당을 허용하지 않습니다.

해결

• 다른 채널을 사용하여 자체 할당을 허용하거나 채널을 공개/자체 할당을 허용하도록 하세요.
• 관련 문서:

채널: 앱에서 setChannel() 사용하기

• 제목: "알 수 없는 버전 빌드 / semver 오류"

unknown_version_build / semver_error

해결

기기 기본 버전이 없거나 unknown( ) 유효하지 않은 semver.

수정

• 설정 plugins.CapacitorUpdater.version 유효한 semver 처럼 Sync 및 네이티브 앱을 재구축합니다. 1.2.3.
• 관련 문서:

채널: Bundle 버전 관리 및 채널

• 문제 해결: 업데이트 적용되지 않음.
• __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

원인

해결

채널 옵션 (, )을 테스트 대상과 일치시킵니다.

• 키 ID 불일치allow_prod, allow_dev, allow_device, allow_emulator원인

key_id_mismatch

해결

앱 구성과 Bundle 암호화 워크플로에서 동일한 암호화 키/공개 키를 사용합니다.

채널이 없거나 null 채널 데이터

• 원인

no_channel / null_channel_data

원인

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

수정

• 클라우드 기본 채널을 설정하거나
• 테스트 빌드의 경우 defaultChannel 장치에 대한 채널 오버라이드를 assign하거나
• 관련 문서:

채널

• 제목이 “on_premise_app”인 섹션

on_premise_app

백엔드에서 HTTP 429이 반환되었습니다.

Section titled “on_premise_app” on_premise_app. 이 상황이 세 가지 경우에 발생합니다.

1. Capgo에 등록된 App ID가 존재하지 않습니다. — 기기에서 전송된 ID가 등록되지 않았기 때문에 백엔드에는 그에 대한 기록이 없습니다. app_id App이 내부 서버에 설치되어 있습니다.
2. — App이 존재하지만 업데이트 설정이 내부 서버로 구성되어 __CAPGO_KEEP_0__ 클라우드 엔드포인트는 이를 제공하지 않습니다. Capgo에 등록된 Organization의 구독이 취소되었습니다.
3. — App의 Organization이 더 이상 활성 구독을 보유하지 않습니다. 일반적인 오류

App ID에

(in plugins.CapacitorUpdater.appId )에 오류가 발생하거나 __CAPGO_KEEP_0__에 등록된 App ID와 일치하지 않습니다. 백엔드는 “알 수 없는 App”과 “내부 서버 App”을 구분할 수 없기 때문에 동일한 오류 __CAPGO_KEEP_1__을 반환합니다. 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.

수정

• 등록된 앱이 없으면 app_id Capgo 대시보드에 표시된 것과 정확히 일치해야 합니다 (대/소문자 구분).
• 앱이 클라우드에 등록되지 않았으면 npx @capgo/cli@latest app add.
• 앱이 자체 호스팅이면 plugins.CapacitorUpdater.updateUrl Capgo 클라우드 URL 대신 자체 호스팅 업데이트 엔드포인트를 설정하세요.
• 계획이 만료되면, 계획을 갱신하거나 업그레이드하세요.

빠른 진단 체크리스트

1. 빌드에 대한 앱 ID와 채널이 올바른지 확인하세요.
2. 확인 CapacitorUpdater.version 설치된 네이티브 앱 버전과 일치합니다.
3. 채널 정책 (disable_auto_update)이 예상된 롤아웃과 일치하는지 확인합니다.
4. 플랫폼/빌드 대상 전환 설정이 이 기기를 허용하는지 확인합니다.
5. 실행 npx @capgo/cli@latest app debug 백엔드 오류를 읽고 code을 실행합니다.

더 많은 도움이 필요합니까?

• 문제 해결
• 지원을 받는 방법

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

Cloudflare를 사용하고 있으시면 일반 업데이트 문제 __CAPGO_KEEP_0__을 __CAPGO_KEEP_1__과 연결하여 @capgo/capacitor-업데이터를 사용하여 @capgo/capacitor-업데이터를 사용하여 capgo 네이티브 기능을 사용하는 경우 Capgo 플러그인 디렉토리 Capgo 플러그인 디렉토리에서 Capgo 제품 워크플로우를 사용하는 경우 Capacitor 플러그인은 Capgo에서 구현하는 경우 Capacitor 플러그인 구현 세부 사항을 Capacitor 플러그인에 의해 Capgo에서 구현하는 경우 플러그인을 추가하거나 업데이트하는 경우 플러그인을 추가하거나 업데이트하는 경우의 구현 세부 사항을 사용하는 경우 아이오닉 엔터프라이즈 플러그인 대안 아이오닉 엔터프라이즈 플러그인 대안의 제품 워크플로우를 사용하는 경우