Zum Inhalt springen

FAQ

Falls deine Fragen hier nicht beantwortet werden, frag einfach! Sowohl das Erstellen eines Issues als auch das Fragen auf Discord work.

Code push, auch als „Over-the-Air-Updates“ (OTA) bekannt, ist ein Cloud-Service, mit dem Capacitor-Entwickler Updates für ihre Apps in Produktion deployen können. Capgo läuft aktuell auf Android, iOS und Electron.

„Code Push“ ist eine Anspielung auf den Namen eines Deploy-Features, das in der React Native Community von Microsoft und Expo, von denen keines Capacitor unterstützt.

Müssen die Majors von Capgo CLI zu meinem Plugin oder der Capacitor-Version passen?

Abschnitt mit dem Titel „Müssen Capgo CLI-Majors zu meinem Plugin oder der Capacitor-Version passen?“

Nein. Nutze immer die neueste Capgo CLI (npx @capgo/cli@latest). Die CLI- und Capgo-Console folgen ihrer eigenen Versionierung und bleiben mit jeder unterstützten Major-Version des Updater-Plugins kompatibel. Capgo-Plugins folgen den Capacitor-Majors; siehe Capgo Versionierung für LTS-Tags wie @lts-v7.

Was ist der Unterschied zwischen einem Bundle und einem Release?

Abschnitt mit dem Titel „Was ist der Unterschied zwischen einem Bundle und einem Release?“

Wir verwenden den Begriff „Release“, um das Vorbereiten einer Binärdatei für die App Stores zu beschreiben. Um später ein Bundle zu generieren, muss Capgo die exakte Binärdatei kennen, die an die App Stores ausgeliefert wurde.

Wir verwenden den Begriff „Bundle“ für einen Patch, der auf ein Release angewendet werden kann, um es auf neue code zu aktualisieren. Der npx @capgo/cli@latest bundle upload Der Befehl wird verwendet, um ein Bundle aus Ihrem neuen lokalen code zu generieren, das anschließend an Ihre Nutzer ausgeliefert wird.

Ja:

  • Dateien mit Null Bytes: Die CLI-Logs Ignoring empty file... und schließt leere Dateien aus den Delta-Dateien aus. Der Upload schlägt nicht fehl, sodass eine leere Datei das resultierende Bundle ändern kann, ohne dass Ihre Deployment gestoppt wird. Fügen Sie keine Dateien mit Null Bytes in Delta-Bundle-Pfade ein.
  • Pfade mit Leerzeichen: Delta-Uploads schlagen frühzeitig mit einer klaren Fehlermeldung fehl, wenn ein Bundle-Pfad ein Leerzeichen enthält. Benennen Sie Dateien oder Verzeichnisse um, um Leerzeichen zu entfernen, bevor Sie ein Delta-Update hochladen.

Siehe Delta-Updates für Setup-Details.

Unsere Projektboards sind ebenfalls öffentlich und finden sich unter: https://github.com/orgs/Cap-go/projects

Unser Team arbeitet auch öffentlich, sodass du jederzeit sehen kannst, woran wir gerade arbeiten. Gerne beantworten wir deine Fragen zu unserer Roadmap oder unseren Prioritäten über Github Issues oder Discord.

Ja! Alle Pläne unterstützen unbegrenzt viele Entwickler. Wir begrenzen lediglich die App-Metriken (MAU, Speicher und Bandbreite) pro Organisation.

Siehe Teams für weitere Informationen.

Nein. Die Capgo-Server sehen deinen Quell-code niemals. Wenn du npx @capgo/cli@latest bundle upload ausführst, speichert Capgo eine ZIP-Datei des minifizierten/kompilierten code – also dieselben code, die ein Browser bekommen würde, nicht deinen Quell-code.

Für zusätzliche Sicherheit hast du zwei Optionen:

  • Ende-zu-Ende-Verschlüsselung: Verschlüssele dein Bundle vor dem Upload, um es bei der Speicherung und Übertragung zu schützen und zu verhindern, dass Dritte ohne deinen Private Key gültige verschlüsselte Updates erstellen. Das verhindert nicht das Reverse Engineering der ausgelieferten Web-Assets, da der Public Key in der verteilten App enthalten ist.
  • Upload via externer URL: Speichere das Bundle auf deinem eigenen Server und gib Capgo nur den Download-Link mit der Option --external <url>

Siehe auch unsere Datenschutzerklärung: https://capgo.app/privacy

Nein. Bundle-Dateien sind öffentliche Web-Assets, die von deinen App-Nutzern heruntergeladen werden sollen. Jeder, der die Bundle-URL kennt, kann diese Dateien abrufen; Capgo weist die Nutzer während des Setups und in der Dokumentation darauf hin.

Der Zugriff auf Bundle-Dateien gilt nicht als Data Breach. Speichere keine Secrets, Credentials, personenbezogenen Daten oder regulierten Daten in deinem App-Bundle. Wenn du für High-Security-Use-Cases mehr Vertraulichkeit brauchst, nutze End-to-End-Verschlüsselung, aber behandle ausgelieferte App code und Assets aus Sicht des Security-Reportings weiterhin als öffentlich.

Ja. Capgo ist für die Nutzung aus CI-Systemen gedacht. Wir haben dazu einen Guide veröffentlicht: Android und Github Actions und iOS, und für GitLab. Andere CI-Systeme sollten ähnlich sein.

Zögern Sie nicht, uns über GitHub Issues oder Discord zu kontaktieren, wenn Sie auf Probleme stoßen.

Wie verhält sich dies zu Firebase Remote Config oder Launch Darkly?

Abschnitt mit dem Titel „Wie verhält sich dies zu Firebase Remote Config oder Launch Darkly?“

Code push ermöglicht es, neue code hinzuzufügen oder code auf dem Gerät zu ersetzen. Firebase Remote Config und Launch Darkly sind beides Konfigurationssysteme. Sie erlauben es, die Konfiguration Ihrer App zu ändern, ohne eine neue Version veröffentlichen zu müssen. Sie sind nicht dazu gedacht, code zu ersetzen.

Wie groß ist der zusätzliche Dependency-Footprint dadurch?

Abschnitt mit dem Titel „Wie groß ist der zusätzliche Dependency-Footprint?“

Ich habe es vor Kurzem nicht gemessen, aber ich erwarte, dass die code Push-Library weniger als ein Megabyte zu Capacitor Apps hinzufügt. Wir wissen, wie wir das verkleinern können, sobald dies Priorität hat. Falls die Größe ein Blocker für dich ist, lass es uns bitte wissen!

Nein. Aufgrund eines Upstream-Problems beim iOS 18.4 Simulator läuft Capgo dort nicht zuverlässig. Bitte teste auf einem echten Gerät oder nutze eine andere iOS-Simulator-Version.

Details findest du im React Native Issue: facebook/react-native#50510

Ja. Es gibt keine Größenbeschränkung für die Anwendung, die per code push aktualisiert werden kann. Wie bereits unten, kann Capgo jeden JS-code in deiner Anwendung ändern, unabhängig von der Größe.

Hinweis: Eine größere Größe erschwert den Download von Updates für Nutzer. Wir empfehlen, deine App so klein wie möglich zu halten.

Wir haben verschiedene Anwendungsfälle gesehen, darunter:

  • Notfall-Fixes für Apps in Produktion.
  • Bugfixes für Nutzer älterer Versionen deiner App bereitstellen.
  • Ständige Veröffentlichungen (z. B. stündlich).

Beachte, dass die meisten App-Stores das Ausliefern von code, die das Verhalten der App wesentlich verändern, untersagen. Siehe unten für weitere Informationen.

Eine MAU ist ein Monthly Active Device. Ein eindeutiges Gerät, das Capgo innerhalb eines rollierenden 30-Tage-Zeitraums kontaktiert, zählt als eine MAU für diese native App-ID. Dasselbe physische Gerät, das mit zwei verschiedenen nativen App-IDs genutzt wird, zählt einmal pro App-ID; es erfolgt keine Deduplizierung über die IDs hinweg.

Wenn sich Ihre Flavors nur im Web-Layer oder beim Update-Routing unterscheiden, nutzen Sie eine native App-ID mit Channels. So bleiben die Flavors unter einer Capgo-App und Releases werden einfacher. Nutzen Sie separate native App-IDs, wenn ein Flavor eine eigene Bundle-ID, eine eigene Signing Identity, einen eigenen Entitlement-Satz oder einen eigenen Store-Eintrag benötigt.

Unter iOS, v7.25.0+ behält die zufällige, app-spezifische Device-ID bei normalen Reinstalls mithilfe des Keychain bei. Unter Android nutzen Sie v7.50.1+ (oder v5.50.1+ und v6.50.1+ auf diesen Release-Linien); die ID wird nur wiederhergestellt, wenn Android Backup/Restore die App-Einstellungen beibehält. Das Deaktivieren des Backups, das Ausschließen dieser Einstellungen oder das Löschen der App-Daten erzeugt eine neue Device-ID. Ein App-Update erzeugt keine neue Device-ID.

Deaktiviere für Test- und Development-Builds die Auslieferung an Development-Builds und Emulatoren auf Production-Channels. Das steuert die Auslieferung, nicht die MAU: Ein Gerät kann weiterhin gezählt werden, wenn es Capgo kontaktiert. Um es aus der Production-Nutzung herauszuhalten, deaktiviere Live Updates und rufe keine Capgo-Endpoints in Production auf. Siehe Native Builds ohne Live Updates testen für die genauen Einstellungen.

Capgo kann keine nativen code wie Java, Kotlin, Objective-C, Swift, native Plugins oder native Konfigurationen ändern. Diese Änderungen erfordern eine neue native App-Veröffentlichung. Zum Umfang der Store-Prüfung siehe Richtlinien von App Store und Google Play.

Kann ich Änderungen an der capacitor.config.ts über Capgo aktualisieren?

Abschnitt mit dem Titel „Kann ich Änderungen an capacitor.config.ts über Capgo aktualisieren?“

Nein. Kurze Regel: Capgo kann den generierten Web-Build-Ordner senden, einschließlich HTML, CSS, JavaScript, Assets und reinen JavaScript-Paketänderungen, die in diese Ausgabe gebündelt sind. Änderungen an capacitor.config.ts, nativer Plugin-Konfiguration, nativen Paketinstallationen oder -Upgrades und allem, was das iOS- oder Android-Projekt über npx cap sync oder npx cap copy aktualisieren muss, erfordern eine native App-Veröffentlichung.

Die Capacitor-Konfigurationsdatei wird beim nativen Build gelesen und in das native App-Binary kompiliert. Wenn Sie Ihre Capacitor-Konfiguration ändern müssen, müssen Sie:

  1. Update capacitor.config.ts lokal
  2. Bauen Sie Ihre native App neu (npx cap sync gefolgt von einem Native Build)
  3. Reichen Sie die neue Binärdatei bei den App-Stores ein

Reicht Capgo die App für mich bei den Stores ein?

Abschnitt mit dem Titel „Reicht Capgo für mich bei den Stores ein?“

Capgo Build kann ein vorbereitetes natives iOS- oder Android-Projekt kompilieren und signieren und, wenn konfiguriert, das signierte Ergebnis bei App Store Connect oder Google Play einreichen. Sie können Ihre bestehende CI für private Abhängigkeiten, Web-Builds, Capacitor-Sync und individuelle native Vorbereitung beibehalten; Capgo erhält das vorbereitete native Projekt für den Native-Build-Schritt.

Siehe Capgo Build und Build-Konfigurationsreferenz für die Workflow- und Store-Einreichungsoptionen.

Der Capgo Updater (beim Build in deine App eingebunden) speichert das zuletzt heruntergeladene Bundle im einzigen Verzeichnis, in dem capacitor das Laden von code erlauben. Auf Android liegt es in /data/user/0/com.example.app/code_cache/capgo_updater obwohl die Basis dieses Pfads vom Android-System vorgegeben wird und sich zur Laufzeit dynamisch ändern kann. Auf iOS-Geräten liegen die Daten unter Library/Application Support/capgo.

Die Capgo CLI-Tools (z. B. npx @capgo/cli@latest bundle upload) werden auf der Festplatte in den npm Caches installiert; deine Logins liegen in deinem Home-Verzeichnis unter ~/.capgo.

Capacitor’s Hot Reload ist nur für die Entwicklung gedacht. Code Push ist für die Produktion.

Hot Reload ist ein Feature von Capacitor, mit dem du code während der Entwicklung direkt auf dem Gerät ändern kannst. Dafür muss die Capacitor App mit einem Proxy gebaut werden, um eine Verbindung zu deinem lokalen Rechner herzustellen.

Code push ist eine Funktion, mit der Sie code auf dem Gerät in Produktion ändern können. Je nach Plattform setzen wir dafür verschiedene Techniken ein.

Welche Arten von Änderungen unterstützt der Push von Capgo code?

Abschnitt mit dem Titel „Welche Arten von Änderungen unterstützt Capgo code push?“

Capgo kann jedes JS-code in Ihrer Anwendung ändern. Dies umfasst App-code und generierte code. Sie können auch Abhängigkeiten in package.json aktualisieren, solange keine Änderungen am nativen code erforderlich sind.

Wir haben keine Pläne, Änderungen am nativen code (z. B. Java/Kotlin auf Android oder Objective-C/Swift auf iOS) zu unterstützen. Das Tool warnt Sie, wenn es feststellt, dass Sie nativen code geändert haben, da dies nicht im Bundle enthalten sein wird.

Code push ist für Web nicht nötig, da Web-Apps so bereits funktionieren. Wenn ein Nutzer eine Web-App öffnet, lädt sie bei Bedarf die neueste Version vom Server herunter.

Falls du einen Use Case für code push im Web hast, freuen wir uns, davon zu erfahren!

Funktioniert das auf iOS, Android, Mac, Windows, Linux usw.?

Abschnitt mit dem Titel „Funktioniert das auf iOS, Android, Mac, Windows, Linux usw.?“

Ja.

Bisher haben wir uns auf Android, iOS und Electron konzentriert, und code Push ist auf allen drei Plattformen produktionsreif.

Capgo unterstützt dieselben Android-Versionen wie Capacitor.

Capacitor unterstützt derzeit Android API Level 22+ und iOS 13.0+: https://capacitorjs.com/docs/main/reference/support-policy

Capgo unterstützt derzeit nur aktuelle Stable Releases von Capacitor. Wir könnten auch ältere Versionen von Capacitor unterstützen, haben aber bisher die notwendige Infrastruktur für die langfristige Wartung nicht aufgebaut. Wir planen, in Zukunft mehr Versionen von Capacitor zu unterstützen, einschließlich jeder Version für unsere Enterprise-Kunden. https://github.com/Cap-go/capgo/issues/1100

Capgo verfolgt die Stable Releases von Capacitor und aktualisiert in der Regel innerhalb weniger Stunden nach einem Stable Release. Unser System für diese Updates ist automatisiert und braucht nur wenige Minuten. Vor der Veröffentlichung auf unseren Servern machen wir zusätzlich einen manuellen Verifizierungsschritt.

Wie verhält sich das zum Review-Prozess und den Richtlinien von App Store und Play Store?

Abschnitt mit dem Titel „Wie hängt das mit dem Review-Prozess oder den Richtlinien von App/Play Store zusammen?“

Capgo liefert Änderungen nur an den Capacitor Web-Layer: HTML, CSS, JavaScript und Assets, die bereits in der WebView der App laufen. Es ändert weder die nativen Binaries noch native Plugins, Berechtigungen, Entitlements, das Signing oder Store-Metadaten.

Nutze ein natives Store-Release für jede native Änderung und für wesentliche Änderungen, die den geprüften Zweck oder die Funktionalität der App beeinflussen könnten. Bleib mit Live Updates im Rahmen der App-Experience, die du eingereicht und den Nutzern gegenüber offengelegt hast.

Kann Capgo zu einer Ablehnung durch Apple wegen Remote-code-Ausführung führen?

Abschnitt mit dem Titel „Kann Capgo zu einer Ablehnung durch Apple wegen Remote-code-Ausführung führen?“

Nein. Das ist nicht möglich. Capgo installiert oder führt weder nativen code noch dynamische Bibliotheken, Frameworks oder Plugins aus und kann auch nicht aufrufen dlopen, dlsym, performSelector:, oder method_exchangeImplementations(). Es ersetzt lediglich JavaScript, HTML, CSS und statische Assets innerhalb des WebViews oder der JavaScriptCore-Engine, die bereits in der geprüften Binary enthalten sind.

Wenn App Review Guideline 2.5.2 oder „remote code execution“ anführt, mach Capgo nicht dafür verantwortlich. Lies die Review-Mitteilung und prüfe dann das native Projekt und andere SDKs auf das Laden von Executables oder die Nutzung privater API. Ein früherer Review-Hinweis zu Dynamic Linking im Auto-Hide-Pfad des Capgo Splash-Screens war ein Bug in diesem nativen Plugin, nicht in Live Updates, und dieser Link wurde entfernt.

Wirkt sich Apples Durchsetzung der Remote-code-Ausführung auf Capgo aus?

Abschnitt mit dem Titel „Wirkt sich Apples Durchsetzung der Remote-code-Ausführung auf Capgo aus?“

Nein. Capgo kann nicht zu einer Ablehnung wegen Remote-code-Ausführung führen. Siehe Kann Capgo zu einer Ablehnung durch Apple wegen Remote-code-Ausführung führen?. Capgo ist für den interpretierten Web-Layer in Capacitor-Apps gebaut. Es installiert oder führt nach dem Review keinen nativen code aus. Apple prüft jede App weiterhin anhand ihrer eigenen Fakten, und Capgo kann keinen Ausgang garantieren.

Apples App-Review-Richtlinie 2.5.2 besagt, dass Apps keine „code“ herunterladen, installieren oder ausführen dürfen, die Funktionen oder Funktionalitäten der App einführen oder ändern.“ Review-Teams berufen sich auf diese Regel, zusammen mit dem Apple Developer Program License Agreement Abschnitt 3.3.1(B) zu ausführbaren code, wenn sie Apps ablehnen, die Remote-Ressourcen nutzen, um das Verhalten nach der Genehmigung zu ändern. Typische Beispiele sind dlopen, dlsym, performSelector:, oder Remote-Skripte, die auf private APIs zugreifen.

Dasselbe Lizenzabkommen erlaubt interpretierte code heruntergeladen zu werden, wenn sie:

  • den Hauptzweck der App nicht ändern,
  • umgeht keine Signierung, Sandbox oder andere OS-Sicherheitsfunktionen und
  • erstellt keinen Store oder eine Verkaufsstelle für andere Anwendungen.

Abschnitt 3.3.1(C) schränkt separat das Bereitstellen, Freischalten oder Aktivieren zusätzlicher Features oder Funktionen über andere Vertriebsmechanismen als den App Store, Custom App Distribution oder TestFlight ein, es sei denn, Apple erteilt vorab schriftliche Genehmigung oder die Aktivität ist gemäß Abschnitt zulässig. 3.3.9(A) (In-App-Kauf API). Wie diese Klausel auf ein bestimmtes interpretiertes code-OTA-Bundle anzuwenden ist, ist eine Rechtsfrage für Ihr Team und Ihren Rechtsbeistand.

Capgo ersetzt das JavaScript, HTML, CSS und die statischen Assets, die bereits in der WebView oder JavaScriptCore-Engine Ihrer App laufen. Es liefert keine nativen Binaries, keinen Maschinencode, keine dynamischen Bibliotheken oder Plugins. Richtlinie 4.7 (präzisiert in November 2025) gilt, wenn Ihre App HTML5- und JavaScript-Mini-Apps, Minispiele, Chatbots, Plug-ins oder ähnliche Software anbietet, die nicht in der Binary eingebettet sind. Wenn Nutzer innerhalb Ihrer App mehrere verschiedene Software-Erlebnisse durchsuchen oder starten können, prüfen Sie die zusätzlichen 4.7-Anforderungen mit Ihrem Rechtsbeistand. Ein einzelnes Produkt, das sein eigenes geprüftes Web-Bundle über Kanäle aktualisiert, ist ein anderes Nutzererlebnis, aber nur Apple entscheidet, ob Ihre Metadaten dieser Beschreibung entsprechen.

Veröffentlichen Sie native Funktionen, Berechtigungen, Entitlements und wesentliche Funktionsänderungen über eine normale App-Store-Binary. Nutzen Sie Capgo für Fixes und Verbesserungen auf der Web-Ebene, die innerhalb der eingereichten App bleiben. Siehe Apple-Remote-code-Ausführung und Capgo für eine ausführlichere Compliance-Aufschlüsselung oder den Blog-Walkthrough für Guideline 2.5.2, ADPLA 3.3.1(B) und die Klarstellung zu Guideline 4.7 aus 2025.

Garantiert Capgo die Freigabe im App Store oder bei Google Play?

Abschnitt mit dem Titel „Garantiert Capgo die Freigabe im App Store oder bei Google Play?“

Nein. Apple und Google prüfen jede App und jedes Release nach den jeweiligen Gegebenheiten, und Capgo kann keine Garantie für eine individuelle Freigabe oder das Ergebnis des Reviews übernehmen. Ihr Team bleibt verantwortlich für die Inhalte der App, Offenlegungen, den Umfang der Updates und die Einhaltung der aktuellen Store-Richtlinien.

Für die Review- und Release-Planung lesen Sie am besten direkt die offiziellen Richtlinien: Apple App Store Review-Richtlinien und Google Play Richtlinie zu Geräte- und Netzwerkmissbrauch.

Wir haben keinen Versuch unternommen, den Zugriff auf Capgo aus bestimmten Ländern zu beschränken.

Wir sind uns bewusst, dass in einigen Ländern Beschränkungen für den Zugriff auf bestimmte URLs innerhalb des Landes gelten. Capgo nutzt derzeit Cloudflare Cloud für das Hosting, einschließlich R2 Storage und Cloudflare Workers.

Die folgenden URLs werden von Capgo verwendet:

  • https://api.capgo.app — wird von den npx @capgo/cli Command-Line-Tools verwendet, um mit den Capgo-Servern zu interagieren sowie vom Capgo-Updater auf den Geräten der Nutzer, um nach Updates zu suchen.
  • https://*.r2.cloudflarestorage.com — wird von den npx @capgo/cli Kommandozeilen-Tool zum Upload und Download von Bundles

Wenn alle diese URLs aus deinem Land erreichbar sind, sollte Capgo funktionieren.

Falls in Ihrer Region der Zugriff auf eine dieser URLs blockiert werden muss, sagen Sie uns Bescheid – wir finden gemeinsam eine Lösung. Proxy-Server sind eine Option.

Ja. Enterprise unterstützt lizenzierte Self-Hosted-Deployments von Capgo, wenn Sie das Updater-Backend in Ihrer eigenen Infrastruktur betreiben möchten. Siehe Self-Hosted-Updater für das Deployment-Modell und die Endpoints.

Ja. Man könnte zwar einen Server betreiben, um Updates unabhängig vom öffentlichen Internet zu verteilen, aber eine Netzwerkverbindung ist dennoch nötig, um die Updates auf die Geräte zu übertragen.

Wie wirkt sich eine fehlende Netzwerkverbindung auf Capgo aus?

Abschnitt mit dem Titel „Wie wirkt sich eine fehlende Netzwerkverbindung auf Capgo aus?“

Der Capgo Updater (in deiner App enthalten, wenn du sie mit Capgo buildest) ist darauf ausgelegt, auch bei Netzwerkproblemen zuverlässig zu funktionieren.

Beim Standard-Updateverhalten benachrichtigt die App beim Start den Capgo Updater. Dieser startet einen separaten Thread, um eine Netzwerkanfrage an die Server von Capgo zu senden und nach einem Update zu fragen. Wir nutzen bewusst einen separaten Thread, um nichts anderes zu blockieren, was die App gerade tut. Schlägt die Anfrage fehl oder läuft sie in ein Timeout, versucht der Updater es beim nächsten App-Start einfach erneut.

Capgo CLI-Tools (z. B. npx @capgo/cli@latest bundle upload) benötigen eine Netzwerkverbindung. Wenn du Capgo nutzt, um deine App zu verteilen, solltest du sicherstellen, dass dein CI-System eine Netzwerkverbindung hat.

Was passiert, wenn ein Nutzer lange nicht aktualisiert und ein Update verpasst?

Abschnitt mit dem Titel „Was passiert, wenn ein Nutzer lange nicht aktualisiert und ein Update verpasst?“

Unsere Implementierung sendet immer ein Update, das speziell auf das anfragende Gerät zugeschnitten ist, und bringt den Anfragenden stets auf die neueste verfügbare Version. Wenn ein Nutzer also eine Weile nicht aktualisiert, „verpasst“ er die Zwischenupdates.

Der Update-Server könnte so angepasst werden, dass er je nach Bedarf Ihrer App entweder die nächste inkrementelle Version oder die neueste Version liefert. Bitte lassen Sie uns wissen, ob alternative Update-Verhalten für Sie wichtig sind.

Capgo ist ein Plugin für Capacitor, das code-Push hinzufügt. Capgo ist kein Ersatz für Capacitor. Sie können weiterhin das Capacitor-Tooling nutzen, das Sie bereits kennen und schätzen.

Wir verfolgen die neueste stabile Version von Capacitor und passen unser code Push-Plugin entsprechend an.

Standardmäßig prüft der Capgo-Updater beim App-Start auf Updates. Er läuft in einem Hintergrund-Thread und blockiert den UI-Thread nicht. Updates werden installiert, während der Nutzer die App verwendet, und beim nächsten App-Neustart angewendet.

Es ist auch möglich, den Capgo-Updater manuell über das @capgo/capacitor-updater Package, mit dem Updates jederzeit ausgelöst werden können, auch per Push-Benachrichtigung.

Der Capgo-Updater ist so konzipiert, dass die App normal weiterläuft, wenn das Netzwerk nicht verfügbar ist, der Server down ist oder anderweitig nicht erreichbar ist. Falls Sie eine Update von unseren Servern löschen, laufen alle Ihre Clients weiterhin normal.

Wir haben die Möglichkeit hinzugefügt, Patches zurückzurollen. Am einfachsten ist es, ein vorheriges Bundle an Ihren Channel anzuhängen, um die Änderung rückgängig zu machen.

Nein. Die app_id ist in Ihrer App enthalten und kann öffentlich sein. Sie können sie in die Versionskontrolle einchecken (auch öffentlich) und müssen sich keine Sorgen machen, dass jemand anderes darauf zugreift.

Jemand, der Ihre app_id hat, kann die neueste Version Ihrer App von den Capgo-Servern abrufen, kann aber keine Updates an Ihre App senden oder auf andere Aspekte Ihres Capgo-Kontos zugreifen.

Das vollständige Dateninventar, das Endpoint-Verhalten und die Datenschutzkontrollen sind dokumentiert in Konformität.

Setzen Sie statsUrl: '' um explizite Updater-Statistikberichte zu deaktivieren. Sie können auch senden statsUrl an einen Proxy oder Endpoint, den Sie kontrollieren; siehe Statistikverarbeitung in selbst gehosteter Infrastruktur. Update-Prüfungen benötigen weiterhin eine app-spezifische Geräte-ID, damit Capgo das richtige Update auswählen und monatlich aktive Geräte messen kann.

Der Sub-Processor-Liste ist unsere aktuelle öffentliche Quelle der Wahrheit für Anbieter, Verarbeitungsstandorte, Übertragungsmechanismen und Änderungshistorie.

Ja, aber Ihr Compliance-Verantwortlicher muss das passende Deployment-Modell wählen. Capgo Cloud wird derzeit nicht als HIPAA-konformer gehosteter Statistik-Prozessor ausgewiesen. Standardmäßig sind die Updater-Daten auf das Gerät bezogen und nicht an einen bekannten App-Nutzer gebunden – viele Teams fahren mit diesem Modell gut.

Für strengere Prüfungen können Sie den Plugin-Traffic geolokalisieren, Statistiken deaktivieren, indem Sie statsUrl auf einen leeren String setzen, nur den Statistik-Endpoint selbst hosten oder lizenziertes Self-Hosting nutzen. Rufen Sie CapacitorUpdater.setCustomId(...) nicht mit einer E-Mail-Adresse, User-ID, Patienten-ID, Mitarbeiter-ID oder einem Wert auf, über den sich die Updater-Telemetrie einer Person zuordnen lässt.

Siehe HIPAA-Compliance für das komplette technische Setup und die Observability-Tradeoffs bei deaktivierten Statistiken.

Ja. Apps, die EU-Data-Residency für den Capgo Cloud-Plugin-Traffic brauchen, können die Updater-Endpoints auf den EU-Host setzen:

  • updateUrl: https://plugin.eu.capgo.app/updates
  • statsUrl: https://plugin.eu.capgo.app/stats
  • channelUrl: https://plugin.eu.capgo.app/channel_self

Verwenden Sie alle drei EU-URLs gemeinsam, damit Update-Prüfungen, Statistiken und die automatische Kanalzuweisung denselben regionalen Datenpfad nutzen. Da diese Werte in capacitor.config.tsliegen, benötigen produktive Mobile-Apps ein natives Release, bevor bestehende Installationen die neuen Endpunkte verwenden.

Siehe Datenstandort für genaue Capacitor- und Electron-Beispiele.

Derzeit unterstützt Capgo Android, iOS und Electron. Alle sind produktionsreif.

Die Nutzung von Capgo für iOS, Android oder Electron kann unabhängig voneinander entschieden werden. Sie können Ihre Kanalstrategie für Android und eine für den App Store gebaute ipa oder Electron-Kanäle nach Bedarf festlegen.

Capgo kann (relativ einfach) so angepasst werden, dass es Desktop- oder Embedded-Ziele unterstützt. Falls Ihnen das wichtig ist, lassen Sie es uns bitte wissen.

Wie interagiert Capgo mit Play Testing Tracks oder Apple TestFlight?

Abschnitt mit dem Titel „Wie interagiert Capgo mit Play Testing Tracks oder Apple TestFlight?“

Jeder App-Store hat eigene Mechanismen, um Apps an begrenzte Nutzergruppen zu verteilen (z. B. „interne Tests“, „geschlossene Beta“ usw.). All diese Mechanismen dienen dazu, Nutzer in Gruppen zu segmentieren und spezifische App-Versionen an jede Gruppe auszuliefern.

Leider ermöglichen nicht alle dieser Mechanismen es Drittanbietern, festzustellen, ob eine App in einem bestimmten Test Track oder über TestFlight installiert wurde. Daher haben wir keine zuverlässige Sicht auf die Zusammensetzung dieser Gruppen und können den Zugriff auf Capgo-Patches nicht zuverlässig anhand dieser Gruppen einschränken. https://stackoverflow.com/questions/53291007/can-an-android-application-identify-the-test-track-within-google-play https://stackoverflow.com/questions/26081543/how-to-tell-at-runtime-whether-an-ios-app-is-running-through-a-testflight-beta-i

Wenn du die Verfügbarkeit des Capgo-Bundles segmentieren möchtest, gibt es 4 mögliche Optionen:

  1. Verwenden Sie einen separaten Channel für jede Gruppe. Das ist der direkteste Ansatz, erfordert aber die Verwaltung mehrerer Channels. Möglicherweise haben Sie bereits Dev- und Prod-Channels mit unterschiedlicher Verfügbarkeit. So können Sie Ihre Dev-Channels aktualisieren, dies überprüfen und anschließend Ihre Prod-Channels separat aktualisieren. Wir empfehlen, Branches oder Tags in Ihrer Versionskontrolle zu verwenden, um die mit jedem Release verbundenen Quellen nachverfolgen zu können.
  2. Verwalte deine eigene Liste an Opt-in-Nutzern, deaktiviere automatische Updates und triggere Updates gezielt für bestimmte Nutzer über das @capgo/capacitor-updater Package. Das funktioniert heute schon, erfordert aber, dass du deine eigene Opt-in-Liste selbst verwaltest.
  3. Capgo ermöglicht einen eigenen Opt-in-Mechanismus pro Gerät (ähnlich wie Test Tracks oder TestFlight, nur plattformunabhängig). So kann dein QA-Team sich per Opt-in für ein Bundle entscheiden, bevor es für die Allgemeinheit freigegeben wird.
  4. Nutzt Progressive Rollouts um ein Candidate-Bundle an eine zufällige, sticky Teilmenge eines Channels auszuliefern. Setze den Rollout auf 0–100 % oder nutze --rollout-percentage-bps für 0,01 %-Schritte; konfiguriere die Cache-Dauer von 60 Sekunden bis 365 Tagen sowie eine optionale Auto-Pause-Policy. Dies wählt keine benannte Gerätegruppe aus.

Wie kann ich meinen Plan upgraden oder downgraden?

Abschnitt: „Wie kann ich meinen Plan upgraden oder downgraden?“

Du kannst deinen Plan jederzeit in deinem Dashboard upgraden oder downgraden: https://console.capgo.app/settings/organization/plans. Upgrades werden sofort wirksam. Downgrades werden am Ende deines aktuellen Abrechnungszeitraums wirksam.

Was passiert, wenn ich mein MAU-Limit erreiche?

Abschnitt: „Was passiert, wenn ich mein MAU-Limit erreiche?“

Capgo schickt dir E-Mails bei 50 %, 70 %, 90 % und 100 % deines MAU-Limits. Sobald du das Limit erreichst, werden Live Updates bis zum Ende deines Abrechnungszeitraums blockiert. Upgrade auf einen höheren Plan oder kaufe Credits, um wieder Updates auszuliefern. Siehe Capgo Preise und pricing.md für die Plan-Stufen.

Ausgenommen, wenn gesetzlich vorgeschrieben, sind Gebühren für kostenpflichtige Abonnements nicht erstattungsfähig. Bestimmte Rückerstattungsanfragen können im Ermessen von Capgo im Einzelfall berücksichtigt werden. Kontaktieren Sie Support , wenn Sie der Meinung sind, dass Sie Anspruch darauf haben.

Abrechnungszeiträume werden automatisch jeden Monat am Monat Ihres ersten Abonnements bei Capgo zurückgesetzt. Wenn Sie beispielsweise am 15. des Monats abonniert haben, wird Ihr Abrechnungszeitraum am 15. jedes Monats zurückgesetzt.

Wie kann ich mein Abonnement kündigen?

Abschnitt: „Wie kann ich mein Abonnement kündigen?“

Du kannst dein Abonnement jederzeit in deinem Dashboard kündigen: https://console.capgo.app/settings/organization/plans

Kann ich für ein ganzes Jahr im Voraus bezahlen?

Abschnitt: „Kann ich im Voraus für ein Jahr bezahlen?“

Ja. Du kannst die jährliche Abrechnung in deinen Organisationsplan-Einstellungen wählen.

Was zählt zum Speicher und können wir die Aufbewahrungsdauer ändern?

Abschnitt: „Was zählt zum Speicherplatz, und können wir die Aufbewahrung ändern?“

Zum Speicher zählen aufbewahrte historische Bundles und deren Delta-Assets über alle Channels hinweg. In den App-Einstellungen steuerst du für jede App, wie lange ungenutzte Bundles aufbewahrt werden. Bundles, die mit einem aktiven Channel oder Rollout verknüpft sind, bleiben geschützt und damit für Auslieferung und Rollback verfügbar.

Vervielfacht regionale Replikation den Speicher- oder Bandbreitenverbrauch?

Abschnitt mit dem Titel „Verdoppelt regionale Replikation Speicher oder Bandbreite?“

Nein. Ein Bundle wird für den Speicherplatz nur einmal gezählt, unabhängig von den Regionen, die es bereitstellen. Die Bandbreite wird ebenfalls nicht pro Region multipliziert: siehe Wie wird die Bandbreite gezählt?.

Die Bandbreite zählt nur die Dateien, die ein Gerät tatsächlich von Capgo herunterlädt:

  • Delta-Updates: wenn du hochlädst mit --delta, lädt ein Gerät nur die Dateien, die sich seit der bereits vorhandenen Version geändert haben. Nur diese Dateien zählen. Unveränderte Dateien wie große Bilder oder Schriftarten werden nicht erneut heruntergeladen und verursachen keine Kosten. Siehe Delta-Updates.
  • Edge-Cache: wenn eine angeforderte Datei oder ein vollständiges Zip bereits im Edge-Cache vorliegt, zählt dieser Download nicht auf Ihre Bandbreite. Dies gilt gleichermaßen für Delta-Dateien und vollständige Zips.
  • Fortgesetzte Downloads: Wenn ein Download unterbrochen wird, setzt das Gerät an der Stelle fort, an der es angehalten hat. Bereits heruntergeladene Teile werden nicht erneut heruntergeladen oder gezählt.
  • Komplettes ZIP: ohne hochgeladene Bundles --delta, oder Geräte mit einer Plugin-Version ohne Delta-Unterstützung, laden das vollständige Zip herunter. Es zählt nur, wenn es nicht aus dem Edge-Cache ausgeliefert wird.

Um die Bandbreite niedrig zu halten, laden Sie mit --delta hoch und halten Sie große Assets, die sich selten ändern, in stabilen Dateipfaden.

Enterprise umfasst eine monatliche Verfügbarkeitsgarantie von 99,9 % für die Produktionsplattform. Wird diese nicht eingehalten, beträgt der Service-Credit-Satz 10 % bis 30 % basierend auf der monatlichen Verfügbarkeit. Die initialen Reaktionsziele für den Support sind P1: eine Stunde, 24/7/365; P2: zwei Geschäftsstunden; P3: ein Geschäftstag; und P4: zwei Geschäftstage. Lesen Sie die Enterprise-SLA für die vollständigen Bedingungen.

Die Statistiken in Ihrem Dashboard werden jeden Mitternacht UTC aktualisiert. Die Statistiken werden aus eindeutigen MAUs berechnet, die im rollierenden 30-Tage-Zeitraum aktiv waren.

Die Device-ID wird beim ersten Start auf dem Gerät generiert. Sie dient dazu, Installationen pro Gerät zu deduplizieren, damit wir nach installierten Nutzern (z. B. Monthly Active Users) abrechnen können, statt nach der Gesamtzahl der Patches oder Patch-Installationen.

MAU ist eine bessere Preisbasis für Capgo als die Anzahl der Installationen, da sie genauer ist und die tatsächlichen Kosten von Capgo pro Gerät widerspiegelt.

Persistenz der Device-ID:

  • iOS: Ab v7.25.0+ wird die Device-ID im Keychain gespeichert und bleibt auch nach normalen Neuinstallationen erhalten.
  • Android: Nutze v7.50.1+ (oder v5.50.1+/v6.50.1+ auf diesen Release-Linien). Die Device-ID wird nur wiederhergestellt, wenn Android Backup/Restore die App-Einstellungen beibehält.
  • Electron: Die Device-ID wird im Secure Storage gespeichert.
  • Hinweis zu Android: Das Deaktivieren des Backups, das Ausschließen der relevanten Einstellungen oder das Löschen der App-Daten erzeugt eine neue Device-ID. Bei Android v7.25.0 bis v7.50.0 kann auch bei aktiviertem Backup nach einer Neuinstallation eine neue Device-ID generiert werden.

Die Device ID ist auf die App beschränkt und unterstützt die Auslieferung von Live-Updates sowie die MAU-Deduplizierung; sie ist keine Werbe- oder Cross-App-Tracking-Kennung.

Device IDs werden aufgeführt, nachdem sich die App über die Updater- oder Stats-Endpoints bei Capgo gemeldet hat. Ein Gerät muss keinen Patch installieren, um in der Geräteliste zu erscheinen.

Die Geräteliste und die MAU basieren auf unterschiedlichen Signalen.

Die Geräteliste zeigt die aktuellsten bekannten Metadaten für jedes Gerät, wie Device ID, Plattform, Plugin-Version, OS-Version, native Version, Channel, installiertes Bundle und das Request-Land, sofern verfügbar. Das Request-Land ist der letzte gültige zweistellige code aus einer von Cloudflare verarbeiteten Anfrage für dieses Gerät, nicht der GPS- oder von der App übermittelte Standort. Anfragen ohne gültiges Land löschen den letzten gültigen Wert nicht. Capgo aktualisiert diese Metadaten, wenn sich die App meldet, aber wiederholte Check-ins mit denselben Metadaten ändern möglicherweise weder die Zeile noch ihren Zeitpunkt der letzten Aktualisierung.

MAU zählt eindeutige aktive Geräte im Abrechnungszeitraum. Diese Aktivität kann zunehmen, auch wenn die Gerätemetadaten gleich bleiben; daher können Geräteanzahl und MAU voneinander abweichen.

Du kannst für jede Plattform einen eigenen Channel erstellen und plattformspezifische Updates in jedem Channel deaktivieren.

Deaktiviere im iOS-Channel die Android-Updates und im Android-Channel die iOS-Updates.

Lade dann ein Bundle in jeden Channel hoch, um für jede Plattform ein unterschiedliches Update zu haben.

Wenn du das gleiche Update für beide Plattformen benötigst, kannst du ein Bundle mit mehreren Channels verknüpfen. Du musst das Bundle nicht duplizieren.

Wenn du es nutzt FAQ um die Auslieferung von live update zu planen, verbinde sie mit Capgo Live Updates für den Produkt-Workflow in Capgo Live Updates, Übersicht für die Implementierungsdetails in Overview, Funktionen für die Implementierungsdetails in Features, Update-Verhalten für die Implementierungsdetails in Update Behavior und Update-Typen für die Implementierungsdetails in Update Types.