FAQ
Eine Setup-Vorlage mit den Installationsanweisungen und der vollständigen Markdown-Guideline für diesen Plugin kopieren.
Wenn Sie hier nicht beantwortete Fragen haben, bitten wir Sie, eine Anfrage zu stellen! Beide das Einreichen eines Issues oder das Anfragen auf Discord Arbeitszeit.
Was ist „code push“?
Abschnitt mit dem Titel „Was ist „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?
Abschnitt mit dem Titel „Müssen Capgo CLI-Majoren mit meiner Plugin- oder Capacitor-Version übereinstimmen?“Nein. Verwenden Sie immer die neueste Capgo CLI (npx @capgo/cli@latest). Die 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-Versionsmanagement für LTS-Tags wie @lts-v7.
What 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 zu generieren, 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. 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 geschickt wird.
Gibt es Einschränkungen für die Pfad-Dateien von Delta-Updates?
Abschnitt mit dem Titel “Gibt es Einschränkungen für die Pfad-Dateien von Delta-Updates?”Ja:
- Leerbyte-Dateien: Die CLI-Protokolle
Ignoring empty file...und schließt leere Dateien aus dem Delta-Manifest aus. Es schlägt nicht fehl, wenn Sie eine leere Datei hochladen, sodass eine leere Datei den resultierenden Bundle ohne Unterbrechung ändern kann. Fügen Sie keine Dateien mit Null-Byte in Delta-Bundle-Pfade ein. - Mit Leerzeichen versehene Pfade: Delta-Uploads scheitern frühzeitig mit einem klaren Fehler, wenn ein Bundle-Pfad Leerzeichen enthält. Benennen Sie Dateien oder Verzeichnisse um, um Leerzeichen zu entfernen, bevor Sie eine Delta-Update hochladen.
Siehe Delta-Updates Details zur Einrichtung finden Sie unter:
Wie ist die Roadmap?
Unsere Projektboards sind auch öffentlich und finden Sie sie unter:https://__CAPGO_KEEP_0__.com/orgs/Cap-go/projects Unsere Team arbeitet auch öffentlich, sodass Sie sehen können, was wir gerade bearbeiten. Wir freuen uns darauf, Ihre Fragen zu unserer Roadmap oder Prioritäten über github-Issues oder zu beantworten.
Unsere Projektboards sind auch öffentlich und finden Sie sie unter: Github.com/orgs/Cap-go/projects 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 Anwendungsmetriken (MAU, Speicher und Bandbreite) auf jede Organisation.
Weiterlesen Teams Weitere Informationen finden Sie unter Teams.
Speichert Capgo meine Quellcode code?
Abschnitt mit dem Titel „Speichert Capgo meine Quellcode code?“Nein. Capgo-Server sehen nie deine Quellcode code. Wenn du npx @capgo/cli@latest bundle uploadCapgo speichert eine Zip-Datei des minifizierten/verkompilierten code - das gleiche code wie ein Browser, nicht Ihre Quellcode code.
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 dritten Parteien die Erstellung von gültig verschlüsselten Updates ohne Ihre private Schlüssel zu verhindern. Dies macht die in der verteilten Anwendung befindliche öffentliche Schlüssel jedoch nicht verhindern, dass die in der Anwendung enthaltenen Web-Assets rückgängig gemacht werden können.
- Außereinander-Upload: 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 „Sollen Bundle-Dateien private Daten sein?“Nein. Bundle-Dateien sind öffentliche Web-Assets, die von Ihren Anwendern 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.
Zugriff auf Bundle-Dateien gilt nicht als Datenverlust. Fügen Sie keine Geheimnisse, Anmeldeinformationen, persönliche Daten oder regulierte Daten in Ihr App-Bundle ein. Wenn Sie eine stärkere Vertraulichkeit für hochsichere Anwendungsfälle benötigen, verwenden Sie end-to-end-Verschlüsselung, behandeln Sie jedoch das verschickte App-code und die Assets aus Sicherheitsberichtsperspektive als öffentlich.
Kann ich Capgo aus meinem CI-System verwenden?
Abschnitt mit dem Titel „Kann ich Capgo aus meinem CI-System verwenden?“Ja. Capgo ist für die Verwendung aus CI-Systemen vorgesehen. Wir haben eine Anleitung für Android und Github-Actions und iOS, und für GitLab. Andere CI-Systeme sollten ähnlich sein.
Bitte zögern Sie nicht, sich bei GitHub-Problemen oder Discord bei Problemen zu melden.
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 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?“Ich habe mich nicht kürzlich gemessen, aber ich erwarte, dass die code push-Bibliothek weniger als einen Megabyte an Capacitor-Apps hinzufügt. Wir wissen, wie wir dies kleiner machen können, wenn dies ein Prioritätsfall wird. Wenn Größe ein Blockierer für Sie ist, lassen Sie es uns bitte wissen!
Funktioniert Capgo auf dem iOS 18.4 Simulator?
Abschnitt mit dem Titel „Funktioniert Capgo auf dem iOS 18.4 Simulator?“Nein. Aufgrund eines aufwärts gerichteten Problems, das den iOS 18.4 Simulator betrifft, funktioniert Capgo dort nicht zuverlässig. Testen Sie bitte 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 oben angegeben, Capgo kann jede JS code in Ihrer Anwendung ändern, unabhängig von der Größe.
Zu beachten: Eine größere Größe macht es schwieriger für Benutzer, Updates herunterzuladen. Wir empfehlen, Ihre App so klein wie möglich zu halten.
Was kann ich mit Capgo code push machen?
Abschnitt mit dem Titel „Was kann ich mit Capgo code push machen?“We haben eine Vielzahl von Anwendungen gesehen, einschließlich:
- Dringende Reparaturen für Produktionsanwendungen.
- Versand von Bug-Fixes an Benutzer auf älteren Versionen Ihrer App.
- Ständiger Versand (z.B. alle Stunden).
Hinweis: Die meisten App-Stores verbieten den Versand von code, der das Verhalten der App in einem wesentlichen Umfang ändert. Bitte sehen Sie unten mehr Informationen.
Welche Anzahl an "MAU"-Geräten zählt für Capgo?
Abschnitt mit dem Titel "Welche Anzahl an "MAU"-Geräten zählt für Capgo?"Ein MAU ist ein monatlich aktives Gerät. Ein einzelnes Gerät, das Capgo innerhalb eines 30-Tage-Rolling-Intervalls kontaktiert, wird als ein MAU für diese native App-ID gezählt. Ein physisches Gerät, das mit zwei unterschiedlichen native App-IDs verwendet wird, wird einmal für jede App-ID gezählt; es wird nicht über sie hinweg dedupliziert.
Wenn Ihre Geschmacksrichtungen sich nur in ihrer Web-Schicht oder der Update-Routing unterscheiden, verwenden Sie eine native App-ID mit Kanäle. Das hält die Aromen unter einer einzigen Capgo-Anwendung und macht Releases einfacher. Verwenden Sie separate native App-IDs, wenn eine Aromavariante eine unterschiedliche Bundle-ID, Signaturidentität, Berechtigungssatz oder Store-Liste benötigt.
Auf iOS v7.25.0+ hält die zufällige, app-geskoppelte Geräte-ID bei normalen Wiederinstallierungen mithilfe von Keychain. Auf Android verwenden Sie v7.50.1+ (oder v5.50.1+ und v6.50.1+ auf diesen Release-Linien); die ID wird nur dann wiederhergestellt, wenn Android Backup/Restore die App-Einstellungen aufbewahrt. Deaktivieren Sie die Sicherung, ausschließen Sie diese Einstellungen oder löschen Sie die App-Daten, um eine neue Geräte-ID zu generieren. 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 trotzdem anmelden, wenn es Capgo kontaktiert. Um es aus der Produktionsnutzung auszuschließen, deaktivieren Sie Live-Updates und rufen Sie keine Produktions-Capgo-Endpunkte auf. Siehe Test Native Builds Ohne Live Updates für 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 wie Java, Kotlin, Objective-C, Swift, native Plugins oder native Konfiguration ändern. Diese Änderungen erfordern eine neue native App-Veröffentlichung. Für den Store-Review-Umfang 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?“Nein. Kurze Regel: Capgo kann den generierten Web-Build-Ordner, einschließlich HTML, CSS, JavaScript, Assets und reinen-JavaScript-Paket-Änderungen, die in diesem Output gebündelt sind, senden. Änderungen an capacitor.config.tsnative Plugin-Konfiguration, native Paket-Installationen oder -Upgrades und alles, was die iOS- oder Android-Projekt-Update erfordert npx cap sync oder npx cap copy eine native App-Veröffentlichung erfordert.
Die Capacitor-Konfigurationsdatei wird bei der native Build-Zeit gelesen und in die native App-Binärdatei kompiliert. Wenn Sie Ihre Capacitor-Konfiguration ändern müssen, müssen Sie:
- aktualisieren
capacitor.config.tslokal - Erneuern Sie Ihre native App (
npx cap syncgefolgt von einer native Build - Die neue Binärdatei bei den App-Stores einreichen
Submitiert Capgo die App-Stores für mich?
Abschnitt mit dem Titel “Submitiert Capgo die App-Stores für mich?”Capgo Build kann eine vorbereitete native iOS- oder Android-Projekt kompilieren und signieren und, wenn konfiguriert, die signierte Ergebnisse 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 das vorbereitete native Projekt für den native Build-Schritt.
Siehe Capgo Build und die Referenz zur Build-Konfiguration für die Workflow- und Store-Submission-Optionen.
Was speichert Capgo auf der Festplatte und wo?
Abschnitt mit dem Titel „Was speichert Capgo auf der Festplatte und wo?“Der Capgo-Updater (in Ihrem Anwendungsprojekt enthalten, wenn Sie Ihr App bauen) cachet die neuesten heruntergeladenen Bundle in der einzigen Verzeichnis, die capacitor erlauben, 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 bei Laufzeit ändern kann. Auf iOS-Geräten werden Daten unter Library/Application Support/capgo.
Der Capgo-Befehlszeilen-Tool (z.B. npx @capgo/cli@latest bundle upload) auf der Festplatte installiert werden in npm-Caches, Ihre Anmeldeinformationen 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 Ihnen ermöglicht, code auf dem Gerät während der Entwicklung zu ändern. Es erfordert das Bauen der Capacitor-Anwendung mit einem Proxy, um eine Verbindung zur lokalen Maschine herzustellen.
Code push ist eine Funktion, die es Ihnen ermöglicht, code auf dem Gerät in der Produktion 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 keine native code-Änderungen erfordern.
Wir haben keine Pläne, native code-Änderungen (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-Änderungen vorgenommen haben, da sie nicht in der Pakete enthalten sind.
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-App öffnet, lädt es 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!
Funktioniert dies auf iOS, Android, Mac, Windows, Linux usw.?
Abschnitt mit dem Titel „Funktioniert dies auf iOS, Android, Mac, Windows, Linux usw.?“Ja.
Bisher haben wir uns auf Android, iOS und Electron-Unterstützung konzentriert und code push ist auf allen drei in der Produktion bereit.
Welche Betriebssystemversionen unterstützt Capgo?
Was unterstützen Capgo?Capgo unterstützt die gleichen Android-Versionen 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?
Section titled “What versions of Capacitor does Capgo support?”Capgo unterstützt derzeit nur die neuesten stabilen Versionen von Capacitor. Wir könnten auch ältere Versionen von Capacitor unterstützen, wir haben es nur noch nicht gebaut, um solche Versionen im Laufe der Zeit zu erhalten. Wir beabsichtigen, in Zukunft mehr Versionen von Capacitor zu unterstützen, einschließlich jeder Version für unsere Unternehmenskunden. 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 ein paar Minuten. Wir führen dann einen zusätzlichen manuellen Überprüfungs-Schritt durch, bevor wir es auf unsere Server veröffentlichen.
Wie verhält es sich in Bezug auf das App/Play Store-Bewertungsverfahren oder -Richtlinien?
Abschnitt mit dem Titel „Wie verhält sich dies zum App/Play Store-Bewertungsprozess oder -richtlinien?“Capgo sendet Änderungen nur an 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 Materialä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 im App Store oder Google Play?
Abschnitt mit dem Titel „Garantiert Capgo die Zulassung im App Store oder Google Play?“Nein. Apple und Google prüfen jedes App-Release auf eigenen Fakten und Capgo kann keine individuelle Zulassung oder Bewertungsergebnis garantieren. Ihr Team bleibt für den Inhalt, die Offenlegungen, den Update-Umfang und die Einhaltung der aktuellen Store-Richtlinien verantwortlich.
Für die Bewertung und Planung der Veröffentlichung lesen Sie die offiziellen Richtlinien direkt: Apple App Store-Bewertungshinweise und Google Play-Geräte- und Netzwerkmissbrauchsrichtlinie.
Kann ich Capgo in meinem Land verwenden?
Abschnitt mit dem Titel “Can I use Capgo in meinem Land?”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 — wird von den
npx @capgo/cliBefehlszeilen-Tools verwendet, um mit den Capgo-Servern sowie dem Capgo-Updater auf den Geräten der Benutzer zu interagieren, um nach Updates zu suchen. - https://*.r2.cloudflarestorage.com — wird von dem
npx @capgo/cliBefehlszeilen-Tool verwendet, um Bundle hoch- und herunterzuladen.
Wenn alle dieser URLs in Ihrem Land zugänglich sind, dann sollte Capgo funktionieren.
If Ihr Gebiet eine Zugriffsblockierung auf eine dieser URLs erfordert, teilen Sie es uns bitte mit und wir können gemeinsam eine Lösung finden. Proxy-Server sind eine Option.
Kann ich Capgo selbst hosten?
Abschnitt: '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: 'Braucht 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 die Updates an die Geräte zu transportieren.
Wie wird Capgo durch den Mangel an Netzwerkverbindung beeinflusst?
Abschnitt mit dem Titel „Wie wird Capgo durch das Fehlen von Netzwerkverbindung beeinflusst?“Der Capgo-Updater (in Ihrem Anwendungsprojekt enthalten, wenn Sie Ihr Anwendungsprojekt mit Capgo erstellen) ist auf Netzwerkverbindungsprobleme vorbereitet.
Bei der Standardaktualisierungsverhalten wird beim Start der Anwendung die Capgo-Aktualisierung benachrichtigt, die einen separaten Thread startet, um eine Netzwerkverbindung zu Capgo’s Servern herzustellen und nach einer Aktualisierung zu fragen. Wir verwenden absichtlich einen separaten Thread, um sicherzustellen, dass die Aktualisierung keine anderen Aktionen der Anwendung blockiert. Wenn die Netzwerkverbindung fehlschlägt oder abläuft, wird der Aktualisierer einfach wieder versuchen, die Aktualisierung zu überprüfen, wenn die Anwendung wieder 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 Netzwerkverbindung hat.
Was passiert, wenn ein Benutzer lange Zeit nicht aktualisiert und eine Aktualisierung verpasst?
Abschnitt mit dem Titel „Was passiert, wenn ein Benutzer lange Zeit nicht aktualisiert und eine Aktualisierung verpasst?“Unsere Implementierung sendet immer eine Aktualisierung, die speziell auf das Gerät zugeschnitten ist, das aktualisiert werden soll, und aktualisiert den Anforderer immer auf die neueste verfügbare Version. Daher verpasst ein Benutzer, der lange Zeit nicht aktualisiert, „intermediate Updates“.
The Update-Server könnte so konfiguriert werden, dass es entweder die nächste inkrementelle Version oder die aktuellste Version zurückgibt, je nachdem, was Ihre Anwendung benötigt. Lassen Sie uns wissen, ob alternative Update-Verhaltensweisen für Sie wichtig sind.
Wie steht es mit Capgo zu Capacitor?
Abschnitt mit dem Titel „Wie steht es mit Capgo zu Capacitor?“Capgo ist ein Plugin für Capacitor, das code-Push hinzufügt. Capgo ist keine 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 Updates?
Abschnitt mit dem Titel „Wann passieren Updates?“Standardmäßig überprüft der Capgo-Updater bei der App-Startzeit nach Updates. Es läuft im Hintergrund und blockiert nicht den UI-Thread. Alle Updates werden während der Benutzung der App installiert und werden bei der nächsten App-Neustart angewendet.
Es ist auch möglich, den Capgo-Updater manuell über den @capgo/capacitor-updater Package auszuführen, über den Updates jederzeit ausgelöst werden können, 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, das App normal weiterlaufen lässt. Sollten Sie jemals eine Aktualisierung von unseren Servern löschen, werden alle Ihre Clients normal weiterlaufen.
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 die Versionskontrolle einchecken (auch öffentlich) und sich keine Sorgen machen, dass jemand else darauf zugreifen kann.
Wenn jemand Ihr app_id besitzt, kann er die neueste Version Ihrer App von den Capgo Servern abrufen, aber er kann keine Updates an Ihre App pushen oder auf einen anderen Aspekt Ihres Capgo Kontos zugreifen.
Was wird an Capgo Servern gesendet?
Abschnitt mit dem Titel “Was wird an Capgo Servern gesendet?”The complete data inventory, endpoint behavior, und Datenschutzkontrollen sind in der Dokumentation dokumentiert. 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. Update-Überprüfungen benötigen immer noch eine App-basierte Geräte-ID, damit Capgo die richtige Aktualisierung auswählen und monatlich aktive Geräte messen kann.
Die Liste der Subverarbeiter ist unsere aktuelle öffentliche Quelle der Wahrheit für Anbieter, Verarbeitungsorte, Übertragungsmechanismen und Änderungsgeschichte.
Kann ich Capgo für Apps mit HIPAA-Sensitivität verwenden?
Kann ich Capgo für Apps mit HIPAA-gesensitiven Daten verwenden?Ja, aber Ihr Compliance-Besitzer muss die richtige Bereitstellungsmodelle wählen. Capgo Cloud wird derzeit nicht als HIPAA-konformes gehosteter Statistik-Verarbeitungsmodell vorgestellt. Standardmäßig ist die Updater-Daten auf Geräteebene skaliert und nicht an einen bekannten App-Benutzer gebunden, und viele Teams verwenden dieses Modell erfolgreich.
Für strengere Überprüfungen können Sie die Plugin-Verkehr geo-lokalisieren, die Statistik durch Festlegen von statsUrl auf eine leere Zeichenkette setzen, nur die Statistik-Endpunkt selbst hosten oder lizenzierte Selbst-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 lässt.
Siehe HIPAA-Konformität für die vollständige technische Einrichtung und die Beobachtbarkeitstradeoffs, wenn die Statistik deaktiviert ist.
Kann ich Capgo-Live-Update-Daten in Europa behalten?
Abschnitt mit dem Titel “Kann ich Capgo-Live-Update-Daten in Europa behalten?”Ja. Apps, die für Capgo-Cloud-Plugin-Verkehr eine EU-Datenresidenz benötigen, können die Updater-Endpunkte auf den EU-Host festlegen:
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, sodass Aktualisierungsprüfungen, Statistiken und die Selbstzuweisung von Kanälen denselben regionalen Datenpfad verwenden. capacitor.config.tsDa diese Werte in
, Produktions-Apps für Mobilgeräte eine native Veröffentlichung benötigen, bevor bestehende Installationen die neuen Endpunkte verwenden. Siehe for exact Capacitor and Electron examples.
für genaue Capgo und Electron-Beispiele.
Direkter Link zu 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ängige Entscheidungen sein. Sie können Ihre Kanalstrategie für Android und eine IPA, die auf den App Store gebaut ist, oder Electron-Kanäle, wie erforderlich, einrichten.
Capgo kann (relativ leicht) für Desktop- oder eingebettete Ziele umgestellt werden. Wenn diese für Sie wichtig sind, teilen Sie es uns bitte mit.
Sektion mit dem Titel “How does Capgo interagiert mit Play Testing Tracks oder Apple TestFlight?”Jeder der App Stores hat eigene Mechanismen für die Verteilung von Apps an begrenzten Gruppen von Benutzern (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 diese Mechanismen nicht alle, dass Drittanbieter erkennen können, wenn Apps in einer 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-Anwendungsidentifizieren-den-Test-Track-in-Google-Play https://stackoverflow.com/questions/26081543/wie-kann-man-am-Laufen-Zeit-ermitteln-ob-eine-iOS-Anwendung-durch-eine-Testflight-Beta-laufft
Wenn Sie die Verfügbarkeit des Capgo-Pakets segmentieren möchten, gibt es 4 mögliche Optionen:
- Eine separate Kanal für jede Gruppe verwenden. Dies ist der direkteste Ansatz, aber er erfordert, dass Sie mehrere Kanäle verwalten. Sie haben möglicherweise bereits eine Dev-Kanal und einen Prod-Kanal mit unterschiedlicher Verfügbarkeit. Sie können also Ihre Dev-Kanal aktualisieren, überprüfen und dann separat Ihren Prod-Kanal aktualisieren. Wir empfehlen die Verwendung von Branches / Tags in Ihrer Versionskontrolle, um Ihnen dabei zu helfen, die Quellen zu verfolgen, die mit jedem Release 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-updater-Paket aus. Dies funktioniert heute, aber erfordert, dass Sie Ihre eigene Liste von opt-in-Nutzern verwalten. - Capgo ermöglicht es Ihnen, Ihre eigene opt-in-Mechanismik auf Geräteebene zu erstellen (ähnlich wie Test Tracks oder TestFlight, nur plattformübergreifend). Dies ermöglicht es Ihrem QA-Team, sich auf eine neue Version vorzubereiten, bevor sie der breiten Öffentlichkeit zugänglich gemacht werden.
- Verwenden Sie progressive Rollouts um ein Kandidatenpaket an einem zufälligen, festen Teil einer Kanalgruppe zu liefern. Legen Sie einen Rollout von 0–100% fest oder verwenden Sie
--rollout-percentage-bpsfür 0,01%-Schritte; 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.
Wie stelle ich mein Abonnement auf ein höheres oder niedrigeres Niveau um?
Abschnitt mit dem Titel ‘Wie kann ich mein Tarif auf- oder herabstufen?’Sie können Ihren Tarif jederzeit in Ihrem Dashboard auf- oder herabstufen: https://console.capgo.app/settings/organization/plans
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, wenn Sie sich erstmals auf 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/settings/organization/plans
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 berücksichtigt und können wir die Aufbewahrungsfrist ändern?
Abschnitt mit dem Titel „Was wird bei der Speicherung berücksichtigt und können wir die Aufbewahrungsfrist ändern?“Die Speicherung umfasst die aufbewahrten historischen Bundles und ihre Delta-Assets über alle Kanäle. Sie kontrollieren die Aufbewahrungsfrist für nicht genutzte Bundles für jede App in den App-Einstellungen. Bundles, die mit einem aktiven Kanal oder Rollout verknüpft sind, bleiben geschützt, damit sie für die Lieferung und das Zurücksetzen verfügbar bleiben.
Multipliziert regionale Replikation die Speicherung oder die Bandbreite?
Abschnitt mit dem Titel „Multipliziert regionale Replikation die Speicherung oder die Bandbreite?“No. Ein Bundle wird einmal für den Speicher gezählt, unabhängig von den Regionen, die es bereitstellen. Capgo Bandbreite basiert auf Geräteherunterladungen, die nicht aus dem Edge-Cache bereitgestellt werden; Cache-bereitgestellte Lieferungen zählen nicht gegen Capgo Bandbreitenverbrauch.
Wie lautet der Enterprise SLA?
Abschnitt mit dem Titel „Wie lautet der 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 monatlicher 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 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 midnight UTC aktualisiert. Die Statistiken werden aus __CAPGO_KEEP_0__ berechnet. MAUs aktiv während der 30-Tage-Frist.
Wie wird die Geräte-ID generiert?
Abschnitt mit dem Titel „Wie wird die Geräte-ID generiert?“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 Benutzern installierten Geräte zu berechnen (z.B. monatlich aktive Benutzer), anstatt auf Basis der Gesamtzahl der Patches oder der Gesamtzahl der Patch-Installationen.
MAU ist eine bessere Lösung als die Anzahl der Installationen zur Preisfestsetzung von Capgo, da sie genauer und den tatsächlichen Kosten von Capgo pro Gerät entspricht.
Geräte-ID-Persistenz:
- iOSAb v7.25.0+ wird die Geräte-ID in Keychain gespeichert und bleibt bei normalen Wiederherstellungen bestehen.
- AndroidVerwenden Sie ab 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.
- ElektronDie Geräte-ID wird in einem sicheren Speicher gespeichert.
- Android-Hinweis: Die Sicherung deaktivieren, die relevanten Einstellungen ausschließen oder die App-Daten löschen, 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 die Sicherung aktiviert ist.
Die Geräte-ID ist app-basiert und unterstützt Live-Update-Delivery und MAU-De-Duplikation; sie ist kein Werbe- oder Cross-App-Tracking-Identifier.
Geräte-IDs werden nach dem App-Check-in mit Capgo über den Updater oder die Statistik-Endpunkte aufgelistet. Ein Gerät muss nicht vorher ein Patch installieren, bevor es in der Geräte-Liste erscheint.
Warum ist meine Geräte-Nummer anders als meine MAU?
Abschnitt mit dem Titel “Warum 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 an, wie z.B. die Geräte-ID, die Plattform, die Plugin-Version, die OS-Version, die native Version, den Kanal, den installierten Bundle und den Anfrage-Landkreis, wenn verfügbar. Der Anfrage-Landkreis ist der neueste gültige zwei-Buchstaben-code , der von einem Cloudflare-bearbeiteten Anfrage für das Gerät erhalten wurde, nicht GPS oder app-basierte Standortinformationen. Anfragen ohne einen gültigen Landkreis löschen nicht die letzte gültige Werte. Capgo aktualisiert diese Metadaten, wenn die App sich anmeldet, aber wiederholte Anmeldungen, die die gleichen Metadaten melden, ändern möglicherweise nicht die Zeile oder ihren letzten Aktualisierungszeitpunkt.
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 pro Plattform haben?
Abschnitt mit dem Titel „Wie kann ich unterschiedliche Updates pro Plattform haben?“Sie können für jede Plattform einen Kanal erstellen und in jedem Kanal plattformspezifische Updates deaktivieren.
Auf dem iOS-Kanal iOS-Updates deaktivieren und auf dem Android-Kanal Android-Updates deaktivieren.
Dann laden Sie ein Bundle in jeden Kanal hoch, um unterschiedliche Updates für jede Plattform zu erhalten.
Wenn Sie das gleiche Update für beide Plattformen benötigen, können Sie ein Bundle auf mehrere Kanäle verlinken. Es ist nicht notwendig, das Bundle zu duplizieren.
Weitergehen von FAQ
Abschnitt mit dem Titel „Weitergehen von FAQ“Wenn Sie FAQ um Live-Update-Lieferungen 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.