FAQ
Einen Setup-Vorschlag mit den Installations-Schritten und der vollständigen Markdown-Anleitung für diesen Plugin kopieren.
Wenn Sie hier nicht beantwortete Fragen haben, bitten wir Sie, zu fragen! Beide das Einreichen eines Issues oder das Fragen auf Discord Arbeitszeit.
Was ist „code push“?
Was bedeutet "code push"?Code push, auch als "Over-the-Air-Updates" (OTA) bezeichnet, ist ein Cloud-Dienst, der Capacitor Entwicklern ermöglicht, Updates für ihre Apps in der Produktion bereitzustellen. Capgo unterstützt derzeit Android, iOS und Electron.
"Code Push" ist eine Referenz auf den Namen einer Bereitstellungsfeature, das von der React Native Community verwendet wird Microsoft und Expo, weder von denen unterstützt Capacitor.
Müssen Capgo CLI-Majoren mit meiner Plugin- oder Capacitor-Version übereinstimmen?
Müssen Capgo CLI-Majoren mit meiner Plugin- oder Capacitor-Version übereinstimmen?Nein. Verwenden Sie immer die neueste Capgo CLI-Version (npx @capgo/cli@latestDie CLI und Capgo-Console folgen ihrer eigenen Versionsnummerierung und bleiben mit jeder unterstützten Updater-Plugin-Major kompatibel. Capgo-Plugins folgen Capacitor-Majoren; siehe Capgo Versionsierung für LTS-Tags wie @lts-v7.
Was ist der Unterschied zwischen einem Bundle und einer Veröffentlichung?
Abschnitt mit dem Titel „Was ist der Unterschied zwischen einem Bundle und einer Veröffentlichung?“Wir verwenden den Begriff „Veröffentlichung“ für die Vorbereitung eines Binärs für die App-Stores. Um später ein Bundle Capgo erstellen zu können, muss Capgo wissen, welches genaue Binär in die App-Stores geschickt wurde.
Wir verwenden den Begriff „Bundle“ für eine Patches, die auf eine Veröffentlichung angewendet werden können, um sie auf neue code zu aktualisieren. Der npx @capgo/cli@latest bundle upload Befehl wird verwendet, um ein Bundle aus Ihrem neuen lokalen code zu generieren, das dann an Ihre Benutzer geschickt wird.
Gibt es Grenzen für die Dateipfade von Delta-Update-Dateien?
Abschnitt mit dem Titel „Gibt es Grenzen für die Dateipfade von Delta-Update-Dateien?“Ja:
- Null-Byte-Dateien: Die CLI-Protokolle
Ignoring empty file...und schließen leere Dateien aus dem Delta-Manifest aus. Es wird keine Upload-Fehler ausgelöst, sodass eine leere Datei den resultierenden Bundle ohne Unterbrechung der Bereitstellung ändern kann. Leere Dateien sollten nicht in Delta-Bundle-Pfaden enthalten sein. - Pfade mit Leerzeichen: Delta-Uploads scheitern frühzeitig mit einem klaren Fehler, 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 context
Seite/ Bereich: Produkt/Preisliste-Seite. Rolle: Kurzer Benutzeroberflächentext oder Navigationspunkt. Anzeigen in: Seite enterprise.astro. Nachrichten Schlüssel `enterprise_delta_updates` (Enterprise Delta Updates).
Wie ist die Roadmap?Direkter Link zu Wie ist die Roadmap?. https://github.com/orgs/Cap-go/projects
Unsere Mannschaft arbeitet auch im öffentlichen Bereich, sodass Sie sehen können, was wir gerade tun. Wir freuen uns darauf, Ihre Fragen zu unserem Roadmap oder unseren Prioritäten über Github-Issues oder Discord.
Kann ich Capgo mit meiner Mannschaft verwenden?
Abschnitt mit dem Titel „Kann ich Capgo mit meiner Mannschaft verwenden?“Ja! Alle Pläne unterstützen unbegrenzte Entwickler. Wir beschränken nur App-Metriken (MAU, Speicher und Bandbreite) auf jede Organisation.
Siehe Teams für weitere Informationen.
Speichert Capgo meine Quellcode-code?
Abschnitt mit dem Titel ‘Soll Capgo meine Quellcode code speichern?’Nein. Capgo-Server sehen nie deine Quellcode code. Wenn du Capgo ausführst npx @capgo/cli@latest bundle upload, Capgo speichert eine Zip-Datei des minifizierten/verkompilierten code - den gleichen code wie einen Browser, nicht deine Quellcode code.
Für zusätzliche Sicherheit hast du zwei Optionen:
- End-to-End-Verschlüsselung: Verschlüssle deine Bundle vor dem Hochladen, um sie in der Speicherung und im Transit zu schützen und zu verhindern, dass Dritte gültig verschlüsselte Updates ohne deine private Schlüssel erstellen können. Dies macht die in der Verteilung befindlichen Web-Assets nicht unmöglich zu rückentwickeln, da der öffentliche Schlüssel im verteilten App vorhanden ist.
- Außereigene URL-Hochladen: Speichere die Bundle auf deinem eigenen Server und gib Capgo nur den Download-Link mit der Option
--external <url>
Siehe auch unsere Datenschutzrichtlinie: https://capgo.app/privacy
Sind Bundle-Dateien private Daten?
Abschnitt mit dem Titel „Sind Bundle-Dateien private Daten?“Nein. Bundle-Dateien sind öffentliche Web-Ressourcen, die von Ihren App-Benutzern heruntergeladen werden sollen. Jeder, der die Bundle-URL kennt, kann diese Dateien abrufen, und Capgo informiert die Benutzer darüber während der Einrichtung und in der Dokumentation.
Der Zugriff auf Bundle-Dateien gilt nicht als Datenverletzung. Legen Sie keine Geheimnisse, Anmeldeinformationen, persönliche Daten oder regulierte Daten in Ihrem App-Bundle ein. Wenn Sie für hochsichere Anwendungsfälle eine stärkere Vertraulichkeit benötigen, verwenden Sie end-to-end-Verschlüsselung, aber behandeln Sie verschickte App-code und -Assets weiterhin als öffentlich aus Sicherheitsberichterstattungsperspektive.
Kann ich Capgo aus meinem CI-System verwenden?
Abschnitt mit dem Titel „Kann ich Capgo aus meinem CI-System verwenden?“Ja. Capgo ist dafür gedacht, aus CI-Systemen verwendet zu werden. Wir haben eine Anleitung für Android und Github-Actions und iOS, und für GitLabEs sollten sich andere CI-Systeme ähnlich verhalten.
Bitte zögern Sie nicht, sich bei GitHub-Fehlern oder bei Discord zu melden, wenn Sie Probleme auftreten.
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 das Hinzufügen neuer code / das Ersetzen von code auf dem Gerät. Firebase Remote Config und Launch Darkly sind beide Konfigurationsysteme. Sie ermöglichen es Ihnen, die Konfiguration Ihres Apps ohne das Bereitstellen einer neuen Version zu ändern. Sie sind nicht dazu gedacht, code zu ersetzen.
Wie groß ist der Abhängigkeitsfußabdruck, den dies hinzufügt?
Abschnitt mit dem Titel „Wie groß ist der Abhängigkeitsfußabdruck, den dies hinzufügt?“Wir haben nicht kürzlich gemessen, aber ich erwarte, dass die code-Push-Bibliothek weniger als einen Megabyte an Capacitor-Apps hinzufügt. Wir wissen von Möglichkeiten, dies kleiner zu machen, wenn dies ein Prioritätsfall wird. Wenn Größe ein Hinderungsgrund für Sie ist, lassen Sie es uns bitte wissen!
Arbeitet Capgo auf dem iOS 18.4-Simulator?
Abschnitt mit dem Titel „Funktioniert Capgo auf dem iOS 18.4 Simulator?“Nein. Aufgrund eines upstream-Beitrags, der den iOS 18.4 Simulator beeinträchtigt, läuft Capgo dort nicht zuverlässig. Bitte testen Sie auf einem echten Gerät oder verwenden Sie eine andere iOS-Simulator-Version.
Siehe Details im React Native Issue: facebook/react-native#50510
Funktioniert code Push mit großen Anwendungen?
Abschnitt mit dem Titel „Funktioniert code Push mit großen Anwendungen?“Ja. Es gibt keine Grenze für die Größe der Anwendung, die mit code Push aktualisiert werden kann. Wie unten angegeben kann __CAPGO_KEEP_0__ jede JS __CAPGO_KEEP_1__ in Ihrer Anwendung ändern, unabhängig von der Größe., Capgo can change any JS code in your application regardless of size.
Wofür kann ich __CAPGO_KEEP_0__ __CAPGO_KEEP_1__ Push verwenden?
What can I use Capgo code push for?
Welche Capgo code kann man für Push-Notifizierungen verwenden?Wir haben eine Vielzahl von Anwendungen gesehen, darunter:
- Krisenfixe für Produktionsanwendungen.
- Die Lieferung von Bugfixen an Benutzer älterer Versionen Ihrer App.
- Die ständige Lieferung (z.B. alle Stunde).
Hinweis: Die meisten App-Stores verbieten die Lieferung von code, die das Verhalten der App in einem wesentlichen Umfang ändert. Bitte sehen Sie sich unten mehr Informationen an.
Welche Capgo gilt als "MAU"?
Welche Capgo gilt als "MAU"?Aktive Geräte pro Monat (MAU) ist eine Geräteanzahl, die innerhalb eines 30-Tage-Fensters Capgo kontaktiert. Ein einzelnes Gerät, das mit zwei verschiedenen native App-IDs verbunden ist, wird einmal für jede App-ID gezählt; es wird nicht über die App-IDs dedupliziert.
Wenn Ihre Flavours nur in ihrer Web-Schicht oder Update-Route differieren, verwenden Sie einen native App-Identifikator mit Kanäle. Damit bleiben die Flavours unter einem Capgo-App und machen Releases einfacher. Verwenden Sie separate native App-Identifikatoren, wenn eine Flavour eine unterschiedliche Bundle-ID, Signaturidentität, Berechtigungssatz oder Store-Liste benötigt.
Auf iOS v7.25.0+ behält die zufällige, app-geskoppelte Geräte-ID bei normalen Wiederherstellungen mit Keychain. Auf Android verwenden Sie v7.50.1+ (oder v5.50.1+ und context Bei diesen Releasezeilen); die ID wird nur wiederhergestellt, wenn Android Backup/Restore die App-Einstellungen aufbewahrt. Die Deaktivierung des Backups, die Ausschluss dieser Einstellungen oder die Löschung der App-Daten generiert eine neue Geräte-ID. Eine Aktualisierung der App erzeugt keine neue Geräte-ID.
Für Test- und Entwicklungsbuilds schalten Sie die Entwicklungsbau- und Emulatordelivery auf Produktionskanälen aus. Das steuert die Lieferung, nicht die MAU: Ein Gerät kann sich immer noch abmelden, wenn es Capgo kontaktiert. Um es aus der Produktionsnutzung auszuschließen, deaktivieren Sie Live-Updates und rufen keine Produktions-Capgo-Endpunkte auf. Siehe Test Native Builds Ohne Live-Updates um die genauen Einstellungen.
Was können wir nicht mit Capgo code pushen?
Abschnitt mit dem Titel “Was können wir nicht mit Capgo code pushen?”Capgo kann keine native code-Änderungen wie Java, Kotlin, Objective-C, Swift, native Plugins oder native Konfiguration vornehmen. Diese Änderungen erfordern eine neue native App-Veröffentlichung. Für den Store-Review-Bereich siehe App Store und Google Play Richtlinien.
Kann ich capacitor.config.ts-Änderungen über Capgo aktualisieren?
Kann ich capacitor.config.ts-Änderungen über Capgo aktualisieren?No. Short rule: Capgo can send the generated web build folder, including HTML, CSS, JavaScript, assets, and pure-JavaScript package changes bundled into that output. Changes to capacitor.config.tsKurzregel: __CAPGO_KEEP_0__ kann den generierten Web-Build-Ordner, einschließlich HTML, CSS, JavaScript, Assets und reinen JavaScript-Paketänderungen, der in diesem Ausgangsordner gebündelt sind, senden. Änderungen an npx cap sync oder npx cap copy oder
The Capacitor configuration file is read at native build time and compiled into the native app binary. If you need to change your Capacitor configuration, you must:
- oder
capacitor.config.tsoder - oder
npx cap syncoder - oder
Does Capgo submit to the stores for me?
Abschnitt mit dem Titel „Kann Capgo für mich in die Stores einreichen?“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-Synchronisierung und benutzerdefinierte natives Vorbereitung beibehalten; Capgo erhält das vorbereitete natives Projekt für den natives Build-Schritt.
Siehe Capgo Build und die Referenz zur Build-Konfiguration für den Workflow und die Optionen für die Einreichung bei den Stores.
Was speichert Capgo auf dem Festplatte und wo?
Abschnitt mit dem Titel „Was speichert Capgo auf dem Festplatte und wo?“Der Capgo-Updater (in Ihrem Anwendungsprogramm enthalten, wenn Sie Ihr Anwendungsprogramm bauen) cachet die neuesten heruntergeladenen Bundle in dem einzigen Verzeichnis, das capacitor erlaubt, code zu laden. Auf Android-Geräten ist dies unter /data/user/0/com.example.app/code_cache/capgo_updater obwohl der Basispfad dieses Pfades vom Android-System bereitgestellt wird und sich dynamisch während der Laufzeit ändern kann. Auf iOS-Geräten wird die Daten unter Library/Application Support/capgo.
Die Capgo-Befehlszeilenwerkzeuge (z.B. npx @capgo/cli@latest bundle upload) werden auf dem Disk in npm-Caches installiert, Ihre Anmeldedaten werden in Ihrem Home-Verzeichnis gespeichert in ~/.capgo.
Wie verhält sich dies zu Capacitor Hot Reload?
Abschnitt mit dem Titel “Wie verhält sich dies zu Capacitor Hot Reload?”Capacitor’s Hot reload ist eine Entwicklungszieldienst. Code push ist für die Produktion.
Hot reload ist eine Funktion von Capacitor, die es Ihnen ermöglicht, während der Entwicklung code auf dem Gerät zu ändern. Es erfordert die Erstellung des Capacitor-Apps mit einem Proxy, um mit Ihrem lokalen Computer zu verbinden.
Code push ist eine Funktion, die es Ihnen ermöglicht, während der Produktion code auf dem Gerät zu ändern. Wir werden eine Vielzahl von verschiedenen Techniken verwenden, um dies möglich zu machen, je nach Plattform.
Welche Arten von Änderungen unterstützt Capgo code push?
Abschnitt mit dem Titel “Welche Arten von Änderungen unterstützt Capgo code push?”Capgo kann jede JS code in Ihrer Anwendung ändern. Dies umfasst Anwendungs code und generierte code. Sie können auch Abhängigkeiten in package.json solange sie native code-Änderungen nicht erfordern.
Wir haben keine Pläne, native code (z.B. Java/Kotlin auf Android oder Objective-C/Swift auf iOS) zu unterstützen, und das Tool wird Sie warnen, wenn es feststellt, dass Sie native code geändert haben, da dies nicht in der Bundle enthalten ist.
Unterstützt dies Web?
Abschnitt mit dem Titel „Unterstützt dies Web?“Code-Push ist für Web nicht erforderlich, da Web bereits auf diese Weise funktioniert. Wenn ein Benutzer eine Web-Anwendung öffnet, lädt sie die neueste Version vom Server herunter, wenn erforderlich.
Wenn Sie ein Szenario für code-Push mit Web haben, würden wir gerne davon erfahren!
Wird dies auf iOS, Android, Mac, Windows, Linux usw. funktionieren?
Abschnitt mit dem Titel „Wird dies auf iOS, Android, Mac, Windows, Linux usw. funktionieren?“Ja.
Bisher haben wir uns auf Android, iOS und Electron-Unterstützung konzentriert, und code-Push ist auf allen drei Plattformen in der Produktion bereit.
Welche Betriebssystemversionen unterstützt Capgo?
Abschnitt mit dem Titel „Welche Betriebssystemversionen unterstützt Capgo?“Capgo unterstützt die gleichen Versionen von Android wie Capacitor.
Capacitor unterstützt derzeit Android API-Level 22+ und iOS 13.0+: https://capacitorjs.com/docs/main/reference/support-policy
Welche Versionen von Capacitor unterstützt Capgo?
Abschnitt mit dem Titel „Welche Versionen von Capacitor unterstützt Capgo?“Capgo unterstützt derzeit nur die letzten stabilen Releases von Capacitor. Wir könnten auch ältere Versionen von Capacitor unterstützen, wir haben es jedoch noch nicht geschafft, die notwendige Infrastruktur aufzubauen, um solche Versionen im Laufe der Zeit zu unterstützen. Wir planen, in Zukunft mehr Versionen von Capacitor zu unterstützen, einschließlich jeder Version für unsere Unternehmenstkunden. https://github.com/Cap-go/capgo/issues/1100
Capgo verfolgt die stabilen Versionen von Capacitor und aktualisiert sich innerhalb weniger Stunden nach jeder stabilen Veröffentlichung. Unser System für diese Updates ist automatisiert und dauert einige Minuten, um durchzuführen. Wir führen dann einen zusätzlichen manuellen Überprüfungs-Schritt durch, bevor wir die Updates auf unseren Servern veröffentlichen.
Wie verhält sich dies zum App/Play Store-Bewertungsprozess oder -richtlinien?
Abschnitt mit dem Titel „Wie verhält sich dies zum App/Play Store-Bewertungsprozess oder -richtlinien?“Capgo überträgt Änderungen nur auf die Capacitor Web-Schicht: die HTML, CSS, JavaScript und Assets, die bereits im WebView des Apps laufen. Es ändert nicht den nativen Binärdatei, nativen Plugins, Berechtigungen, Zulassungen, Signierung oder Store-Metadaten.
Verwenden Sie für jede native Änderung und für materialische Änderungen, die das Ziel oder die Funktionalität des Apps beeinflussen könnten, eine native Store-Veröffentlichung. Halten Sie Live-Updates innerhalb der App-Erfahrung, die Sie eingereicht und den Benutzern offen gelegt haben.
Garantiert Capgo die Zulassung durch den App Store oder Google Play?
Abschnitt mit dem Titel „Garantiert Capgo die Zulassung durch den App Store oder Google Play?“Nein. Apple und Google prüfen jede App und Veröffentlichung auf ihre eigenen Fakten, und Capgo kann keine individuelle Zulassung oder Bewertungsergebnis garantieren. Ihr Team bleibt für die Inhalte, Offenlegungen, Update-Umfang und Einhaltung der aktuellen Store-Richtlinien verantwortlich.
Für die Bewertung und Veröffentlichungsplanung lesen Sie die offiziellen Richtlinien direkt: Apple App Store Review Guidelines und Google Play Geräte- und Netzwerkmissbrauchsrichtlinie.
Kann ich Capgo in meinem Land verwenden?
Abschnitt mit dem Titel „Kann ich Capgo in meinem Land verwenden?“Wir haben versucht, keinen Zugriff auf Capgo aus irgendeinem Land zu beschränken.
Wir erkennen an, dass einige Länder Einschränkungen auf die von innerhalb des Landes zugänglichen URLs haben. Capgo verwendet derzeit Cloudflare Cloud für die Hosting, einschließlich R2 Storage und Cloudflare-Arbeitern.
Die folgenden URLs werden von Capgo verwendet:
- https://api.capgo.app — verwendet von den
npx @capgo/cliBefehlszeilen-Tools, um mit den Capgo-Servern sowie mit dem Capgo-Updater auf den Geräten der Benutzer, um nach Updates zu suchen. - https://*.r2.cloudflarestorage.com — verwendet von den
npx @capgo/cliKommandozeilenwerkzeug zum Hochladen und Herunterladen von Bundle
Wenn alle dieser URLs in Ihrem Land zugänglich sind, sollte Capgo funktionieren.
Wenn Ihr Land Zugriff auf jede dieser URLs blockiert, teilen Sie uns dies bitte mit und wir können gemeinsam eine Lösung finden. Proxy-Server sind eine Option.
Kann ich Capgo selbst hosten?
Abschnitt mit dem Titel „Kann ich Capgo selbst hosten?“Ja. Enterprise unterstützt lizenzierte selbst gehostete Capgo-Dienste, wenn Sie den Updater-Backend in Ihrer eigenen Infrastruktur ausführen müssen. Siehe Selbst gehosteter Updater für das Bereitstellungsmodell und die Endpunkte.
Braucht code-Push die Internetverbindung, um zu funktionieren?
Abschnitt mit dem Titel „Braucht code-Push die Internetverbindung, um zu funktionieren?“Wenn Sie eine Server-Instanz betreiben möchten, um die Updates separat von der allgemeinen Internetverbindung zu verteilen, ist dies möglich, aber eine Form der Netzwerkverbindung ist erforderlich, um Updates an die Geräte zu transportieren.
Welche Auswirkungen hat die Capgo-Funktionalität bei Ausfall der Netzwerkverbindung?
Abschnitt mit dem Titel „Welche Auswirkungen hat die Capgo-Funktionalität bei Ausfall der Netzwerkverbindung?“Der Capgo-Updater (in Ihrem Anwendungsprojekt enthalten, wenn Sie Ihr Projekt mit Capgo erstellen) ist auf Netzwerkverbindungsprobleme vorbereitet.
Bei der Standardaktualisierungsverhalten startet die Anwendung den Capgo-Updater, der einen separaten Thread startet, um eine Netzwerk-Anfrage an Capgo-Server zu senden und nach einer Aktualisierung zu fragen. Wir verwenden absichtlich einen separaten Thread, um sicherzustellen, dass die Aktualisierung nicht die Blockierung anderer Anwendungsprozesse verursacht. Wenn die Netzwerk-Anfrage fehlschlägt oder abläuft, wird der Updater einfach versuchen, wieder zu überprüfen, wenn die Anwendung erneut gestartet wird.
Die Capgo-Befehlszeilenwerkzeuge (z.B. npx @capgo/cli@latest bundle upload) benötigen Netzwerkverbindung, um zu funktionieren. Wenn Sie Capgo verwenden, um Ihre App zu verteilen, sollten Sie sicherstellen, dass Ihr CI-System eine Netzwerkverbindung hat.
Welche Auswirkungen hat es, wenn ein Benutzer lange Zeit keine Aktualisierung durchführt und eine Aktualisierung verpasst?
Abschnitt mit dem Titel „Welche Auswirkungen hat es, wenn ein Benutzer lange Zeit keine Aktualisierung durchführt und eine Aktualisierung verpasst?“Unsere Implementierung sendet immer eine Aktualisierung, die speziell auf das Gerät zugeschnitten ist, das sie anfordert, und aktualisiert den Anforderer immer auf die neueste verfügbare Version.
Der Aktualisierungsserver könnte so konfiguriert werden, dass er entweder die nächste inkrementelle Version oder die neueste Version antwortet, je nach Bedarf Ihres Anwendungsprojekts. Bitte lassen Sie uns wissen, wenn alternative Aktualisierungsverhaltensweisen für Sie wichtig sind.
Wie steht Capgo zu Capacitor?
Abschnitt mit dem Titel "Wie steht Capgo zu Capacitor?"Capgo ist ein Plugin für Capacitor, das code-Push hinzufügt. Capgo ist kein Ersatz für Capacitor. Sie können weiterhin die Capacitor-Tooling verwenden, die Sie bereits kennen und lieben.
Wir verfolgen die neueste stabile Version von Capacitor und aktualisieren unser code-Push-Plugin, um mit ihr zu funktionieren.
Wann passieren Aktualisierungen?
Abschnitt mit dem Titel "Wann passieren Aktualisierungen?"Standardmäßig überprüft der Capgo-Updater bei der Anwendungsstart auf Aktualisierungen. Er läuft auf einem Hintergrundthread und blockiert nicht den UI-Thread. Alle Aktualisierungen werden während der Benutzung der Anwendung installiert und werden bei der nächsten Anwendungsstart angewendet.
Es ist auch möglich, den Capgo-Updater manuell auszuführen, indem man den @capgo/capacitor-updater Durch dieses Paket können Updates jederzeit ausgelöst werden, einschließlich über eine Push-Benachrichtigung.
Der Capgo-Updater ist so konzipiert, dass das App-Programm auch dann wie gewohnt läuft, wenn das Netzwerk nicht verfügbar ist oder der Server nicht erreichbar ist. Wenn Sie je eine Aktualisierung von unseren Servern löschen, werden alle Ihre Clients wie gewohnt laufen.
Wir haben die Möglichkeit zur Rückgängigmachung von Patches hinzugefügt. Das Einfachste ist, einfach eine vorherige Bundle an Ihren Kanal anzuhängen, um es rückgängig zu machen.
Muss ich mein app_id-Schlüssel aufbewahren?
Abschnitt mit dem Titel „Muss ich mein app_id-Schlüssel aufbewahren?“Nein. Der app_id ist in Ihrer App enthalten und ist sicher, wenn er öffentlich ist. Sie können ihn in die Versionskontrolle einchecken (auch öffentlich) und müssen sich nicht um jemanden Sorgen machen, der ihn zugreifen kann.
Jemand, der Ihren app_id kann die neueste Version Ihrer App von den Capgo-Servern abrufen, aber er kann keine Updates an Ihre App pushen oder Zugriff auf einen anderen Aspekt Ihres Capgo-Kontos haben.
Welche Informationen werden an die Capgo-Server gesendet?
Abschnitt mit dem Titel “Was wird an Capgo-Servern gesendet?”Die vollständige Dateninventur, das Verhalten der Endpunkte und die Datenschutzkontrollen sind in Kongruenz.
Setzen statsUrl: '' um explizite Updater-Statistikberichte zu deaktivieren. Sie können auch statsUrl an einen Proxy oder einen von Ihnen verwalteten Endpunkt senden; siehe Statistik-Handling in selbst gehosteter Infrastruktur. Die Update-Überprüfungen benötigen jedoch eine App-basierte Geräte-ID, damit Capgo die richtige Aktualisierung auswählen und die monatlichen aktiven Geräte zählen kann.
Der Unterprozessor-Liste ist unsere aktuelle öffentliche Quelle der Wahrheit für Anbieter, Verarbeitungsorte, Übertragungsmechanismen und Änderungsgeschichte.
Kann ich Capgo für Apps verwenden, die HIPAA-sensitive sind?
Abschnitt mit dem Titel „Kann ich Capgo für Apps mit HIPAA-Sensitivität verwenden?“Ja, aber Ihr Compliance-Besitzer muss die richtige Bereitstellungsstrategie wählen. Capgo Cloud wird derzeit nicht als HIPAA-konformes gehostetes Statistikverarbeitungsmodell vorgestellt. Standardmäßig ist die Updater-Daten auf Geräteebene skaliert und nicht an einen bekannten App-Benutzer gebunden, und viele Teams verwenden diesen Modus erfolgreich.
Für strengere Überprüfungen können Sie den Plugin-Verkehr geo-lokalisieren, die Statistikfunktion durch Festlegen von statsUrl auf eine leere Zeichenkette setzen, die Statistik-Endpunkt nur selbst hosten oder lizenziertes Self-Hosting verwenden. Rufen Sie CapacitorUpdater.setCustomId(...) nicht mit einer E-Mail, Benutzer-ID, Patienten-ID, Mitarbeiter-ID oder einem Wert auf, der die Updater-Telemetrie auf eine Person zurückmappen würde.
Siehe HIPAA-Konformität für die vollständige technische Einrichtung und die Beobachtbarkeitstradeoffs, wenn die Statistikfunktion deaktiviert ist.
Kann ich Capgo-Live-Update-Daten in Europa speichern?
Abschnitt mit dem Titel „Kann ich Capgo-Live-Update-Daten in Europa speichern?“Yes. Apps, die für die EU-Datenspeicherung von Capgo Cloud-Plugin-Verkehr benötigen, können die Updater-Endpunkte auf den EU-Host einstellen:
updateUrl:https://plugin.eu.capgo.app/updatesstatsUrl:https://plugin.eu.capgo.app/statschannelUrl:https://plugin.eu.capgo.app/channel_self
Verwenden Sie alle drei EU-URLs gemeinsam, damit Update-Überprüfungen, Statistiken und die Selbstzuweisung des Kanals die gleiche regionale Datenpfade verwenden. Diese Werte leben in capacitor.config.ts, Produktionsmobilanwendungen benötigen eine native Veröffentlichung, bevor bestehende Installationen die neuen Endpunkte verwenden.
Siehe Datenstandort für genaue Capacitor- und Electron-Beispiele.
Welche Plattformen unterstützt Capgo?
Abschnitt mit dem Titel „Welche Plattformen unterstützt Capgo?“Derzeit unterstützt Capgo Android, iOS und Electron. Alle sind production-ready.
Die Verwendung von Capgo für iOS, Android oder Electron kann unabhängige Entscheidungen sein. Sie können Ihre Kanalstrategie für Android und eine IPA, die auf dem App Store gebaut wurde, oder Electron-Kanäle, wie erforderlich, einstellen.
Capgo kann (relativ leicht) für Desktop- oder eingebettete Ziele unterstützt werden. Wenn diese für Sie wichtig sind, teilen Sie es uns bitte mit.
How verhält sich Capgo zu Google Play Test-Tracks oder Apple TestFlight?
Abschnitt mit dem Titel “How verhält sich Capgo zu Google Play Test-Tracks oder Apple TestFlight?”Jeder der App-Stores hat eigene Mechanismen, um Apps an begrenzte Gruppen von Benutzern zu verteilen (z.B. “internes Testen”, “geschlossene Beta”, usw.). Diese sind alle Mechanismen, um Ihre Benutzer in Gruppen zu segmentieren und bestimmte Versionen Ihrer Apps an jede Gruppe zu verteilen.
Leider ermöglichen nicht alle diese Mechanismen es Drittanbietern, zu erkennen, wenn Apps in einem bestimmten Test-Track oder über TestFlight installiert sind. Daher haben wir keine zuverlässige Sicht auf die Zusammensetzung dieser Gruppen und können nicht zuverlässig den Zugriff auf Capgo-Patches auf der Grundlage dieser Gruppen steuern. https://stackoverflow.com/questions/53291007/kann-ein-Android-Anwendungsprogramm den Test-Track innerhalb von Google Play erkennen? https://stackoverflow.com/questions/26081543/wie kann man am Laufzeit erkennen, ob eine iOS-Anwendung über einen Testflight-Beta-Test läuft?
Wenn Sie die Verfügbarkeit des Capgo-Bundles segmentieren möchten, gibt es 4 mögliche Optionen:
- Verwenden Sie für jede Gruppe einen separaten Kanal. Dies ist der direkteste Ansatz, erfordert jedoch die Verwaltung mehrerer Kanäle. Sie haben möglicherweise bereits Entwicklerkanäle und Produktionskanäle mit unterschiedlicher Verfügbarkeit. Sie können Ihre Entwicklerkanäle aktualisieren, überprüfen und dann separat Ihre Produktionskanäle aktualisieren. Wir empfehlen die Verwendung von Branches / Tags in Ihrer Versionskontrolle, um die Quellen zu verfolgen, die mit jeder Veröffentlichung verbunden sind.
- Verfolgen Sie Ihre eigene Liste von opt-in-Nutzern, deaktivieren Sie automatische Updates und lösen Sie Updates nur für bestimmte Nutzer über das
@capgo/capacitor-updaterpackage aus. Dies funktioniert heute, erfordert jedoch die Verwaltung Ihrer eigenen opt-in-Liste. - Capgo ermöglicht die Erstellung eigener opt-in-Mechanismen auf Gerätebasis (ähnlich wie Test Tracks oder TestFlight, nur plattformübergreifend). Dies ermöglicht es Ihrem QA-Team, sich auf eine Bundle vor der Veröffentlichung für die Allgemeinheit zu opt-in.
- Verwenden Sie progressive rollouts um ein Kandidaten-Bundle an einem zufälligen, festen Teil eines Kanals zu liefern. Legen Sie eine Ausrollung von 0–100% fest oder verwenden Sie
--rollout-percentage-bpsmit 0,01%-Schritten; konfigurieren Sie die Cache-Dauer von 60 Sekunden bis 365 Tagen und optional eine automatische Pause-Politik. Dies wählt keine benannte Gerätegruppe aus.
Rechnung
Direkter Link zu RechnungSektion mit dem Titel „Rechnung“
Abschnitt mit dem Titel “Wie kann ich meinen Tarif auf- oder herabstufen?”Sie können Ihren Tarif jederzeit in Ihrem Dashboard auf- oder herabstufen: https://console.capgo.app/einstellungen/organisation/tarife
Wann wird mein Abrechnungszeitraum neu gesetzt?
Abschnitt mit dem Titel “Wann wird mein Abrechnungszeitraum neu gesetzt?”Die Abrechnungszeiträume werden automatisch jeden Monat neu gesetzt, an dem Sie sich erstmals bei Capgo angemeldet haben. Zum Beispiel wird Ihr Abrechnungszeitraum, wenn Sie sich am 15. des Monats angemeldet haben, am 15. jeden Monats neu gesetzt.
Wie kann ich meine Abonnementkündigung vornehmen?
Abschnitt mit dem Titel “Wie kann ich meine Abonnementkündigung vornehmen?”Sie können Ihre Abonnementkündigung jederzeit in Ihrem Dashboard vornehmen: https://console.capgo.app/einstellungen/organisation/pläne
Kann ich ein Jahr im Voraus bezahlen?
Abschnitt mit dem Titel „Kann ich ein Jahr im Voraus bezahlen?“Ja. Sie können die jährliche Abrechnung in Ihren Organisationsplan-Einstellungen wählen.
Welche Faktoren zählen zum Speicherplatz und können wir die Aufbewahrung ändern?
Abschnitt mit dem Titel „Welche Faktoren zählen zum Speicherplatz und können wir die Aufbewahrung ändern?“Der Speicherplatz umfasst die historischen Bundle und ihre Delta-Assets über alle Kanäle. Sie können die Aufbewahrung von nicht genutzten Bundles für jede App in den App-Einstellungen steuern. Bundles, die an einem aktiven Kanal oder Rollout angekoppelt sind, bleiben geschützt und bleiben für die Lieferung und Rückschaltung verfügbar.
Multipliziert regionale Replikation den Speicherplatz oder die Bandbreite?
Abschnitt mit dem Titel ‘Wird die regionale Wiederherstellung die Speicherung oder die Bandbreite multiplizieren?’Nein. Ein Bundle wird einmal für die Speicherung gezählt, unabhängig von den Regionen, die es bedienen. Capgo Bandbreite basiert auf Geräteherunterladungen, die nicht aus dem Edge-Cache geliefert werden; cache-gediente Lieferungen zählen nicht gegen Capgo Bandbreitenutzung.
Was umfasst das Enterprise SLA?
Abschnitt mit dem Titel ‘Was umfasst das Enterprise SLA?’Das Enterprise umfasst eine monatliche Verfügbarkeitszusage von 99,9 % für das Produktionsplattform. Wenn diese Zusage verpasst wird, ist das Service-Kredit-Schema 10 % bis 30 % basierend auf der monatlichen Verfügbarkeit. Die Anfangsunterstützung-Zielen sind P1: eine Stunde, 24/7/365; P2: zwei Geschäftsstunden; P3: eine Geschäftsstunde; und P4: zwei Geschäftsstunden. Lesen Sie den Enterprise SLA für die vollständigen Bedingungen.
Statistiken und Analysen
Abschnitt mit dem Titel ‘Statistiken und Analysen’Die Statistiken in Ihrem Dashboard werden alle Nacht UTC aktualisiert. Die Statistiken werden aus den unterschiedlichen MAUs aktiv während der laufenden 30-Tage-Frist.
Wie die Geräte-ID generiert wird
Abschnitt mit dem Titel „Wie die Geräte-ID generiert wird“Die Geräte-ID wird auf dem Gerät bei der ersten Ausführung generiert und wird verwendet, um Duplikate pro Gerät zu vermeiden und es uns zu ermöglichen, auf Basis der von Benutzern installierten Geräte zu berechnen (z.B. monatlich aktive Benutzer), anstatt auf die Gesamtzahl der Patches oder die Gesamtzahl der Patches zu installieren.
MAU is a better solution than number of installs to price Capgo, as it is more accurate and reflects the actual cost of Capgo per device.
Geräte-ID-Persistenz:
- iOS: Ab v7.25.0+ wird die Geräte-ID in Keychain gespeichert und bei normalen Wiederinstallierungen persistiert.
- Android: Verwenden Sie v7.50.1+ (oder v5.50.1+/v6.50.1+ auf diesen Release-Linien). Die Geräte-ID wird nur dann wiederhergestellt, wenn Android Backup/Restore die App-Einstellungen aufbewahrt.
- Elektron: Die Geräte-ID wird in sicheren Speicher gespeichert.
- Android-Hinweis: Die Deaktivierung des Backups, die Ausschluss der relevanten Einstellungen oder die Löschung der App-Daten generiert eine neue Geräte-ID. Android v7.25.0 bis v7.50.0 kann eine neue Geräte-ID auch nach einer Wiederinstallation generieren, wenn das Backup aktiviert ist.
: Die Geräte-ID ist app-gesponsert und unterstützt die Live-Update-Übermittlung und die MAU-Duplikationsvermeidung; sie ist kein Werbe- oder Cross-App-Tracking-Identifier.
: Die Geräte-IDs werden nach dem App-Check-in mit Capgo über den Updater oder die Statistik-Endpunkte aufgelistet. Ein Gerät muss keine Patches installieren, bevor es in der Geräte-Liste erscheint.
Wieso ist meine Gerätezahl anders als meine MAU?
Abschnitt mit dem Titel ‘Wieso ist meine Gerätezahl anders als meine MAU?’: Die Geräte-Liste und die MAU basieren auf unterschiedlichen Signalen.
: Die Geräte-Liste zeigt die neuesten bekannten Metadaten für jedes Gerät an, wie z.B. die Geräte-ID, die Plattform, die Plugin-Version, die Betriebssystemversion, die native Version, den Kanal, die installierte Bundle und den Anfrage-Landkreis, wenn verfügbar. Der Anfrage-Landkreis ist die neueste gültige zwei-Buchstaben-code-Eingabe, die von einem Cloudflare-bearbeiteten Anfrage für das Gerät erhalten wurde, nicht GPS oder app-bereitgestellte Standortangabe. Anfragen ohne einen gültigen Landkreis löschen nicht die letzte gültige Werte. Capgo aktualisiert diese Metadaten, wenn die App sich meldet, aber wiederholte Meldungen, die die gleichen Metadaten melden, ändern möglicherweise nicht die Zeile oder ihren letzten Update-Zeitpunkt.
MAU zählt unterschiedliche aktive Geräte während der Abrechnungszeit. Diese Aktivität kann sogar dann zunehmen, wenn das Gerätemetadaten unverändert bleibt, daher können die Geräteanzahl und MAU unterschiedlich sein.
Wie kann ich unterschiedliche Updates durchführen?
Abschnitt mit dem Titel „Wie kann ich unterschiedliche Updates durchführen?‟Sie können für jede Plattform einen Kanal erstellen und in jedem Kanal die plattformspezifischen Updates deaktivieren.
Bei dem iOS-Kanal die Android-Updates deaktivieren und bei dem Android-Kanal die iOS-Updates deaktivieren.
Uploaden Sie dann ein Bundle zu jedem Kanal, um unterschiedliche Updates für jede Plattform durchzuführen.
Wenn Sie das gleiche Update für beide Plattformen benötigen, können Sie ein Bundle mit mehreren Kanälen verknüpfen. Es ist nicht notwendig, das Bundle zu duplizieren.
Fortsetzen Sie mit den FAQs.
Abschnitt mit dem Titel „Fortsetzen Sie mit den FAQs‟.Wenn Sie FAQs um Live-Update-Übermittlung zu planen, verbinden Sie es mit Capgo Live Updates für den Produktworkflow in Capgo Live Updates Übersicht für die Implementierungsdetails in Übersicht Funktionen für die Implementierungsdetails in Funktionen Aktualisierungsverhalten für die Implementierungsdetails in Aktualisierungsverhalten, und Aktualisierungstypen für die Implementierungsdetails in Aktualisierungstypen.