Panoramica

La guida di avvio rapido ti guiderà attraverso i concetti chiave di Capgo! Concetti che verranno esplorati includono:

1. Aggiungere un'app al tuo account Capgo

2. Integrare Capgo con il tuo CI/CD

3. Attivare l'upload del pacchetto su Capgo facendo commit

4. Configurare e personalizzare la pubblicazione del pacchetto Capgo

5. Configurare l'app per abilitare gli aggiornamenti in tempo reale tramite Capgo

6. Pubblicare gli aggiornamenti in tempo reale per l'app da Capgo

Segui semplicemente la guida passo dopo passo, o naviga direttamente alla documentazione per il componente che ti interessa.

Inizia il Tutorial

Segui la guida di avvio rapido e avrai Capgo in funzione in tempo record!

CLI Guida di Avvio

Guida passo dopo passo completa per il processo di avvio interattivo CLI.

Consegui Aggiornamenti

Consegui aggiornamenti per l'applicazione dal Capgo dashboard.

Automazione degli Aggiornamenti

Integra Capgo con il tuo CI/CD e attiva le caricate di bundle su Capgo facendo commit.

Risoluzione dei Problemi

Problemi comuni e come risolverli.

Conclusione

Concludi il tutorial e ottieni un'anteprima rapida di ciò che hai imparato.

Suggerimento

La funzione di aggiornamento Over-the-Air (OTA) è applicabile solo per modifiche apportate ai file HTML, CSS e JavaScript.

Se apportate modifiche al codice nativo code, ad esempio aggiornamenti ai plugin Capacitor, è obbligatorio riconsegnare l'applicazione alla store per l'approvazione.

Confidenzialità del Pacchetto

Trattare ogni pacchetto caricato su Capgo come un asset web pubblico a meno che non abilitiate l'Capgo crittografia. I canali privati controllano quali dispositivi sono idonei a ricevere un aggiornamento, ma non rendono il pacchetto caricato confidenziale. La crittografia protegge il percorso di consegna e impedisce a terze parti di produrre aggiornamenti crittografati validi, ma gli asset web consegnati possono ancora essere sottoposti a reverse engineering dall'applicazione con sufficiente sforzo perché la chiave pubblica è distribuita nel binario. Vedi Crittografia degli Aggiornamenti in Tempo Reale.

Unisciti alla Comunità Discord

Unisciti al Server Discord di Capgo!

Manutenzione

Versione del Plugin	Compatibilità Capacitor	Mantenne
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.*.*	⚠️ Obsoleto
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 dello Store

Android Google Play e iOS App Store hanno linee guida corrispondenti che hanno regole che dovresti conoscere prima di integrare la soluzione aggiornatrice Capacitor all'interno della tua applicazione.

Google play

Terzo paragrafo di Abuso di dispositivo e rete Il tema descrive che l'aggiornamento della fonte code con qualsiasi metodo diverso dal meccanismo di aggiornamento di Google Play è limitato. Ma questa restrizione non si applica all'aggiornamento dei bundle JavaScript.

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

Ciò consente completamente all'aggiornatore Capacitor di funzionare, poiché aggiorna solo i bundle JS e non aggiorna il code nativo.

App Store

Paragrafo 3.3.2, poiché già dal 2015 Apple Developer Program License Agreement consente completamente di eseguire aggiornamenti in rete in tempo reale di JavaScript e asset - e nella sua ultima versione (20170605) scaricabile qui questa sentenza è ancora più ampia:

Interpretato code può essere scaricato in un'applicazione, ma solo fintanto che tale code: (a) non modifica lo scopo principale dell'applicazione fornendo funzionalità o caratteristiche che sono incompatibili con lo scopo e l'intento pubblicizzato dell'applicazione come presentata all'App Store, (b) non crea un negozio o un negozio per altre code o applicazioni, e (c) non bypassa la firma, il sandbox o altre funzionalità di sicurezza del sistema operativo.

Capacitor Updater consente di seguire queste regole in piena conformità, a patto che l'aggiornamento che si invia non diverga significativamente il prodotto dal suo intento originale approvato dall'App Store.

Per rimanere ulteriormente in conformità con le linee guida di Apple, suggeriamo che le app distribuite tramite l'App Store non attivino il Force update scenario, poiché nel App Store Review Guidelines stabiliscono che:

Gli app devono non costringere gli utenti a valutare l'app, a recensire l'app, a scaricare altre app, o altre azioni simili per accedere a funzionalità, contenuti o utilizzo dell'app.

Ciò non è un problema per il comportamento di default dell'aggiornamento in background, poiché non costringerà l'utente ad applicare la nuova versione fino a quando non chiuderà l'app per la prima volta, ma almeno dovresti essere a conoscenza di quel ruolo se decidi di mostrarlo.

Open source

Il plugin è sotto la Licenza LGPL-3.0 e il back-end è AGPL-3.0 License.

💡 LGPL-3.0 significa che se qualcuno modifica il code del plugin, è obbligatorio pubblicarlo, in open-source con la stessa licenza. Se utilizzi il code senza modifiche, non ti riguarda. Vedi l'issue di seguito per ulteriori dettagli, controlla il link 👇

La licenza?

Prova GPTS Capgo per ottenere aiuto al posto di leggere i documenti

Puoi includerlo nel tuo app senza preoccuparti

Note finali

Se self-host e trovi utile questo strumento, ti preghiamo di considerare il sostegno al mio lavoro diventando un GitHub sponsor.

Ho fatto una scommessa per rendere open-source tutti i code che ho costruito qui al posto di paywallarlo. Sono convinto che aprire le cose al posto di combattere e nascondere possiamo rendere il mondo un posto migliore.

To rendere tutto ciò possibile, è necessario che tutti noi facciamo la nostra parte, compreso te 🥹. Se il tuo Capgo cloud non soddisfa le tue esigenze, puoi sostenere un Maker auto-sostenibile qui su termini tuoi.

Semplici matematiche

Il prezzo del piano base: $14*12 = $168 all'anno. Mentre il dev/hour medio è di $60. Ciò significa che 3 ore di tempo di sviluppo perse per l'auto-hosting ti consentono di pagare per un anno intero, se hai speso più di 3 ore stai perdendo denaro ^^

Continua da Overview

Se stai utilizzando Panoramica per pianificare l'automazione CI/CD, connettilo con Capgo CI/CD per il flusso di lavoro del prodotto in Capgo CI/CD, Capgo Costruzioni native per il flusso di lavoro del prodotto in Capgo Costruzioni native, Capgo Integrazioni per il flusso di lavoro del prodotto in Capgo Integrazioni, Integrazione CI/CD per il dettaglio di implementazione in Integrazione CI/CD, e GitHub Integrazione delle azioni per il dettaglio di implementazione in GitHub Integrazione delle azioni.