Aggiornando la tua Capacitor l'app è mai stata più facile. Combinate le aggiornamenti Over-The-Air (OTA) con i npm script, puoi automatizzare i deployment, risparmiare tempo e assicurarti che i tuoi utenti abbiano sempre la versione più recente - senza dover attendere l'approvazione degli store di app.
Ecco cosa imparerai:
- Come configurare i npm script per gli aggiornamenti OTA.
- Come integrare gli aggiornamenti nei flussi di lavoro CI/CD per l'automazione.
- Come gestire le versioni dell'app, la sicurezza e le prove degli aggiornamenti.
- Perché Capgo è una piattaforma affidabile per la gestione degli aggiornamenti OTA.
Benefici chiave:
- Aggiorna automaticamente con un comando.
- Deploy gli aggiornamenti in modo sicuro con crittografia.
- Integrate aggiornamenti nei flussi di lavoro come GitHub Azioni.
- Salva tempo con strumenti come Capgo, che fornisce aggiornamenti in meno di 500ms.
Esempio di configurazione rapida:
- Installa gli strumenti:
npm install @capgo/cli --save-dev - Configura gli aggiornamenti in
capacitor.config.json. - Aggiungi npm script come
deploy:productionper semplificare la distribuzione.
Con piattaforme come Capgo che offrono aggiornamenti veloci (95% di adozione degli utenti in 24 ore) e prezzi accessibili, la gestione degli aggiornamenti OTA è mai stata più efficiente.
npm Script di configurazione per gli aggiornamenti OTA
Ecco come configurare npm script per gestire Capacitor aggiornamenti OTA effettivamente. Ciò comporta l'installazione dei pacchetti necessari, la configurazione delle impostazioni e la creazione di script di distribuzione.
Installazione dei Pacchetti Richiesti
Prima, installa i pacchetti richiesti. Il Capgo CLI strumento semplifica questo processo con comandi integrati:
npm install @capgo/cli --save-dev
npm install @capacitor/cli --save-dev
Poi, inizializza la configurazione OTA utilizzando il seguente comando:
npx @capgo/cli init
Configurazione degli Aggiornamenti OTA
Aggiorna il tuo capacitor.config.json file con le seguenti impostazioni per preparare l'app per gli aggiornamenti OTA:
{
"appId": "com.your.app",
"appName": "Your App",
"plugins": {
"CapacitorUpdates": {
"autoUpdate": true,
"updateUrl": "https://api.capgo.app/updates",
"statsUrl": "https://api.capgo.app/stats"
}
}
}
Questa configurazione assicura che l'app possa estrarre gli aggiornamenti automaticamente e riferire statistiche.
Creazione di Script di Distribuzione
Aggiungi questi npm script alla tua package.json file per semplificare il processo di costruzione e distribuzione:
{
"scripts": {
"build:web": "npm run build",
"build:update": "npx @capgo/cli build",
"deploy:update": "npx @capgo/cli upload",
"deploy:production": "npm run build:web && npm run build:update && npm run deploy:update"
}
}
build:web: Costruisce gli asset web, tipicamente utilizzato durante lo sviluppo e la distribuzione.build:update: Prepara il pacchetto di aggiornamento per gli aggiornamenti OTA.deploy:update: Carica il pacchetto di aggiornamento su Capgo.deploy:production: Gestisce l'intero workflow di costruzione e distribuzione, ideale per rilasci di produzione.
Impostazione delle Variabili di Ambiente
Per completare la configurazione, definisci queste variabili di ambiente:
CAPGO_TOKEN=your_api_token
CAPGO_APP_ID=your_app_id
Compatibilità e Affidabilità
Il Capgo CLI supporta Capacitor 8, garantendo che funzioni con le ultime versioni mentre mantiene una funzionalità di aggiornamento affidabile.
| Comando dello Script | Scopo | context |
|---|---|---|
| build:web | Costruisce gli asset web | Durante lo sviluppo e la distribuzione |
| build:update | Prepara il pacchetto di aggiornamento | Prima di ogni aggiornamento OTA |
| deploy:update | Uploads updates to Capgo | Quando gli aggiornamenti sono pronti per essere pubblicati |
| deploy:production | Gestisce l'intero workflow | Per rilasci di produzione |
Aggiungere npm script al CI/CD
Integrare npm script nel flusso di lavoro del CI/CD può semplificare il processo di aggiornamento Over-The-Air (OTA) per le Capacitor app. Ecco una guida per configurare le distribuzioni automatizzate in modo efficiente.
Setup di CI/CD
Configura il tuo ambiente CI/CD con le variabili e i passaggi necessari:
environment:
CAPGO_TOKEN: ${{ secrets.CAPGO_TOKEN }}
CAPGO_APP_ID: ${{ secrets.CAPGO_APP_ID }}
NODE_ENV: production
Per un ottimo rendimento, includi il caching nel processo di build:
cache:
paths:
- node_modules/
- .npm/
- dist/
GitHub Azioni Guida di configurazione

Per automatizzare il tuo workflow di distribuzione, crea un file con questa configurazione: .github/workflows/ota-deploy.yml Questa configurazione garantisce che la tua app venga distribuita automaticamente ogni volta che vengono apportate modifiche al branch.
name: Deploy OTA Update
on:
push:
branches: [ main ]
jobs:
deploy:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v6
- name: Setup Node.js
uses: actions/setup-node@v3
with:
node-version: '24'
- name: Install dependencies
run: npm ci
- name: Run deployment
run: npm run deploy:production
env:
CAPGO_TOKEN: ${{ secrets.CAPGO_TOKEN }}
CAPGO_APP_ID: ${{ secrets.CAPGO_APP_ID }}
branch main branch
Aggiornamento di Recupero e Riparazioni
Per gestire eventuali fallimenti di aggiornamento, includere meccanismi di recupero nella pipeline CI/CD. Queste funzionalità possono aiutare a mantenere la stabilità dell'applicazione:
| Funzione di Recupero | Implementazione | Scopo |
|---|---|---|
| Versione di Ritorno | npm run revert:update |
Ritorna alla versione stabile precedente |
| Verifiche di Salute | npm run verify:update |
Assicura che l'aggiornamento funzioni correttamente |
| Ritenta automaticamente | maxRetries: 3 Configurazione |
Prova l'aggiornamento più volte |
Puoi migliorare lo script di distribuzione per gestire automaticamente gli errori.
npm run deploy:production || npm run revert:update
Questo script assicura che se una distribuzione fallisce, il sistema si ripristini alla versione stabile precedente. Inoltre, il tuo pipeline CI/CD può inviare rapporti di stato e attivare le notifiche attraverso la tua piattaforma preferita.
Consigli per la gestione degli aggiornamenti OTA
La gestione efficace degli aggiornamenti OTA richiede di tenere d'occhio il controllo delle versioni, test rigorosi e protocolli di sicurezza solidi. Ecco come puoi semplificare gli aggiornamenti utilizzando gli script npm.
Gestione delle versioni
La versione semantica è un modo semplice per gestire gli aggiornamenti dell'app. Ecco un esempio di configurazione:
{
"version": "2.5.0",
"scripts": {
"update:major": "npm version major && npm run deploy:update",
"update:minor": "npm version minor && npm run deploy:update",
"update:patch": "npm version patch && npm run deploy:update"
}
}
L'utilizzo di canali separati come Produzione, Beta, Alpha e Hotfix consente roll-out mirati. Queste strategie rendono più facile testare gli aggiornamenti e garantire deployment lisci.
Passaggi di test degli aggiornamenti
Il testing automatizzato è essenziale per individuare problemi precoci. Utilizza gli script npm per semplificare il processo:
npm run test:update -- --channel=beta
npm run verify:deployment
npm run monitor:metrics
Il testing degli aggiornamenti in fasi attraverso canali diversi aiuta a individuare problemi prima che raggiungano tutti gli utenti. Le procedure di rollback automatizzate sono un altro sistema di sicurezza per mantenere la stabilità dell'app.
Misure di sicurezza degli aggiornamenti
La sicurezza è critica negli aggiornamenti OTA. Ecco alcune misure chiave da mettere in atto:
| Caratteristica di Sicurezza | Esecuzione | Scopo |
|---|---|---|
| Encryptazione dei Dati da Fine a Fine | Provided by Capgo | Offerto da __CAPGO_KEEP_0__ |
| Protezione contro gli attacchi di violazione dei dati | Autenticazione degli Aggiornamenti | Verifica del Pacchetto |
| Conferma che gli aggiornamenti sono autentici | Controllo degli Accessi | Permessi basati su ruoli |
“La sola soluzione con cifratura end-to-end vera, gli altri firmano solo gli aggiornamenti” - Capgo [1]
Per garantire che gli aggiornamenti siano sicuri, configurare i npm script per validare tutto prima della distribuzione:
{
"scripts": {
"predeploy": "npm run security:check",
"deploy": "capgo upload --encrypt",
"security:check": "npm audit && npm run validate:bundle"
}
}
Inoltre, applica politiche di sicurezza specifiche per canale e utilizza permessi basati su ruoli per controllare chi può distribuire gli aggiornamenti. Ciò aggiunge un ulteriore strato di protezione al tuo processo di distribuzione.
Piattaforma di Aggiornamento OTA (Over-The-Air)
Scegliere la piattaforma di aggiornamento OTA giusta è fondamentale per integrare correttamente i npm script nel tuo workflow. Priorità fattori come prestazioni, sicurezza e compatibilità con gli strumenti esistenti. Ecco una panoramica di Capgo e altre opzioni di mercato per aiutarti a prendere una decisione informata.
Capgo Caratteristiche

Capgo è progettato specificamente per gli aggiornamenti OTA Capacitor, offrendo una velocità di aggiornamento media di 434 millisecondi e raggiungendo un tasso di aggiornamento utente del 95% [1]Fornisce un'integrazione senza soluzione di continuità con i npm script, come mostrato nell'esempio seguente:
{
"scripts": {
"deploy:production": "capgo upload --channel production",
"deploy:beta": "capgo upload --channel beta --encrypt",
"rollback": "capgo revert --channel production"
}
}
Capgo garantisce aggiornamenti sicuri con crittografia end-to-end e consente deployment strategici attraverso il suo sistema di canali. Con 23,5 milioni di aggiornamenti consegnati su 750 app di produzione, ha dimostrato la sua scalabilità e affidabilità. [1].
Confronto tra piattaforme
When utilizzando npm script, è essenziale valutare le piattaforme in base all'encryptazione, alla velocità e alle integrazioni CI/CD. Ecco una rapida comparazione delle caratteristiche:
| Caratteristica | Dettagli di Implementazione | Percentuale di Successo dell'Aggiornamento |
|---|---|---|
| Encryptazione End-to-End | Supporto per l'encryptazione completa | 82% in tutto il mondo [1] |
| Velocità di Aggiornamento | 114 ms per un pacchetto di 5 MB | Consegna CDN Globale |
| Integrazione CI/CD | GitHub Azioni, GitLab CI | Flussi personalizzati |
“Pratichiamo lo sviluppo agile e @Capgo è fondamentale per consegnare continuamente ai nostri utenti!”
– Rodrigo Mantica [1]
Il mercato delle aggiornamenti OTA ha subito un cambiamento significativo, soprattutto dopo Microsoft Code Push ha chiuso nel 2024, con Appflow che è previsto seguirà nel 2026. Simon Flack ha condiviso la sua prospettiva su questi cambiamenti:
“Stiamo dando un'occhiata a @Capgo poiché Appcenter non supporta più le aggiornamenti live per le app ibride e @AppFlow è troppo costoso.” [1]
Costo è un'altra considerazione importante per i team. I piani di Capgo iniziano a 12 euro al mese e includono gli aggiornamenti OTA più circa 15 build native al mese; i minuti di build extra sono fatturati per minuto attraverso crediti. È molto più basso rispetto ai costi annuali di 6.000 dollari degli alternative a livello aziendale [1].
Quando si implementano i script di npm nel proprio flusso di lavoro di distribuzione, considerare questi fattori:
- La risposta di API per un'esecuzione script senza intoppi
- Gestione del canale per aggiornamenti mirati
- Integrazione della pipeline CI/CD per processi semplificati
- Misure di sicurezza solide per garantire la conformità
- Affidabilità per scalare senza superare il budget
Capgo's capacità di gestire configurazioni complesse di npm script mentre mantiene un alto livello di prestazioni lo rende un forte contendente per la gestione degli aggiornamenti OTA Gestione degli aggiornamenti.
Conclusioni
Voti Principali di Recensione
Utilizzando i npm script semplifica il processo di gestione degli aggiornamenti OTA Capacitor. Quando integrati nelle pipeline CI/CD, questi script aiutano a automatizzare i deployment garantendo la sicurezza e mantenendo i livelli di prestazioni.
Ecco le aree chiave di cui tener conto:
- Deploy automatico: Gestisce la versione e il deployment senza intervento manuale.
- Measure di Sicurezza: Assicura che gli aggiornamenti siano distribuiti in modo sicuro con crittografia end-to-end.
- Monitoraggio delle Prestazioni: Tien traccia delle velocità di consegna degli aggiornamenti e delle loro percentuali di successo.
Queste funzionalità evidenziano perché Capgo si distingue come strumento affidabile per la gestione degli aggiornamenti OTA.
Benefici di Capgo
Con la chiusura di Microsoft CodePush nel 2024, il panorama degli aggiornamenti OTA è cambiato. Capgo si è affermato come soluzione affidabile, avendo già consegnato 23,5 milioni di aggiornamenti su 750 app di produzione. [1].
“Pratichiamo lo sviluppo agile e @Capgo è fondamentale per consegnare continuamente ai nostri utenti!” – Rodrigo Mantica [1]
Capgo’s performance metrics parlano da sé:
| Indicatore di prestazione | Risultato |
|---|---|
| Risposta media di API | 434 ms in tutto il mondo |
| Velocità di download del pacchetto | 114 ms per 5 MB |
| Tasso di successo dell'aggiornamento | 82% a livello globale |
Iniziando da 12€ al mese con aggiornamenti OTA e circa 15 build native al mese inclusi - e i minuti aggiuntivi per i build sono fatturati per minuto attraverso crediti - Capgo offre una soluzione sicura, affidabile e a costo contenuto per la gestione degli aggiornamenti OTA e l'automazione dei build native [1].
Continua da npm Scripts per gli aggiornamenti OTA di Capacitor Explained
If sei stai utilizzando npm Script per Capacitor Aggiornamenti OTA Spiegati per pianificare la sicurezza e la conformità, connettilo con La crittografia per i dettagli di implementazione in La crittografia, La conformità per i dettagli di implementazione in La conformità, Capgo Scansionatore di sicurezza per il flusso di lavoro del prodotto in Capgo Scansionatore di sicurezza, Capgo Sicurezza per il flusso di lavoro del prodotto in Capgo Sicurezza, e Capgo Centro di fiducia per il workflow del prodotto nel Capgo Trust Center.