Comandi

Questa pagina è un'introduzione guidata. Utilizza la riferimento delle attuali impostazioni per flag esatti: app, bundle, canale, e costruisci.

Utilizzo

Tutti i comandi dovrebbero essere eseguiti nel folder del tuo progetto con capacitor acceso correttamente.

Capacitor Runtime nativo cross-platform per applicazioni web

Inizia

npx @capgo/cli@latest init [apikey]

Questo metodo è qui per guidarti passo dopo passo.

Aggiungerà il tuo progetto a Capgo. Aggiungerà code al tuo progetto per validare l'aggiornamento. Inoltre, costruirà il tuo progetto. Inoltre, caricherà il tuo progetto su Capgo. E ti aiuterà a verificare se l'aggiornamento funziona.

Accedi

npx @capgo/cli login [apikey]

Sezione intitolata “Accedi” apikey Questo metodo è qui per ricordare i tuoi dati di accesso per te.

Nota

utilizza --apikey=******** in qualsiasi comando per sovrascriverlo

Facoltativamente puoi fornire:

--local Questo salverà il tuo apikey in repository locale e lo ignorerà nel file .gitignore.

Medico

npx @capgo/cli doctor

Comando per verificare se sei aggiornato con i pacchetti Capgo.

Questo comando sarà anche utile per i report di bug.

App

Aggiungi

npx @capgo/cli app add [appId]

[appId] aggiungi il tuo ID app nel formato com.test.app è spiegato qui.

💡 Tutte le opzioni verranno dedotte nella tua configurazione se non fornite.

Facoltativamente, puoi fornire:

• --icon [/path/to/my/icon] to have a custom icon display in Capgo web app.
• --name [test] per avere un nome personalizzato nella lista.
• --apikey [key] chiave API per collegare il tuo account.
• --retention [retention] periodo di conservazione del bundle dell'applicazione in giorni, 0 di default = infinito.

Esempio di capacitor.config.json per appId e AppName, l'icona viene riconosciuta nel cartellone delle risorse

{
  "appId": "ee.forgr.capacitor_go",
  "appName": "Capgo",
  "webDir": "dist"
}

Imposta

npx @capgo/cli app set [appId]

[appId] è il tuo ID dell'applicazione, il formato è spiegato qui.

Facoltativamente, puoi dare:

• --icon [/path/to/my/icon] per avere un'icona personalizzata nel web app Capgo.
• --name [test] per avere un nome personalizzato nella lista.
• --retention [retention] periodo di conservazione del bundle dell'applicazione in giorni, 0 di default = infinito.
• --expose-metadata [true|false] per esporre i metadati del bundle (link e commento) al plugin.
• --preview o --no-preview Oppure, se si desidera sapere cosa è meglio per il proprio progetto, potrebbe essere utile confrontare le alternative di Capacitor live-update. Alcune delle principali differenze tra le varie opzioni includono la facilità d'uso, le prestazioni e la compatibilità con i diversi sistemi operativi. Inoltre, è importante considerare le esigenze specifiche del proprio progetto e scegliere l'opzione che meglio si adatti alle proprie esigenze.
• --allow-device-custom-id per abilitare o disabilitare i codici QR di anteprima del bundle e del canale. --no-allow-device-custom-id o
• --block-provider-infra-requests Oppure, se si desidera sapere cosa è meglio per il proprio progetto, potrebbe essere utile confrontare le alternative di Capacitor live-update. Alcune delle principali differenze tra le varie opzioni includono la facilità d'uso, le prestazioni e la compatibilità con i diversi sistemi operativi. Inoltre, è importante considerare le esigenze specifiche del proprio progetto e scegliere l'opzione che meglio si adatti alle proprie esigenze. --no-block-provider-infra-requests per controllare gli ID dei dispositivi personalizzati.
• --build-timeout-minutes [5-360] o
• --ios-store-url [url] Oppure, se si desidera sapere cosa è meglio per il proprio progetto, potrebbe essere utile confrontare le alternative di Capacitor live-update. Alcune delle principali differenze tra le varie opzioni includono la facilità d'uso, le prestazioni e la compatibilità con i diversi sistemi operativi. Inoltre, è importante considerare le esigenze specifiche del proprio progetto e scegliere l'opzione che meglio si adatti alle proprie esigenze. --android-store-url [url] per bloccare le richieste dei datacenter di Google e Apple.
• --default-upload-channel [channel] per impostare il timeout di costruzione nativa.
• --default-download-channel [channel] o --disable-download-channels per rendere tutti i canali di download non pubblici.
• --apikey [key] la chiave API per collegarsi al proprio account.

Elenco

npx @capgo/cli app list [appId]

[appId] l'ID dell'applicazione nel formato com.test.app è spiegato qui.

Se desideri, puoi fornire:

• --apikey [key] la chiave API per collegarsi al proprio account.

Cancella

npx @capgo/cli app delete [appId]

[appId] l'ID dell'applicazione nel formato com.test.app E' spiegato Ecco.

Facoltativamente, puoi fornire:

• --apikey [key] API chiave per collegarsi al tuo account.
• --bundle Con il numero di versione, eliminerà solo questa versione.

Debug

npx @capgo/cli app debug [appId]

[appId] L'ID del tuo app nel formato com.test.app E' spiegato Ecco.

Facoltativamente, puoi fornire:

• --apikey [key] API chiave per collegarsi al tuo account.
• --device con il dispositivo specifico che desiderate debuggare

Impostazioni

npx @capgo/cli app setting [path]

Modifica la configurazione Capacitor.

[path] - percorso della impostazione che desiderate modificare. Ad esempio, per modificare il appIdfornisce appIdSe desiderate disabilitare l'aggiornamento automatico in capacitor-updaterfornisce plugins.CapacitorUpdater.autoUpdate con --string off.

È necessario fornire uno dei seguenti --string o --bool!

context:Alternatives CTA Questions, HTML text fragment from a longer Capgo UI string (parent key `alternatives_cta_questions`). Page/area: Capacitor live-update alternatives comparison page. Role: Long marketing or legal paragraph. Seen in: page alternatives.astro. Preserve Capgo product/brand and developer terms exactly. Message key `alternatives_cta_questions` (Alternatives CTA Questions). | context:Appflow CTA Questions, HTML text fragment from a longer Capgo UI string (parent key `appflow_cta_questions`). Page/area: Appflow comparison / migration marketing copy. Role: Long marketing or legal paragraph. Seen in: page ionic-appflow.astro. Preserve Capgo product/brand and developer terms exactly. Message key `appflow_cta_questions` (Appflow CTA Questions). | context:Capawesome CTA Questions, HTML text fragment from a longer Capgo UI string (parent key `capwesome_cta_questions`). Page/area: Capawesome comparison page. Role: Long marketing or legal paragraph. Seen in: page capwesome.astro. Preserve Capgo product/brand and developer terms exactly. Message key `capwesome_cta_questions` (Capwesome CTA Questions). | context:Consulting FAQ Subtitle, HTML text fragment from a longer Capgo UI string (parent key `consulting_faq_subtitle`). Page/area: Consulting services page. Role: Section subtitle or tagline. Seen in: page consulting.astro. Preserve Capgo product/brand and developer terms exactly. Message key `consulting_faq_subtitle` (Consulting FAQ Subtitle). | context:Appflow Plugins Or, Page/area: Appflow comparison / migration marketing copy. Role: Short UI label or navigation item. Seen in: page ionic-appflow.astro, page ionic-enterprise-plugins.astro, page solutions/ionic-enterprise-plugins.astro. Message key `appflow_plugins_or` (Appflow Plugins Or).

• --string <string> - imposta la impostazione su una stringa
• --bool <true | false> - imposta la impostazione su un booleano

Bundle

Carica

npx @capgo/cli bundle upload [appId]

[appId] è il tuo ID applicazione, il formato è spiegato qui.

Se lo desideri, puoi fornire:

• --apikey <apikey> API chiave per collegarsi al tuo account.
• --path <path> Percorso della cartella da caricare.
• --channel <channel> Canale da collegare.
• --external <url> Collegamento a un URL esterno al posto di caricare su Capgo Cloud.
• --iv-session-key <key> Imposta la chiave di IV e la chiave di sessione per l'URL del pacchetto esterno.
• --s3-endpoint <s3Endpoint> URL del punto di fine endpoint S3. Non funziona con le upload delta o l'opzione esterna.
• --s3-region <region> Regione per il tuo bucket S3.
• --s3-apikey <apikey> API chiave per il tuo punto di fine endpoint S3.
• --s3-apisecret <apisecret> API segreto per il tuo punto di fine endpoint S3.
• --s3-bucket-name <bucketName> Nome per il tuo bucket S3 AWS.
• --s3-port <port> Porta per il tuo punto di fine endpoint S3.
• --no-s3-ssl Disabilita SSL per l'upload S3.
• --key <key> Percorso personalizzato per la chiave di firma pubblica (sistema v1).
• --key-data <keyData> Chiave di firma pubblica (sistema v1).
• --key-v2 <key> Percorso personalizzato per la chiave di firma privata (sistema v2).
• --key-data-v2 <keyData> Chiave di firma privata (sistema v2).
• --bundle-url Stampa l'URL del bundle nella console.
• --no-key Ignora la chiave di firma e invia un aggiornamento chiaro.
• --no-code-check Ignora la verifica se notifyAppReady() è chiamato nel file sorgente code e l'indice presente nella cartella radice.
• --display-iv-session Mostra nella console la chiave di IV e di sessione utilizzate per cifrare l'aggiornamento.
• --bundle <bundle> Numero di versione del bundle da caricare.
• --auto-bump [level] Numero di versione del bundle da caricare. Auto-incrementa dal bundle collegato al canale, altrimenti la versione app più recente. Livello: major, minor Livello predefinito. patch Alias per fix), metadataO ai Il Workers AI confronta i file locali con il manifesto delta del canale precedente Capgo, inferisce il livello e registra una breve ragione; salta l'AI e aumenta patch se non esiste una versione precedente Capgo. Aumenta fino a trovare un nome libero (i nomi eliminati restano occupati). Non può essere combinato con --bundle.
• --min-update-version <minUpdateVersion> Versione minima richiesta per aggiornarsi a questa versione. Utilizzato solo se l'aggiornamento automatico è disabilitato nel canale.
• --auto-min-update-version Imposta la versione di aggiornamento minima in base ai pacchetti nativi.
• --ignore-metadata-check Ignora il controllo dei metadati (node_modules) durante l'upload.
• --ignore-checksum-check Ignora il controllo del checksum durante l'upload.
• --timeout <timeout> Timeout per il processo di upload in secondi.
• --delta Carica i file Delta (manifesto) insieme al bundle completo.
• --delta-only Carica solo gli aggiornamenti Delta (manifesto), saltando il bundle completo.
• --no-delta Disabilita le upload Delta (manifesto) (utile se è abilitato il modalità di applicazione istantanea ma si desidera un bundle completo). autoUpdate Carica il bundle utilizzando il protocollo tus.
• --tus Utilizza il protocollo multipart per caricare i dati su S3, Obsoleto, utilizzare TUS invece.
• --multipart Un checksum crittografato (firma). Utilizzato solo quando si carica un bundle esterno.
• --encrypted-checksum <encryptedChecksum> Disabilita le upload Delta (manifesto) (utile se è abilitato il modalità di applicazione istantanea ma si desidera un bundle completo).
• --package-json <packageJson> A un percorso per package.json. Utile per i monorepos.
• --auto-set-bundle Imposta il bundle in capacitor.config.json.
• --node-modules <nodeModules> Una lista di percorsi per node_modules. Utile per i monorepos (separati da virgole, ad esempio: ../../node_modules,./node_modules)

⭐️ L'opzione esterna aiuta a sbloccare 2 casi: aziende con preoccupazioni sulla privacy, non inviare il code a un terzo partito e applicazioni più grandi di 200 MB. Con questa impostazione, Capgo archivia solo il collegamento al file zip e invia il collegamento a tutte le applicazioni.

👀 Il cloud di Capgo non guarda mai cosa c'è nel collegamento (per l'opzione esterna), o nel code quando archiviato.

🔑 Puoi aggiungere un secondo strato di sicurezza utilizzando la crittografia, quindi Capgo non potrà più guardare o modificare nulla, diventa “incondizionato”.

Esempio di package.json per versione

{
  "version": "1.0.2"
}

⛔ La versione dovrebbe essere maggiore di “0.0.0”.

💡 Non dimenticare di aggiornare il numero di versione ogni volta che invii uno, il numero di versione non può essere sovrascritto o riutilizzato dopo la cancellazione per motivi di sicurezza.

Elenca

npx @capgo/cli bundle list [appId]

[appId] il tuo ID app nella forma com.test.app è spiegato qui.

Facoltativamente, puoi fornire:

• --apikey [key] API chiave per collegarti al tuo account.

Cancella

npx @capgo/cli bundle delete [appId]

[appId] il tuo ID app nella forma com.test.app è spiegato qui.

Facoltativamente, puoi fornire:

• --apikey [key] API chiave per collegarsi al tuo account.
• --bundle con il numero di versione cancellerà solo questa versione.

Pulizia

in un intervallo di versione SemVer per una versione maggiore verso Cloud

npx @capgo/cli bundle cleanup [appId] --bundle=[majorVersion] --keep=[numberToKeep]

[appId] il tuo ID app nel formato com.test.app è spiegato qui.

Opzionalmente, puoi dare:

• --apikey [key] API chiave per collegarsi al tuo account.
• --bundle [majorVersion] una versione che desideri rimuovere pacchetti precedenti, terrà l'ultimo + numberToKeep.
• --keep [numberToKeep] il numero di pacchetti che desideri mantenere (predefinito 4).

Esempio: Se hai 10 versioni da 10.0.1 a 10.0.11, e utilizzi npx @capgo/cli cleanup [appId] --bundle=10.0.0 Rimuoverà 10.0.1 a 10.0.6. 10.0.7 fino a 10.0.11 verranno mantenuti.

Se hai 20 versioni in totale, e non fornisci un numero di pacchetto come questo: npx @capgo/cli cleanup [appId] --keep=2 Rimuoverà 18 versioni, e mantiene le ultime 2.

Questa operazione richiederà conferma, mostrerà una tabella di cosa verrà mantenuto e rimosso.

Nota

Questa operazione ignorerà i pacchetti che sono attualmente in uso in qualsiasi canale.

Cifrare

Avviso: Questa operazione è deprecata e verrà rimossa nella prossima versione maggiore. Utilizza il nuovo sistema di cifratura. npx @capgo/cli bundle encrypt [path/to/zip]

Questo comando viene utilizzato quando si utilizza una fonte esterna per memorizzare il tuo code o per scopi di test.

Facoltativamente, puoi fornire:

--key [/path/to/my/private_key] la percorso della tua chiave privata. --key-data [privateKey] i dati della chiave privata, se desideri utilizzare inline. Il comando stampa il tuo ivSessionKeyy e genera un file zip crittografato, da utilizzare con il comando di caricamento o il comando di decrittografia.

Crittografa V2

npx @capgo/cli bundle encrypt [path/to/zip] [checksum]

Questo comando viene utilizzato quando si utilizza una fonte esterna per memorizzare il tuo code o per scopi di test. Il checksum è lo sha256 del pacchetto (generato da —key-v2), viene utilizzato per verificare l'integrità del file dopo la decrittografia. Verrà crittografato con la chiave privata e inviato insieme al pacchetto. Nella crittografia v2 il checksum viene aggiornato per diventare una “firma” del pacchetto.

Facoltativamente, puoi fornire:

--key [/path/to/my/private_key] la percorso della tua chiave privata. --key-data [privateKey] i dati della chiave privata, se desideri utilizzare inline. --json per stampare le informazioni in formato JSON. Il comando stampa il tuo ivSessionKeyy e genera un zip cifrato, da utilizzare con il comando di caricamento o il comando di decrittazione.

Decrittazione

npx @capgo/cli bundle decrypt [path/to/zip] [ivSessionKey]

Se lo desiderate, potete fornire:

--key [/path/to/my/private_key] la via del vostro chiave privata.

--key-data [privateKey] i dati della chiave privata, se desiderate utilizzare i dati inline. Questo comando è principalmente utilizzato per scopi di test, decrittizzerà il zip e stampa la chiave di sessione base64 decrittata nella console.

Decrittazione V2

npx @capgo/cli bundle decryptV2 [path/to/zip] [ivSessionKey]

Se lo desiderate, potete fornire:

--key [/path/to/my/private_key] la via del vostro chiave privata. --key-data [privateKey] i dati della chiave privata, se desiderate utilizzare i dati inline. Questo comando è principalmente utilizzato per scopi di test, decrittizzerà il zip e stampa la chiave di sessione base64 decrittata nella console. --checksum [checksum] il checksum del file, verificherà il checksum dopo la decrittazione.

Zip

npx @capgo/cli bundle zip [appId]

[appId] è il tuo ID app, il formato è spiegato qui.

Facoltativamente, puoi dare:

• --path [/path/to/my/bundle] per caricare una cartella specifica.
• --bundle [1.0.0] per impostare il numero di versione del pacchetto nel nome del file.
• --name [myapp] per sovrascrivere il nome del file.
• --json per visualizzare le informazioni come JSON.
• --no-code-check per ignorare il controllo code e inviare il pacchetto comunque.
• --key-v2 per utilizzare il nuovo sistema di crittografia. Questo è richiesto poiché il nuovo sistema di crittografia utilizza checksum migliori per verificare l'integrità del file.

Compatibilità

npx @capgo/cli bundle compatibility [appId] -c [channelName]

[appId] è il tuo ID applicazione, il formato è spiegato qui. [channelName] il nome del canale da verificare.

Opzionalmente, puoi fornire:

• --apikey [key] API chiave per collegarsi al tuo account.
• --text utilizzare il testo al posto degli emoji nella tabella
• --channel [channel] il canale da verificare la compatibilità con.
• --package-json <packageJson> Un percorso per package.json. Utile per i monorepos
• --node-modules <nodeModules> Una lista di percorsi per node_modules. Utile per i monorepos (separati da virgole ad esempio: ../../node_modules,./node_modules)

Canale

Aggiungi

npx @capgo/cli channel add [channelName] [appId]

[channelName] il nome del tuo nuovo canale, ad esempio production o beta. [appId] la descrizione del tuo nuovo canale, come com.test.app la descrizione del tuo nuovo canale, come la descrizione del tuo nuovo canale, come.

la descrizione del tuo nuovo canale, come

npx @capgo/cli channel delete [channelName] [appId]

[channelName] Sezione intitolata “Cancella” [appId] il nome del canale che desideri cancellare. com.test.app il nome del tuo app ID, nel formato Ecco.

Elenco

npx @capgo/cli channel list [appId]

[appId] il tuo ID app, il formato com.test.app è spiegato Ecco.

Se lo desideri, puoi fornire:

• --apikey [key] API chiave per collegare il tuo account.

Imposta

npx @capgo/cli channel set [channelName] [appId]

[appId] è il tuo ID app, il formato è spiegato Ecco. [channelName] il nome del canale che desideri configurare, ad esempio production o beta.

Se desideri, puoi fornire:

• --bundle [1.2.3] il tuo bundle di app già inviato in cloud, per collegarlo a un canale.
• --latest ottenere la versione del bundle da package.json:version, non può essere utilizzato con --bundle.
• --state [ normal | default ] impostare lo stato del canale, può essere normal o default. Un canale deve essere default.
• --downgrade consente al canale di inviare versioni di downgrade ai dispositivi.
• --no-downgrade non consente al canale di inviare versioni di downgrade ai dispositivi.
• --upgrade consente al canale di inviare versioni di upgrade (maggiore) ai dispositivi.
• --no-upgrade impedisce al canale di inviare la versione di aggiornamento (maggiore) ai dispositivi.
• --ios consente al canale di inviare la versione ai dispositivi iOS.
• --no-ios impedisce al canale di inviare la versione ai dispositivi iOS.
• --android consente al canale di inviare la versione ai dispositivi Android.
• --no-android impedisce al canale di inviare la versione ai dispositivi Android.
• --self-assign consente ai dispositivi di assegnarsi automaticamente a questo canale.
• --no-self-assign impedisce ai dispositivi di assegnarsi automaticamente a questo canale.
• --disable-auto-update STRATEGY Disabilita la strategia di aggiornamento automatico per questo canale. Le opzioni possibili sono: maggiore, minore, patch, metadati, nessuno.
• --apikey [key] API chiave per collegarsi al proprio account.

Disabilita la strategia di aggiornamento.

Sono disponibili alcune modalità per gestire la disabilitazione degli aggiornamenti per versioni troppo vecchie.
Capgo non può aggiornare nativi code quindi un aggiornamento da una versione con il vecchio nativo code a una versione con il nativo aggiornato code non dovrebbe essere possibile. Ci sono un paio di modi per raggiungere questo.

Prima, la major strategia. Impedisce un aggiornamento da baseline nativo 0.0.0 -> bundle di destinazione 1.0.0. Il major è il numero evidenziato (1.0.0 e 0.0.0).
Seconda è la minor strategia. Impedisce un aggiornamento quando il bundle di destinazione ha un major o minor diverso dal baseline nativo del dispositivo, come 0.0.0 -> 1.1.0 o 1.1.0 -> 1.2.0.

context:HTML testo frammento da una stringa UI Capgo più lunga (chiave genitore `alternatives_cta_questions`). Pagina/area: pagina di confronto delle alternative di Capacitor per l'aggiornamento live. Ruolo: lungo paragrafo di marketing o legale. Visto in: pagina alternatives.astro. Preservare esattamente i termini del prodotto e della marca Capgo e i termini dei developer. Chiave del messaggio `alternatives_cta_questions` (Domande per l'alternativa CTA). | Testo frammento HTML da una stringa UI Capgo più lunga (chiave genitore `appflow_cta_questions`). Pagina/area: pagina di confronto e migrazione di Appflow. Ruolo: lungo paragrafo di marketing o legale. Visto in: pagina ionic-appflow.astro. Preservare esattamente i termini del prodotto e della marca Capgo e i termini dei developer. Chiave del messaggio `appflow_cta_questions` (Domande per l'alternativa CTA di Appflow). | Testo frammento HTML da una stringa UI Capgo più lunga (chiave genitore `capwesome_cta_questions`). Pagina/area: pagina di confronto di Capawesome. Ruolo: lungo paragrafo di marketing o legale. Visto in: pagina capwesome.astro. Preservare esattamente i termini del prodotto e della marca Capgo e i termini dei developer. Chiave del messaggio `capwesome_cta_questions` (Domande per l'alternativa CTA di Capawesome). | Pagina/area: pagina di confronto e migrazione di Appflow. Ruolo: breve etichetta UI o elemento di navigazione. Visto in: pagina ionic-appflow.astro, pagina ionic-enterprise-plugins.astro, pagina solutions/ionic-enterprise-plugins.astro. Chiave del messaggio `appflow_plugins_or` (Appflow Plugins o). patch strategy. It was added into capgo as a very strict mode. It’s not recommended to be used unless you fully understand how it works. In order for it to accept an update, the following conditions must be met:

• strategia. È stata aggiunta in __CAPGO_KEEP_0__ come un modo molto rigoroso. Non è consigliato di usarlo a meno che non si comprenda completamente come funziona. Per accettare un aggiornamento, le seguenti condizioni devono essere soddisfatte: il major è lo stesso tra il bundle di destinazione e version_build
• The minor is the same tra il bundle di destinazione e version_build
• The patch is the same tra il bundle di destinazione e version_build
• Soltanto la suffisso di versione può differire, ad esempio prerelease (-beta.2) o metadati di costruzione (+build.2)

Ecco un esempio di quali scenari l'aggiornamento è consentito o negato

• 1.0.0-beta.1 -> 1.0.0-beta.2 consentito
• 1.0.0+build.1 -> 1.0.0+build.2 consentito
• 1.0.0 -> 1.0.1 bloccato
• 1.0.0 -> 1.1.0 bloccato
• 1.0.0 -> 2.0.0 bloccato

La comparazione della strategia utilizza il baseline nativo inviato come version_build, non il bundle scaricato correntemente inviato come version_name.

Infine la strategia più complessa. metadata La strategia.
Per prima cosa devi sapere che inizialmente dopo averla abilitata le aggiornamenti context: Pagina/Area: Capgo Builder / prodotto di costruzione nativa cloud. Ruolo: Etichetta breve UI o elemento di navigazione. Chiave di messaggio `native_build_builder_credit_first` (Crediti del costruttore di costruzione nativa). NON
falliranno

Se il canale manca dei dati per il metadata, vedrai un messaggio come questo:
Non è possibile trovare i dati del metadata. misconfigured Se vedi qualcosa di questo tipo, significa che devi andare al bundle corrente per il canale che sta fallendo e impostare i dati del metadata.

colonna di errore della tabella 'Canali non configurati'. Bundle number. Questo dovrebbe portarti alla pagina del bundle.

Una volta lì, riempire il Minimal update version campo. Questo dovrebbe essere un semver.
Se il valore che passi non è un semver, otterrai un errore, ma se tutto va bene dovresti vedere qualcosa come questo:

Ora, probabilmente non vuoi impostare manualmente questo dato ogni volta che aggiorni. Fortunatamente, il CLI impedirà di inviare un aggiornamento senza questo metadati

Per caricare correttamente un bundle quando si utilizza l' metadata opzione, è necessario passare il --min-update-version insieme con il valid semverQualcosa di questo tipo:

La --min-update-version non è l'UNICO modo di fare la compatibilità. Esiste anche il --auto-min-update-versionEcco come funziona.

Prima, si guarda la versione attualmente caricata nel canale. Controlla la compatibilità allo stesso modo del bundle compatibility comando. min_update_version Secondo, se la nuova versione è del 100% compatibile, riprende il min_update_version dalla versione più recente nel canale.

Se non, allora imposta il min_update_version al numero del pacchetto della versione appena caricata.

Se la nuova versione non è compatibile dovrebbe avere questo aspetto

Chiarimento finale (Senza fiducia)

Capgo supporta la crittografia end-to-end, ciò significa che il tuo bundle (code) viene crittografato prima di essere inviato in cloud e decrittografato sul dispositivo. Per questo, è necessario generare una coppia di chiavi RSA, puoi utilizzare il seguente comando per generarlo.

Il sistema di crittografia è una combinazione di RSA e AES, la chiave RSA viene utilizzata per crittografare la chiave AES, e la chiave AES viene utilizzata per crittografare il file.

Ecco di seguito ulteriori informazioni sul sistema di crittografia.

Schema di crittografia

Creare una chiave per il tuo app

npx @capgo/cli key create

Opzionalmente, puoi fornire: --force Per sovrascrivere la chiave esistente. Questo comando creerà per te una coppia di chiavi nella tua app e ti chiederà di salvare la chiave privata in un luogo sicuro. È consigliabile non committare la chiave privata nel file di configurazione e non condividerla con nessuno.

Dopo il tuo test locale, rimuovi la chiave dal file di configurazione e aggiungila nel passaggio di CI con key save

Salva la chiave nella configurazione dell'app

npx @capgo/cli key save

Opzionalmente, puoi fornire:

--key [/path/to/my/public_key] il percorso del file della chiave pubblica.

--key-data [publicKey] i dati della chiave pubblica, se desideri utilizzare inline. Questo comando è utile se hai seguito la raccomandazione e non hai commesso la chiave nella configurazione dell'app.

L'integrazione CI

Per automatizzare il tuo lavoro, ti consiglio di fare che l'azione GitHub si occupi di inviare il lavoro sul nostro server

La guida per l'azione GitHub

La nostra app demo

GitHub - Cap-go/demo-app

Non dimenticare di configurare la variabile di ambiente CI con la tua API chiave

Continua da Comandi

Se stai utilizzando Comandi per pianificare il dashboard e le API operazioni, connettilo con API Overview per i dettagli di implementazione in API Overview Introduzione per i dettagli di implementazione in Introduction API Chiavi per i dettagli di implementazione in API Chiavi Dispositivi per i dettagli di implementazione in Dispositivi, e Bundle per i dettagli di implementazione in Bundle.