Panoramica

Il tutorial quickstart ti guiderà attraverso i concetti chiave di Capgo! Vedremo in dettaglio:

1. Come aggiungere un'app al tuo account Capgo

2. Integrare Capgo con la tua CI/CD

3. Triggerare l'upload del bundle su Capgo con i commit

4. Configurare e personalizzare il publishing del bundle Capgo

5. Configurare l'app per abilitare i live updates tramite Capgo

6. Deployare i live updates sulla tua app da Capgo

Segui la guida passo dopo passo, oppure vai direttamente alla documentazione del componente che ti interessa.

Inizia il Tutorial

Segui il tutorial quickstart e metti in funzione Capgo in un attimo!

Guida all'onboarding di CLI

Guida completa passo dopo passo per l'onboarding interattivo di CLI.

Pubblica gli update

Invia gli update alla tua app dal dashboard di Capgo.

Automatizza gli update

Integra Capgo con la tua CI/CD e avvia l'upload dei bundle su Capgo tramite push di commit.

Troubleshooting

Problemi comuni e come risolverli.

Conclusione

Concludi il tutorial con una panoramica rapida di quanto appreso.

Tip

La funzione di aggiornamento Over-the-Air (OTA) si applica solo alle modifiche ai file HTML, CSS e JavaScript.

Se apporti modifiche al code nativo, ad esempio aggiornamenti ai plugin Capacitor, è obbligatorio inviare di nuovo l'app agli store per l'approvazione.

Riservatezza dei Bundle

Considera ogni bundle caricato su Capgo come un asset web pubblico, a meno che non attivi la crittografia Capgo. I canali privati controllano quali dispositivi sono idonei a ricevere un aggiornamento, ma non rendono il bundle caricato riservato. La crittografia protegge il percorso di distribuzione ed evita che terze parti possano generare aggiornamenti criptati validi, ma gli asset web distribuiti possono comunque essere sottoposti a reverse engineering dall'app con sufficiente impegno, poiché la chiave pubblica è inclusa nel binario. Vedi Sezione crittografia Live Update.

Unisciti alla community su Discord

Unisciti al server Discord di Capgo!

Manutenzione

Versione del plugin	Compatibilità Capacitor	Manutenuto
v7.*.* (≥7.25.0)	v7.*.*	✅ Supporto completo
v6.*.* (≥6.25.0)	v6.*.*	✅ Supporto completo
v5.*.* (≥5.10.0)	v5.*.*	✅ Supporto completo
v5.*.* (<5.10.0)	v5.*.*	⚠️ Deprecato
v4.*.*	v4.*.*	❌ Non più supportato
v3.*.*	v3.*.*	❌ Non più supportato
>= 8	v4.*.*	⚠️ Deprecato per problemi di versionamento nel nostro processo CI

Conformità alle linee guida degli store

Android Google Play e iOS App Store hanno linee guida specifiche con regole che dovresti conoscere prima di integrare la soluzione Capacitor-updater nella tua applicazione.

Google Play

Terzo paragrafo di Abuso di Dispositivi e Rete l'argomento descrive che l'aggiornamento della sorgente code tramite qualsiasi metodo diverso dal meccanismo di aggiornamento di Google Play è limitato. Tuttavia, questa restrizione non si applica all'aggiornamento dei bundle JavaScript.

Questa restrizione non si applica a code che gira in una macchina virtuale e ha un accesso limitato alle API Android (come JavaScript in una webview o in un browser).

Ciò consente pienamente Capacitor-updater, poiché aggiorna solo i bundle JS e non aggiornerà il codice nativo code.

App Store

Paragrafo 3.3.2, since back in 2015’s Contratto di licenza Apple Developer Program consente pienamente di eseguire aggiornamenti over-the-air di JavaScript e asset - e nella sua versione più recente (20170605) scaricabile qui questa decisione è ancora più ampia:

Il code interpretato può essere scaricato in un'Applicazione, ma solo se tale code: (a) non modifica lo scopo principale dell'Applicazione fornendo funzionalità o caratteristiche incoerenti con lo scopo previsto e pubblicizzato dell'Applicazione così come inviata all'App Store, (b) non crea uno store o una vetrina per altri code o applicazioni, e (c) non aggira la firma, il sandbox o altre funzionalità di sicurezza del sistema operativo.

Capacitor Updater ti permette di rispettare queste regole in piena conformità, purché l'aggiornamento che invii non allontani significativamente il tuo prodotto dallo scopo originale approvato dall'App Store.

Per restare ulteriormente conformi alle linee guida di Apple, suggeriamo che le app distribuite tramite App Store non abilitino lo Force update scenario, dato che nelle Linee guida per la revisione dell'App Store dichiara che:

Le app non devono costringere gli utenti a valutare l'app, recensirla, scaricare altre app o compiere azioni simili per accedere a funzionalità, contenuti o all'uso dell'app stessa.

Questo non è un problema per il comportamento predefinito dell'aggiornamento in background, poiché non costringerà l'utente ad applicare la nuova versione fino alla prossima chiusura dell'app; ma quantomeno dovresti essere consapevole di quel ruolo se decidi di mostrarlo.

Open source

Il plugin è sotto licenza LGPL-3.0 e il back-end è sotto licenza AGPL-3.0.

💡 La licenza LGPL-3.0 prevede che se qualcuno modifica il code del plugin, sia obbligatorio pubblicarlo in open source con la stessa licenza. Se usi il code senza modifiche, non ti riguarda. Per maggiori dettagli, consulta l'issue al link qui sotto 👇

Licenza?

Prova GPTS Capgo per ottenere aiuto invece di leggere la documentazione

Puoi includerlo nella tua app senza preoccuparti

Note finali

Se fai self-hosting e trovi utile questo strumento, considera di supportare il mio lavoro diventando uno sponsor GitHub.

Ho deciso di rendere open-source tutti i code che ho costruito qui invece di metterli dietro un paywall. Credo che aprendo il codice, invece di combattere e nasconderlo, possiamo rendere il mondo un posto migliore.

Per rendere possibile tutto questo, è necessario che ognuno di noi faccia la sua parte, incluso te 🥹. Se il cloud di Capgo non soddisfa le tue esigenze, puoi sostenere un maker indipendente su GitHub Sponsors alle tue condizioni.

Matematica Semplice

Il prezzo del piano basic: $14*12 = $168 all'anno. Mentre la tariffa media dev/ora = $60. Significa che 3 ore di dev time perse con l'auto-hosting coprono l'intero anno; se ne perdi più di 3, stai perdendo soldi ^^

Continua dalla Panoramica

Se stai usando Panoramica per pianificare l'automazione CI/CD, connettilo a CI/CD di Capgo per il workflow di prodotto in Capgo CI/CD, Capgo Native Build per il workflow di prodotto in Capgo Native Builds, Integrazioni Capgo per il workflow di prodotto in Capgo Integrazioni, Integrazione CI/CD per i dettagli implementativi dell'integrazione CI/CD, e Integrazione GitHub Actions per i dettagli implementativi dell'integrazione con GitHub Actions.