Gemeinsame Update Probleme

Wenn eine Aktualisierungskontrolle fehlschlägt, Capgo gibt normalerweise einen error code und ein message in der /updates Antwort zurück. Diese Seite erklärt die häufigsten Fehler und die schnellsten Lösungen.

Lesen Sie das zuerst

• no_new_version_available ein normales Zustand, kein Fehler
• Viele „Update gefunden, aber nicht angewendet“-Berichte sind Politik/ Konfigurationsverweigerungen anstatt Cache-Lag, insbesondere wenn die Antwort einen expliziten error code.
• Verwenden Sie npx @capgo/cli@latest app debug während Sie das Problem nachahmen, um Anforderungs-/Antwortdetails zu sehen

Häufige Fehlercodes

disable_auto_update_to_major

Ursache

Ihr Kanal blockiert größere Upgrades (disable_auto_update = majorund die Ziel-Bundle-Major-Version liegt über der Geräte-Baseline-Version.

Typisches Symptom

version: 1.0.8 mit old: 0.0.0 bedeutet, dass das Gerät die Baseline 0.0.0, also werden Major-Upgrades abgelehnt.

Wie interpretiert man das?

Der Backend vergleicht die Major-Versionen mithilfe der Geräte-Baseline old und Ziel version.

• Wenn Ziel ist 1.0.1, muss die Baseline-Major-Version 1 (z.B. 1.0.0).
• Wenn Ziel ist 10.0.1Grundlinie muss der Hauptwert sein 10 (zum Beispiel 10.0.0).

Option A (empfohlen): Ausrichten der Gerätegrundlinie an der Hauptwert

Setzen plugins.CapacitorUpdater.version in capacitor.config.* so dass MAJOR dem Bundle-MAJOR entspricht, das Sie liefern möchten (zum Beispiel 1.0.0 für 1.0.1, 10.0.0 für 10.0.1).

Dann wenden Sie diese Konfiguration auf die installierte App an:

1. Laufen npx cap sync.
2. Wiederherstellen und erneut installieren Sie die nativen App.

Lösung B: Entspannen Sie die Kanalrichtlinie

Zulassen von Querschnitts-Automatik-Updates in Kanal-Einstellungen (nur, wenn diese Rollout-Strategie vorsätzlich ist).

Zugehörige Dokumentation:

• Zielversion: Deaktivieren Sie die Auto-Update-Funktion über Hauptversionen
• Kanäle: Deaktivieren Sie die Auto-Update-Strategien

disable_auto_update_to_minor / disable_auto_update_to_patch

Ursache

Der Kanalrichtlinie ist strenger (minor oder patch) als das angebotene Update.

Lösung

• Ein Bundle hochladen, das mit der aktuellen Richtlinie kompatibel ist, oder
• die Kanalrichtlinie in dashboard/CLI ändern.

Zugehörige Dokumentation:

• Kanäle: Deaktivieren Sie die Auto-Update-Strategien

disable_auto_update_to_metadata

Ursache

Der Kanal verwendet eine Zielgruppenzuerkennung auf der Grundlage von Metadaten (version_number) und das Gerätebasislinien ist unter der erforderlichen min_update_version.

Lösung

• Gerätebasislinie (CapacitorUpdater.version) mit der installierten native App-Version ausrichten, oder
• anpassen min_update_version Kanalstrategie.

Zugehörige Dokumente:

• Kanäle: Deaktivieren Sie die Auto-Update-Strategien

disable_auto_update_under_native

Ursache

Der Kanal verhindert Downgrades unterhalb der nativen Basislinie.

Lösung

• Hochladen Sie eine Bundle-Version, die größer oder gleich der nativen Basislinie ist, oder
• deaktivieren Sie die Downgrade-Schutzfunktion unter nativer Basislinie für diesen Kanal.

Zugehörige Dokumente:

• Versionen Zielsetzen: Verhinderung von Auto-Downgrades

cannot_update_via_private_channel

Ursache

Der ausgewählte/Standardkanal erlaubt keine Gerätezuteilung.

Fix

• Wählen Sie einen anderen Kanal mit aktivierter Zuteilung oder
• machen Sie den Kanal öffentlich / aktivieren Sie die Zuteilung.

Zugehörige Dokumentation:

• Kanäle: Verwendung von setChannel() in Ihrer App

unknown_version_build / semver_error

Ursache

Die Gerätebasisversion ist fehlend (unknown) oder nicht ein gültiges semver.

Korrektur

• Einstellung plugins.CapacitorUpdater.version auf ein gültiges semver wie 1.2.3.
• Synchronisiere und baue die native App neu.

Zugehörige Dokumentation:

• Kanäle: Bundle Versioning und Kanäle
• Fehlerbehebung: Updates werden nicht angewendet

unsupported_plugin_version

Ursache

Updater-Plugin-Version ist zu alt für die aktuellen Backend-Anforderungen.

Fix

• Upgrade @capgo/capacitor-updater.
• Run npx cap sync.
• Rebuild und neu installieren Sie die native App.

disabled_platform_ios / disabled_platform_android

Ursache

Der Kanal hat für diese Plattform Updates deaktiviert.

Fix

• Aktivieren Sie die Plattform-Schaltfläche im Kanal.

disable_prod_build / disable_dev_build / disable_device / disable_emulator

Ursache

Der Kanal verbietet die aktuelle Build-Art oder die Zielplattform.

Korrektur

• Kanaloptionen (allow_prod, allow_dev, allow_device, allow_emulator) mit Ihrem Testziel ausrichten.

key_id_mismatch

Ursache

Die Verschlüsselungsschlüssel des Bundles und des Gerätes unterscheiden sich.

Korrektur

• Verwenden Sie denselben Verschlüsselungsschlüssel/öffentlichen Schlüssel in der App-Konfiguration und im Bundleschlüssel-Workflow.

no_channel / null_channel_data

Ursache

Für das Gerät wurde kein gültiger Kanal gelöst.

Korrektur

• Setzen Sie eine Cloud-Standardkanal, oder
• setzen defaultChannel in Testbuilds, oder
• zuweisen Sie einen Kanal-Übertrag für das Gerät.

Verwandte Dokumente:

• Kanäle

on_premise_app

Ursache

Der Backend-Server gab HTTP 429 mit on_premise_appDies tritt in drei Situationen auf:

1. Die App-ID existiert nicht in Capgo — das app_id Der von dem Gerät gesendete Wert ist nicht registriert, daher hat der Backend keinen Eintrag darüber.
2. Die App ist als On-Premise-App gekennzeichnet. — Die App existiert, ist aber für selbstgeführte Updates konfiguriert, daher lehnt der Capgo-Cloud-Endpunkt den Zugriff ab.
3. Die Organisationstabelle ist abbestellt. — Die App-Organisation hat keine aktive Abonnement mehr.

Häufiger Fehler.

Ein Tippfehler in plugins.CapacitorUpdater.appId (in capacitor.config.ts) oder eine Mismatch mit der im Capgo-Dashboard registrierten App-ID. Das Backend kann nicht zwischen einer unbekannten App und einer On-Premise-App unterscheiden, daher wird der gleiche Fehler code zurückgegeben.

Beheben.

• Überprüfe, ob app_id genau dem entspricht, was im Capgo-Dashboard angezeigt wird (kasseinschließlich).
• If the app is not registered yet, run npx @capgo/cli@latest app add.
• If the app is intentionally on-premise, set plugins.CapacitorUpdater.updateUrl to your self-hosted update endpoint instead of the Capgo cloud URL.
• If the organization plan expired, renew or upgrade the plan.

Rapiddiagnose-Checkliste

1. Bestätige, dass die App-ID und der Kanal für die Build korrekt sind.
2. Bestätige CapacitorUpdater.version passt sich der installierten nativen App-Version an.
3. Bestätige, dass die Kanalrichtlinie (disable_auto_update) der beabsichtigten Rollout entspricht.
4. Bestätige, dass die Plattform/Build-Zieltoggle diese Geräte zulassen.
5. Laufzeit und Fehlermeldung im Backend lesen __CAPGO_KEEP_0__. npx @capgo/cli@latest app debug and read backend error code.

Abschnitt mit dem Titel “Brauchen Sie mehr Hilfe?”

• Wie Sie Unterstützung erhalten
• Weitermachen von Common Update Problems

Abschnitt mit dem Titel “Weitermachen von Common Update Problems”

Common Update Problems für die Verbindung mit Verwendung von @__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-updater Using @capgo/capacitor-updater für die native Fähigkeit in Verwendung von @capgo/capacitor-Updater Capgo-Plugin-Verzeichnis für den Produktworkflow in Capgo-Plugin-Verzeichnis Capacitor-Plugins von Capgo für die Implementierungsdetail in Capacitor-Plugins von Capgo Hinzufügen oder Aktualisieren von Plugins für die Implementierungsdetail in Hinzufügen oder Aktualisieren von Plugins, und Ionic Enterprise-Plugin-Alternativen für den Produktworkflow in Ionic Enterprise-Plugin-Alternativen.