Übersicht

Das Quickstart-Tutorial führt dich durch die wichtigsten Konzepte von Capgo! Wir werden folgende Themen behandeln:

1. Eine App zu deinem Capgo Account hinzufügen

2. Capgo in deine CI/CD integrieren

3. Bundle-Upload auf Capgo durch Commits auslösen

4. Capgo Bundle-Publishing konfigurieren und anpassen

5. Deine App für Live Updates via Capgo vorbereiten

6. Live Updates via Capgo an deine App deployen

Folge einfach Schritt für Schritt der Anleitung oder spring direkt zur Dokumentation der gewünschten Komponente.

Tutorial starten

Folge dem Quickstart-Tutorial und starte sofort mit Capgo!

CLI Onboarding-Guide

Vollständige Schritt-für-Schritt-Anleitung für das interaktive CLI Onboarding.

Updates deployen

Versende Updates für deine App direkt über das Capgo Dashboard.

Updates automatisieren

Integriere Capgo in deine CI/CD und triggere Bundle-Uploads auf Capgo durch Commits.

Trouble Shooting

Häufige Probleme und deren Lösungen.

Zusammenfassung

Schließe das Tutorial ab und erhalte einen schnellen Überblick über das Gelernte.

Tipp

Die Over-the-Air (OTA) Update-Funktion gilt nur für Änderungen an HTML-, CSS- und JavaScript-Dateien.

Änderst du den nativen code, wie z. B. Capacitor Plugins, musst du die App erneut im App Store zur Prüfung einreichen.

Bundle-Vertraulichkeit

Behandle jedes zu Capgo hochgeladene Bundle als öffentliches Web-Asset, sofern du keine Capgo Verschlüsselung aktivierst. Private Channels steuern zwar, welche Geräte ein Update erhalten dürfen, machen das hochgeladene Bundle aber nicht vertraulich. Die Verschlüsselung schützt den Auslieferungsweg und verhindert, dass Dritte gültige verschlüsselte Updates erstellen. Dennoch können ausgelieferte Web-Assets mit ausreichendem Aufwand aus der App zurückentwickelt werden, da der Public Key in der Binary enthalten ist. Siehe Live Update Verschlüsselung.

Discord Community beitreten

Tritt dem Capgo Discord Server bei!

Pflege

Plugin-Version	Capacitor Kompatibilität	Gewartet
v7.*.* (≥7.25.0)	v7.*.*	✅ Voll unterstützt
v6.*.* (≥6.25.0)	v6.*.*	✅ Voll unterstützt
v5.*.* (≥5.10.0)	v5.*.*	✅ Voll unterstützt
v5.*.* (<5.10.0)	v5.*.*	⚠️ Veraltet
v4.*.*	v4.*.*	❌ Nicht mehr unterstützt
v3.*.*	v3.*.*	❌ Nicht mehr unterstützt
>= 8	v4.*.*	⚠️ Veraltet wegen Versionsproblemen in unserem CI-Prozess

Einhaltung der Store-Guidelines

Google Play für Android und der iOS App Store haben entsprechende Guidelines mit Regeln, die du vor der Integration der Capacitor-Updater-Lösung in deine App kennen solltest.

Google Play

Dritter Absatz von Missbrauch von Geräten und Netzwerken beschreibt, dass das Aktualisieren der code durch andere Methoden als den Update-Mechanismus von Google Play eingeschränkt ist. Diese Einschränkung gilt jedoch nicht für das Aktualisieren von JavaScript-Bundles.

Diese Einschränkung gilt nicht für code, das in einer virtuellen Maschine läuft und nur begrenzten Zugriff auf Android-APIs hat (wie JavaScript in einer WebView oder einem Browser).

Dies erlaubt Capacitor-Updater uneingeschränkt, da nur die JS-Bundles aktualisiert werden und keine nativen code.

App Store

Absatz 3.3.2, seit den Jahren 2015 Apple Developer Program Lizenzvereinbarung erlaubt uneingeschränkt Over-the-Air-Updates von JavaScript und Assets – und in der neuesten Version (20170605) hier herunterladbar Diese Regelung ist sogar noch umfassender:

Ausgelegt bedeutet, dass code auf eine App heruntergeladen werden darf, solange dieses code: (a) nicht den Hauptzweck der App verändert, indem Funktionen bereitgestellt werden, die nicht dem ursprünglichen und beworbenen Zweck der im App Store eingereichten App entsprechen, (b) keinen Store oder Marktplatz für andere code oder Apps erstellt und (c) das Signing, die Sandbox oder andere Sicherheitsfunktionen des Betriebssystems nicht umgeht.

Mit dem Capacitor Updater halten Sie diese Regeln vollständig ein, solange das gepushte Update Ihr Produkt nicht signifikant von der ursprünglich im App Store genehmigten Absicht abweichen lässt.

Um die Apple-Guidelines weiterhin einzuhalten, empfehlen wir, dass im App Store verteilte Apps die Force update Szenario, da in der App Store Review Guidelines festgelegt wird:

Apps dürfen Nutzer nicht dazu zwingen, die App zu bewerten, Rezensionen zu schreiben, andere Apps herunterzuladen oder ähnliche Aktionen durchzuführen, um auf Funktionen, Inhalte oder die Nutzung der App zuzugreifen.

Das ist beim Standardverhalten von Background Updates kein Problem, da der Nutzer die neue Version nicht gezwungen wird zu installieren, bis er die App das nächste Mal schließt. Dennoch sollten Sie diese Rolle kennen, falls Sie sie anzeigen möchten.

Open Source

Das Plugin steht unter der LGPL-3.0 Lizenz und das Back-end unter der AGPL-3.0 Lizenz.

💡 LGPL-3.0 bedeutet: Wenn jemand den code des Plugins modifiziert, muss dieser unter derselben Lizenz als Open Source veröffentlicht werden. Wenn du den code ohne Änderungen nutzt, betrifft dich das nicht. Details dazu findest du im untenstehenden Link 👇

Lizenzierung?

Nutze GPTS Capgo für Hilfe, statt die Docs zu lesen

Du kannst es bedenkenlos in deine App einbinden

Final Notes

Wenn du das Tool selbst hostest und es dir hilft, unterstütze meine Arbeit gerne als GitHub Sponsor.

Ich habe mich dazu entschieden, alle hier entwickelten code als Open Source bereitzustellen, statt sie hinter einer Paywall zu verstecken. Ich glaube, dass wir die Welt zu einem besseren Ort machen, indem wir Dinge teilen, statt sie zu bekämpfen oder zu verbergen.

Damit das möglich ist, müssen wir alle unseren Teil beitragen, auch du 🥹. Wenn die Capgo Cloud nicht deinen Anforderungen entspricht, kannst du einen Bootstrapped Maker auf GitHub Sponsors unterstützen ganz nach deinen Vorstellungen.

Einfache Mathematik

Preis des Basic-Plans: 14 $*12 = 168 $ pro Jahr. Bei einem durchschnittlichen Dev-Stundensatz von 60 $. Das bedeutet: 3 Stunden verschwendete Dev-Zeit durch Self-Hosting decken die Kosten für ein ganzes Jahr ab. Wenn du mehr als 3 Stunden investierst, machst du Verlust ^^

Weiter geht's ab der Übersicht

Wenn du es nutzt Übersicht um CI/CD-Automatisierung zu planen, verbinde es mit Capgo CI/CD für den Produkt-Workflow in Capgo CI/CD, Capgo Native Builds für den Produkt-Workflow in Capgo Native Builds, Capgo Integrationen für den Produkt-Workflow in Capgo Integrations, CI/CD-Integration für die Implementierungsdetails in der CI/CD-Integration und GitHub Actions-Integration für die Implementierungsdetails in der GitHub Actions-Integration.