FAQ
Eine Einrichtungsvorlage mit den Installationsanweisungen 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"?
Abschnitt: Was ist "code push"?Code push, auch als "over-the-air-Updates" (OTA) bezeichnet, ist ein Cloud-Dienst, der Entwicklern von Capacitor 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?
Abschnitt: Müssen Capgo CLI-Majoren mit meiner Plugin- oder Capacitor-Version übereinstimmen?Nein. Verwenden Sie immer die neueste Capgo CLI (npx @capgo/cli@latestDie CLI und Capgo-Konsole folgen ihrem eigenen Versionsmanagement und bleiben mit jedem unterstützten Updater-Plugin-Major kompatibel. Capgo-Plugins folgen Capacitor-Majoren; siehe Capgo Versionsverwaltung 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 an die App-Stores gesendet 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. Das npx @capgo/cli@latest bundle upload Der Befehl wird verwendet, um ein Bundle aus Ihrem neuen lokalen code zu generieren, das dann an Ihre Benutzer gesendet wird.
Sind es Einschränkungen für die Pfad-Dateien von Delta-Updates?
Abschnitt mit dem Titel „Sind es Einschränkungen für die Pfad-Dateien von Delta-Updates?“Ja:
- Null-Byte-Dateien: Die CLI-Protokolle
Ignoring empty file...und schließen leere Dateien aus der Delta-Manifest. Es wird keine Upload-Fehler ausgelöst, sodass eine leere Datei ohne das Deployment zu unterbrechen den resultierenden Bundle ä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. Dateien oder Verzeichnisse umbenennen, um Leerzeichen zu entfernen, bevor ein Delta-Update hochgeladen wird.
Siehe Delta-Updates für weitere Einzelheiten.
Was ist die Roadmap?
Unsere Projektboards sind auch öffentlich und finden Sie sie unter:Unsere Projektboards sind auch öffentlich und finden Sie sie unter: 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 “Sind Capgo-Server meine Quellcode-code-Dateien?”Nein. Capgo-Server sehen Ihre Quellcode-code-Dateien nie. Wenn Sie Capgo ausführen npx @capgo/cli@latest bundle upload, speichert Capgo eine Zip-Datei mit den minimierten/verkompilierten code-Dateien – demselben code wie ein Browser, nicht Ihre Quellcode-code-Dateien.
Für zusätzliche Sicherheit haben Sie zwei Optionen:
- End-to-End-Verschlüsselung: Verschlüsseln Sie Ihr Bundle, bevor Sie es hochladen, um es in der Speicherung und im Transit zu schützen, und um es dritten Parteien zu verhindern, gültig verschlüsselte Updates ohne Ihre private Schlüssel zu generieren. Dies macht die im Vertrieb befindlichen Web-Ressourcen nicht unmöglich zu rückentwickeln, da der öffentliche Schlüssel im verteilten App vorhanden ist.
- Externes URL-Hochladen: Speichern Sie das Bundle auf Ihrem eigenen Server und geben Sie 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 wird nicht als Datenverlust betrachtet. 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 Ende-zu-Ende-Verschlüsselung, aber behandeln Sie verschickte App-code und -Assets immer noch als öffentlich aus Sicherheitsberichtsperspektive.
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 iOSund 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 steht es zu Firebase Remote Config oder Launch Darkly?
Abschnitt mit dem Titel „Wie steht es zu Firebase Remote Config oder Launch Darkly?“Code-Push ermöglicht das Hinzufügen neuer code / 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 eine neue 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 Blockierer 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 beeinflusst, 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.
Was kann ich mit __CAPGO_KEEP_0__ __CAPGO_KEEP_1__ push machen?
What can I use Capgo code push for?
Abschnitt mit dem Titel "Was kann ich Capgo code für Pushen verwenden?"Wir haben eine Vielzahl von Anwendungen gesehen, einschließlich:
- Notfall-Reparaturen für Produktionsanwendungen.
- Versand von Bug-Fixes an Benutzer mit älteren Versionen Ihrer App.
- Versand von Updates (z.B. alle Stunde).
Hinweis: Die meisten App-Stores verbieten den Versand von code, der das Verhalten der App in einem wesentlichen Maße ändert. Bitte sehen Sie sich unten für weitere Informationen an.
Was zählt als "MAU" für Capgo?
Abschnitt mit dem Titel "Was zählt als "MAU" für Capgo?"Aktive Geräte pro Monat (MAU) ist eine Geräteanzahl, die innerhalb eines 30-Tage-Fensters eine Verbindung zu Capgo herstellt. 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 dupliziert.
Wenn Ihre Flavours nur in ihrer Web-Schicht oder Update-Route unterschiedlich sind, verwenden Sie einen native App-Id mit Kanäle. Damit bleiben die Flavours unter einer einzigen Capgo-App und die Releases werden einfacher. Verwenden Sie separate native App-Ids, wenn eine Flavour eine unterschiedliche Bundle-ID, Signaturidentität, Berechtigungssatz oder Store-Liste benötigt.
Auf iOS v7.25.0+ bewahrt die zufällige, app-gespeicherte Geräte-ID bei normalen Wiederinstallierungen über Keychain. Auf Android verwenden Sie v7.50.1+ (oder v5.50.1+ und context Wenn Sie die Veröffentlichungszeilen deaktivieren, wird die ID nur dann wiederhergestellt, wenn Android Backup/Restore die App-Einstellungen speichert. Die Deaktivierung des Backups, die Ausschluss der Einstellungen oder die Löschung der App-Daten generiert eine neue Gerätekennung. Eine Aktualisierung der App erzeugt keine neue Gerätekennung.
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 trotzdem anmelden, 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 zu sehen.
Was können wir nicht mit Capgo code Push verwenden?
Abschnitt mit dem Titel “Was können wir nicht mit Capgo code Push verwenden?”Capgo kann keine native code-Änderungen wie Java, Kotlin, Objective-C, Swift, native Plugins oder native Konfiguration vornehmen. Solche Ä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?
Abschnitt mit dem Titel “Kann ich capacitor.config.ts-Änderungen über Capgo aktualisieren?”No. Kurzregel: Capgo kann den generierten Web-Build-Ordner, einschließlich HTML, CSS, JavaScript, Assets und reinen JavaScript-Paketänderungen, der in diesem Output gebündelt sind, senden. Änderungen an capacitor.config.ts, native Plugin-Konfiguration, native Paket-Installationen oder -Upgrades und alles, was eine Aktualisierung der iOS- oder Android-Projekte erfordert durch 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:
- Die __CAPGO_KEEP_0__-Konfigurationsdatei wird bei der native Build-Zeit gelesen und in das native App-Binär kompiliert. Wenn Sie Ihre __CAPGO_KEEP_1__-Konfiguration ändern müssen, müssen Sie:
capacitor.config.tsUpdate - lokal
npx cap syncWieder aufbauen Sie Ihre native App ( - gefolgt von einer native Build)
Does Capgo submit to the stores for me?
Abschnitt mit dem Titel “Befolgt Capgo die App-Stores für mich?”Capgo Build kann eine vorbereitete native iOS- oder Android-Anwendung 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 native Vorbereitung beibehalten; Capgo erhält die vorbereitete native Anwendung für den native Build-Schritt.
Siehe Capgo Build und die Referenz zur Build-Konfiguration für die Workflow- und Store-Einreichungsoptionen.
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 Ihre App erstellen) 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 werden 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 in ~/.capgo.
Wie verhält sich dies zur Capacitor-Hot-Reload?
Abschnitt mit dem Titel “Wie verhält sich dies zur Capacitor-Hot-Reload?”Capacitor's Hot-Reload ist eine Entwicklungszieldienst. Code push ist für die Produktion.
Hot-Reload ist eine Capacitor-Funktion, die Ihnen ermöglicht, während der Entwicklung code auf dem Gerät zu ändern. Dazu muss die Capacitor-App mit einem Proxy zum Verbinden mit Ihrem lokalen Computer erstellt werden.
Code push ist eine Funktion, die es Ihnen ermöglicht, während der Produktion code auf dem Gerät zu ändern. Wir werden verschiedene 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 As lange 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 die Werkzeug warnen Sie, wenn es feststellt, dass Sie native code geändert haben, da dies nicht in der Bundle enthalten ist.
Gibt es Unterstützung für Web?
Abschnitt mit dem Titel „Gibt es Unterstützung für 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!
Arbeitet dies auf iOS, Android, Mac, Windows, Linux usw.?
Abschnitt mit dem Titel „Arbeitet dies auf iOS, Android, Mac, Windows, Linux usw.? “Ja.
Wir haben uns bisher auf Android, iOS und Electron-Unterstützung konzentriert und code Push ist auf allen drei Plattformen in der Produktion bereitgestellt.
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 aktuelle stabile 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 Capacitor-Stable und aktualisiert sich innerhalb weniger Stunden nach jeder stabilen Veröffentlichung. Unser System für diese Updates ist automatisiert und dauert einige Minuten, um abzulaufen. Wir führen dann einen zusätzlichen manuellen Überprüfungs-Schritt durch, bevor wir die Updates auf unseren Servern veröffentlichen.
How verhält sich dies zur App/Play Store-Bewertungsprozess oder -politik?
Abschnitt mit dem Titel “How verhält sich dies zur App/Play Store-Bewertungsprozess oder -politik?”Capgo übermittelt Änderungen nur an der Capacitor Web-Schicht: dem HTML, CSS, JavaScript und den Assets, die bereits im WebView des Apps laufen. Es ändert nicht den nativen Binärdatei, native Plugins, Berechtigungen, Zulassungen, Signierung oder Store-Metadaten.
Verwenden Sie für jede native Änderung und für materialisierte Änderungen, die das beauftragte Ziel oder die Funktionalität der App 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.
Gewährleistet Capgo die Zulassung durch den App Store oder Google Play?
Abschnitt mit dem Titel “Gewährleistet 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 den Inhalt, die Offenlegungen, den Updateumfang und die Einhaltung der aktuellen Store-Politik verantwortlich.
Für die Planung von Bewertungen und Veröffentlichungen 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-Arbeiter.
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 zu interagieren, um nach Updates zu suchen. - https://*.r2.cloudflarestorage.com — verwendet von den
npx @capgo/cliBefehlszeilenwerkzeug zum Hochladen und Herunterladen von Bundle
Wenn alle diese URLs in Ihrem Land zugänglich sind, sollte Capgo funktionieren.
Wenn Ihr Land die Zugriffsberechtigung 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.
Benötigt code-Push die Internetverbindung, um zu funktionieren?
Abschnitt mit dem Titel „Benötigt code-Push die Internetverbindung, um zu funktionieren?“Ja. Man könnte sich vorstellen, einen Server zu betreiben, um die Updates separat von der allgemeinen Internetverbindung zu verteilen, 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 App mit Capgo bauen) ist darauf ausgelegt, resistent gegen Netzwerkverbindungsprobleme zu sein.
Bei der Standardaktualisierungsverhalten startet die Anwendung eine Benachrichtigung an den Capgo-Updater, der einen separaten Thread startet, um eine Netzwerk-Anfrage an Capgo’s Server zu senden und nach einer Aktualisierung zu fragen. Wir verwenden absichtlich einen separaten Thread, um sicherzustellen, dass nichts anderes im Anwendungsprozess blockiert wird. Wenn die Netzwerk-Anfrage fehlschlägt oder abläuft, wird der Updater einfach versuchen, wieder zu überprüfen, wenn die Anwendung wieder gestartet wird.
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 Netzwerkverbindung hat.
Welche Auswirkungen hat es, wenn ein Benutzer lange Zeit nicht aktualisiert und eine Aktualisierung verpasst?
Abschnitt mit dem Titel „Welche Auswirkungen hat es, wenn ein Benutzer lange Zeit nicht aktualisiert und eine Aktualisierung verpasst?“Unsere Implementierung sendet immer eine Aktualisierung, die speziell auf das Gerät abgestimmt 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 Benutzeroberflächen-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 über die @capgo/capacitor-updater Durch diesen Paket kann man Updates jederzeit auslösen, einschließlich über eine Push-Nachricht.
Der Capgo-Updater ist so konzipiert, dass er, wenn das Netzwerk nicht verfügbar ist oder der Server nicht erreichbar ist, normal weiterläuft. Sollten Sie jemals eine Aktualisierung von unseren Servern löschen, laufen alle Ihre Clients normal weiter.
Wir haben die Möglichkeit hinzugefügt, Patches rückgängig zu machen. Das Einfachste ist, einfach eine vorherige Bundle an Ihren Kanal anzuhängen, um es rückgängig zu machen.
Muss ich mein app_id geheim halten?
Abschnitt mit dem Titel „Muss ich mein app_id geheim halten?“Nein. Der app_id ist in Ihrer App enthalten und ist sicher, wenn er öffentlich ist. Sie können ihn in Ihre Versionskontrolle einchecken (auch öffentlich) und sich keine Sorgen machen, dass jemand anders darauf zugreifen kann.
Jemand, der Ihren app_id hat, kann die neueste Version Ihrer App von den Capgo-Servern abrufen, aber er kann keine Updates an Ihre App pushen oder auf andere Aspekte Ihres Capgo-Kontos zugreifen.
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 Konzformität.
Setzen statsUrl: '' um explizite Updater-Statistikberichte zu deaktivieren. Sie können auch statsUrl an einen Proxy oder einen von Ihnen verwalteten Endpunkt senden; siehe Statistikverarbeitung in selbst gehosteter Infrastruktur. Die Überprüfungen auf Updates benötigen immer noch eine Gerätescope-Identifikationsnummer, damit Capgo den richtigen Update 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-gesensitiven Daten verwenden?“Ja, aber Ihr Compliance-Besitzer muss die richtige Bereitstellungsstrategie wählen. Capgo Cloud wird derzeit nicht als HIPAA-konformes gehosteter Statistik-Verarbeitungs-System 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 Verkehr von Plugins geolokalisieren, die Statistikfunktion durch Festlegen von statsUrl auf eine leere Zeichenkette deaktivieren, nur die Statistik-Endpunkt selbst hosten oder eine lizenzierte Selbstverwaltung 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 lässt.
Siehe HIPAA-Konformität für die vollständige technische Einrichtung und die Beobachtbarkeits-Abwägungen, 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-Datenverwaltung für Capgo Cloud-Plugin-Verkehr benötigen, können die Updater-Endpunkte auf den EU-Host setzen:
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 den gleichen regionalen Datenpfad 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 für die Produktion bereit.
Die Verwendung von Capgo für iOS, Android oder Electron kann unabhängig voneinander erfolgen. Sie können Ihre Kanalstrategie für Android und eine IPA für den App Store, oder Electron-Kanäle, wie erforderlich, festlegen.
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.
Wie interagiert Capgo mit den Test-Tracks von Google Play oder Apple TestFlight?
Abschnitt mit dem Titel „Wie interagiert Capgo mit den Test-Tracks von Google Play 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 zur Segmentierung Ihrer Benutzer in Gruppen und zur Verteilung spezifischer Versionen Ihrer Apps an jede.
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-Application den Test-Track innerhalb von Google Play erkennen? https://stackoverflow.com/questions/26081543/wie-kann-man-zur-Lauffzeit-erfahren, ob eine iOS-App ü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 also 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 eigenen opt-in-Nutzer, 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 Rollout 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
Sektion mit dem Titel „Rechnung“Wie kann ich mein Abonnement oder meine Tarifstufe ändern?
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. eines Monats angemeldet haben, jeden Monat am 15. 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.
Was wird bei der Speicherung gezählt, und können wir die Aufbewahrung ändern?
Abschnitt mit dem Titel „Was wird bei der Speicherung gezählt, und können wir die Aufbewahrung ändern?“Die Speicherung umfasst die aufbewahrten historischen Pakete und ihre Delta-Assets über alle Kanäle. Sie kontrollieren die Aufbewahrung von nicht verwendeten Paketen für jede App in den App-Einstellungen. Pakete, die mit einem aktiven Kanal oder einer Rollout-Phase verbunden sind, bleiben geschützt, damit sie für die Lieferung und den Rückruf verfügbar bleiben.
Multipliziert regionale Replikation die Speicherung oder die Bandbreite?
Abschnitt mit dem Titel „Wird die regionale Wiederherstellung die Speicherung oder die Bandbreite multiplizieren?“No. A bundle is counted once for storage, regardless of the regions serving it. Capgo bandwidth is based on device downloads that are not served from the edge cache; cache-served deliveries do not count against Capgo bandwidth usage.
__CAPGO_KEEP_0__ Bandbreite basiert auf Geräteherunterladen, die nicht aus dem Edge-Cache geliefert werden; cache-gediente Lieferungen zählen nicht gegen __CAPGO_KEEP_1__ Bandbreitenutzung.
Direkter Link zu Wie umfasst das Enterprise SLA?Abschnitt mit dem Titel „Wie umfasst das Enterprise SLA?“ Das Enterprise umfasst eine monatliche Verfügbarkeitszusage von 99,9 % für die Produktionsplattform. Wenn diese Zusage verfehlt wird, ist das Service-Kredit-Schema 10 % bis 30 % basierend auf der monatlichen Verfügbarkeit. Die ersten Unterstützungsreaktionsziele sind P1: eine Stunde, 24/7/365; P2: zwei Geschäftsstunden; P3: einen Geschäfts-tag; und P4: zwei Geschäfts-tage. Lesen Sie das Enterprise SLA
die vollständigen Bedingungen.
Direkter Link zu Statistiken und AnalysenAbschnitt mit dem Titel „Statistiken und Analysen“ MAUs Während der letzten 30 Tage.
Wie der Geräte-ID generiert wird
Abschnitt mit dem Titel „Wie der 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 von Geräteinstallationen zu vermeiden und es uns zu ermöglichen, auf Basis der von den Nutzern installierten Geräte zu berechnen (z.B. monatlich aktive Nutzer), anstatt auf Basis der Gesamtzahl der Patches oder der Gesamtzahl der Patch-Installationen.
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 Version 7.25.0 wird die Geräte-ID in Keychain gespeichert und bleibt bei normalen Wiederherstellungen bestehen.
- Android: Verwenden Sie Version 7.50.1+ (oder 5.50.1+/6.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 der sicheren Speicherung 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-gespeichert und unterstützt die Live-Update-Lieferung und die MAU-Duplizierungsunterstützung; sie ist kein Werbe- oder Cross-App-Tracking-Identifier.
: Die Geräte-IDs werden nach dem App-Check-in mit Capgo über die Updater- oder Stats-Endpunkte aufgelistet. Ein Gerät muss keine Patches installieren, bevor es in der Geräte-Liste erscheint.
Weshalb ist meine Geräte-Nummer anders als meine MAU?
Abschnitt mit dem Titel “Weshalb ist meine Geräte-Nummer 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, 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 Standortinformationen. 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 Updatezeitpunkt.
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 für jede Plattform haben?
Abschnitt mit dem Titel „Wie kann ich unterschiedliche Updates für jede Plattform haben?“Sie können für jede Plattform einen Kanal erstellen und in jedem Kanal spezifische Updates für die Plattform deaktivieren.
Bei dem iOS-Kanal Updates für Android deaktivieren und bei dem Android-Kanal Updates für iOS deaktivieren.
Uploaden Sie dann ein Bundle für jeden Kanal, um unterschiedliche Updates für jede Plattform zu erhalten.
Wenn Sie Updates 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 das 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.