Panoramica

Il tutorial di avvio rapido ti guiderà attraverso i concetti chiave di Capgo! I concetti che esploreremo includono:

1. Aggiunta di un'app al tuo account Capgo

2. Integrare Capgo con il tuo CI/CD

3. Attivare l'upload del bundle su Capgo spingendo commit

4. Configurare e personalizzare la pubblicazione del bundle di Capgo

5. Configurare la tua app per abilitare gli aggiornamenti live tramite Capgo

6. Distribuire aggiornamenti live alla tua app da Capgo

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

Inizia il tutorial

Segui il tutorial di avvio rapido e inizia a usare Capgo in pochissimo tempo!

Guida all'onboarding di CLI

Guida passo-passo per il processo di onboarding interattivo di CLI.

Pubblica aggiornamenti

Pubblica aggiornamenti per la tua app dal dashboard Capgo.

Automatizza gli update

Integra Capgo con il tuo CI/CD e avvia l'upload dei bundle su Capgo spingendo commit.

Risoluzione dei problemi

Problemi comuni e come risolverli.

Riepilogo

Concludi il tutorial e ottieni una panoramica di ciò che hai imparato.

Tip

La funzione di update Over-the-Air (OTA) vale solo per le modifiche ai file HTML, CSS e JavaScript.

Se modifichi il code nativo, ad esempio aggiornando i plugin Capacitor, devi ripresentare l'app all'app store per l'approvazione.

Riservatezza dei bundle

Tratta ogni bundle caricato su Capgo come un asset web pubblico, a meno che tu non abiliti la crittografia Capgo. I canali privati controllano quali dispositivi sono idonei a ricevere un aggiornamento, ma non rendono riservato il bundle caricato. La crittografia protegge il percorso di distribuzione e impedisce a terzi di produrre aggiornamenti crittografati validi, ma gli asset web distribuiti possono comunque essere ricavati dall'app con il reverse engineering e un po' di impegno, dato che la chiave pubblica è distribuita nel binario. Vedi la crittografia Live Update.

Unisciti alla community Discord

Unisciti al server Discord di Capgo!

Manutenzione

Versione del plugin	Compatibilità con Capacitor	Mantenuto
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.*.*	⚠️ Obsoleto a causa di problemi di versioning nel nostro processo CI

Conformità alle linee guida degli store

Android Google Play e iOS App Store hanno linee guida corrispondenti con regole di cui dovresti essere a conoscenza prima di integrare la soluzione Capacitor-updater nella tua applicazione.

Google Play

Terzo paragrafo di Abuso di dispositivi e reti L'argomento descrive che l'aggiornamento del codice sorgente code tramite qualsiasi metodo diverso dal meccanismo di aggiornamento di Google Play è soggetto a restrizioni. Questa restrizione non si applica però all'aggiornamento dei bundle JavaScript.

Questa restrizione non si applica a code che gira in una macchina virtuale e ha 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 aggiorna il code nativo.

App Store

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

Gli code interpretati possono essere scaricati in un'Applicazione, ma solo a patto che tale code: (a) non cambi lo scopo primario dell'Applicazione fornendo funzionalità incoerenti con lo scopo dichiarato e pubblicizzato dell'Applicazione inviata all'App Store, (b) non crei uno store o una vetrina per altri code o applicazioni, e (c) non aggiri la firma, il sandbox o altre funzioni di sicurezza del sistema operativo.

Capacitor Updater ti consente di rispettare queste regole in piena conformità, a condizione che l'update che pubblichi non si discosti significativamente dall'intento originale del tuo prodotto approvato su App Store.

Per mantenere ulteriormente la conformità alle linee guida di Apple, suggeriamo che le app distribuite tramite App Store non abilitino lo Force update scenario, poiché nello Linee guida per la revisione dell'App Store stato che:

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

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

Open source

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

💡 La licenza LGPL-3.0 implica che se qualcuno modifica il code del plugin, è obbligatorio pubblicarlo in open source con la stessa licenza. Se usi il code senza modificarlo, non ti riguarda. Vedi l'issue qui sotto per maggiori dettagli e controlla il link 👇

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, valuta di supportare il mio lavoro diventando uno sponsor GitHub.

Ho fatto una scommessa: rendere open-source tutti i code che ho costruito qui invece di metterli dietro un paywall. Credo che, aprendo invece di combattere e nascondere, possiamo rendere il mondo un posto migliore.

Per rendere tutto questo possibile, è necessario che tutti noi facciamo la nostra parte, compreso te 🥹. Se Capgo cloud non soddisfa le tue esigenze, puoi supportare un maker indipendente su GitHub Sponsors alle tue condizioni.

Semplici calcoli

Il prezzo del piano base: $14*12 = $168 all'anno. Mentre il costo medio per ora di sviluppo = $60. Questo significa che 3 ore di tempo di sviluppo sprecate sul self-hosting bastano a pagare un anno intero; se ne spendi più di 3, stai perdendo soldi ^^

Continua dalla panoramica

Se stai usando Panoramica per pianificare l'automazione CI/CD e connetterla a CI/CD con Capgo per il workflow del 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 Integrazioni Capgo, Integrazione CI/CD per i dettagli implementativi in CI/CD Integration, e Integrazione GitHub Actions per i dettagli implementativi in GitHub Actions Integration.