Aggiornare la tua Capacitor app non è mai stato così semplice. Combinando gli aggiornamenti Over-The-Air (OTA) con gli script npm, puoi automatizzare i deployment, risparmiare tempo e garantire agli utenti sempre l'ultima versione, senza attendere l'approvazione degli store.
Ecco cosa imparerai:
- Come configurare gli script npm per gli aggiornamenti OTA.
- Integrazione degli update nelle pipeline CI/CD per l'automazione.
- Gestione delle versioni, della sicurezza e dei test degli update.
- Perché Capgo è una piattaforma affidabile per gestire gli update OTA.
Vantaggi principali:
- Automatizza gli update con un solo comando.
- Distribuisci gli update in sicurezza con la crittografia.
- Integra gli update in workflow come Azioni GitHub.
- Risparmia tempo con strumenti come Capgo, che eroga update in meno di 500ms.
Esempio di setup rapido:
- Installa gli strumenti:
npm install @capgo/cli --save-dev - Configura gli update in
capacitor.config.json. - Aggiungi script npm come
deploy:productionper ottimizzare il deployment.
Con piattaforme come Capgo che offrono update rapidi (95% di adozione in 24 ore) e prezzi accessibili, gestire gli update OTA non è mai stato così efficiente.
Configurazione script npm per update OTA
Ecco come configurare gli script npm per gestire gli update OTA di Capacitor in modo efficace. Questo include l'installazione dei pacchetti necessari, la configurazione e la creazione di script di deployment.
Installazione dei pacchetti richiesti
Per prima cosa, installa i pacchetti necessari. Lo strumento CLI di Capgo semplifica questo processo con comandi integrati:
npm install @capgo/cli --save-dev
npm install @capacitor/cli --save-dev
Poi, inizializza la configurazione OTA con il seguente comando:
npx @capgo/cli init
Configurazione degli OTA Updates
Aggiorna il tuo capacitor.config.json file con le seguenti impostazioni per preparare l'app agli OTA updates:
{
"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 permette all'app di scaricare gli aggiornamenti automaticamente e inviare le statistiche.
Creazione degli script di deployment
Aggiungi questi script npm al tuo package.json file per ottimizzare il processo di build e deployment:
{
"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: Build degli asset web, tipicamente usati in fase di sviluppo e deployment.build:update: Prepara il pacchetto per gli OTA updates.deploy:update: Carica il pacchetto di aggiornamento su Capgo.deploy:production: Gestisce l'intero workflow di build e deployment, ideale per i rilasci in produzione.
Configurazione delle Variabili d'Ambiente
Per completare la configurazione, definisci queste variabili d'ambiente:
CAPGO_TOKEN=your_api_token
CAPGO_APP_ID=your_app_id
Compatibilità e Affidabilità
Il Capgo CLI supporta Capacitor 8, garantendo la compatibilità con le ultime versioni e un funzionamento affidabile degli update.
| Comando dello Script | Scopo | Quando usarlo |
|---|---|---|
| build:web | Genera gli asset web | Durante lo sviluppo e il deployment |
| build:update | Prepara il pacchetto di aggiornamento | Prima di ogni aggiornamento OTA |
| deploy:update | Carica gli aggiornamenti su Capgo | Quando gli aggiornamenti sono pronti per il push |
| deploy:production | Gestisce l'intero workflow | Per i rilasci in produzione |
Aggiungere gli script npm alla CI/CD
Integrare gli script npm nella tua pipeline CI/CD può semplificare il processo di aggiornamento Over-The-Air (OTA) per le app Capacitor. Ecco una guida per configurare i deployment automatizzati in modo efficiente.
Configurazione Build 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 prestazioni ottimali, includi la cache nel tuo processo di build:
cache:
paths:
- node_modules/
- .npm/
- dist/
Azioni GitHub Setup Guide

Per automatizzare il tuo workflow di deployment, crea un .github/workflows/ota-deploy.yml file con questa configurazione:
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 }}
Questa configurazione assicura che la tua app venga deployata automaticamente ogni volta che carichi modifiche sul main branch.
Recupero e correzione aggiornamenti
Per gestire eventuali fallimenti degli aggiornamenti, includi meccanismi di recovery nella tua pipeline CI/CD. Queste funzioni aiutano a mantenere la stabilità dell'app:
| Funzione di Recovery | Implementazione | Scopo |
|---|---|---|
| Rollback della versione | npm run revert:update |
Torna all'ultima versione stabile |
| Health Check | npm run verify:update |
Verifica che l'update funzioni correttamente |
| Auto-retry | maxRetries: 3 nella config |
Tenta l'update più volte |
Puoi migliorare il tuo script di deployment per gestire gli errori automaticamente. Ad esempio:
npm run deploy:production || npm run revert:update
Questo script assicura che, in caso di fallimento del deployment, il sistema torni alla versione stabile precedente. Inoltre, la tua pipeline CI/CD può inviare report di stato e attivare notifiche tramite la tua piattaforma preferita.
Consigli per la gestione degli OTA Update
Gestire efficacemente gli OTA update richiede un controllo rigoroso del versionamento, test approfonditi e protocolli di sicurezza solidi. Ecco come ottimizzare gli update usando gli script di npm.
Gestione delle versioni
Il versionamento semantico è 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'uso di canali separati come Production, Beta, Alpha e Hotfix permette rollout mirati. Queste strategie facilitano il test degli aggiornamenti e garantiscono deployment fluidi.
Step per il testing degli aggiornamenti
I test automatizzati sono essenziali per individuare i problemi in anticipo. Usa gli script npm per semplificare il processo:
npm run test:update -- --channel=beta
npm run verify:deployment
npm run monitor:metrics
Testare gli aggiornamenti a stadi tramite diversi canali aiuta a identificare i problemi prima che raggiungano tutti gli utenti. Le procedure di rollback automatizzate sono un'ulteriore rete di sicurezza per mantenere la stabilità dell'app.
Misure di sicurezza per gli aggiornamenti
La sicurezza è critica negli aggiornamenti OTA. Ecco alcune misure chiave da implementare:
| Funzionalità di sicurezza | Implementazione | Scopo |
|---|---|---|
| Crittografia end-to-end | Fornito da Capgo | Protegge da data breach |
| Firma degli Update | Verifica del pacchetto | Conferma l'autenticità degli update |
| Controllo degli accessi | Permessi basati sui ruoli | Limita l'accesso al team |
“L'unica soluzione con vera crittografia end-to-end, le altre si limitano a firmare gli update” - Capgo [1]
Per garantire update sicuri, configura gli script npm per validare tutto prima del deployment:
{
"scripts": {
"predeploy": "npm run security:check",
"deploy": "capgo upload --encrypt",
"security:check": "npm audit && npm run validate:bundle"
}
}
Inoltre, applica policy di sicurezza specifiche per ogni channel e usa i permessi basati sui ruoli per controllare chi può distribuire gli update. Questo aggiunge un ulteriore livello di protezione al tuo processo di deployment.
Opzioni per la piattaforma OTA Update
Scegliere la giusta piattaforma per gli aggiornamenti OTA è fondamentale per integrare efficacemente gli script npm nel tuo workflow. Dai priorità a fattori come performance, sicurezza e compatibilità con i tuoi tool. Ecco un confronto tra Capgo e altre opzioni sul mercato per aiutarti a decidere.
Capgo Funzionalità

Capgo è progettato specificamente per gli aggiornamenti OTA di Capacitor, offrendo una velocità media di 434 millisecondi e un tasso di aggiornamento degli utenti del 95% [1]. Offre un'integrazione fluida con gli script npm, 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 permette deployment strategici tramite il suo sistema di channel. Con 23,5 milioni di aggiornamenti distribuiti su 750 app in produzione, ha dimostrato scalabilità e affidabilità [1].
Confronto tra le Piattaforme
Quando usi gli script npm, è essenziale valutare le piattaforme in base a crittografia, velocità e integrazioni CI/CD. Ecco un rapido confronto delle funzionalità:
| Funzionalità | Dettagli di Implementazione | Tasso di Successo Aggiornamenti |
|---|---|---|
| Crittografia end-to-end | Supporto completo alla crittografia | 82% a livello globale [1] |
| Velocità di aggiornamento | 114 ms per un bundle da 5 MB | Distribuzione tramite CDN globale |
| Integrazione CI/CD | GitHub Actions, GitLab CI | Workflow personalizzati |
“Seguiamo lo sviluppo agile e @Capgo è fondamentale per rilasciare con continuità ai nostri utenti!”
– Rodrigo Mantica [1]
Il mercato degli aggiornamenti OTA è cambiato radicalmente, specialmente dopo la chiusura di Microsoft Code Push chiuderà nel 2024, con Appflow che seguirà nel 2026. Simon Flack ha condiviso la sua opinione su questi cambiamenti:
“Stiamo provando @Capgo dato che Appcenter ha interrotto il supporto per i Live Update sulle app ibride e @AppFlow è decisamente troppo costoso.” [1]
Il costo è un altro fattore cruciale per i team. I piani di Capgo partono da $12/mese e includono gli aggiornamenti OTA più circa 15 Native Build al mese; i minuti extra vengono fatturati al minuto tramite crediti. È molto meno rispetto ai $6.000 annui delle alternative enterprise. [1].
Quando implementi gli script di npm nel tuo workflow di deployment, considera questi fattori:
- Reattività di API per un'esecuzione fluida degli script
- Gestione dei Channel per aggiornamenti mirati
- Integrazione nella pipeline CI/CD per processi ottimizzati
- Misure di sicurezza elevate per garantire la compliance
- Convenienza per scalare senza sforare il budget
La capacità di Capgo di gestire configurazioni complesse degli script npm mantenendo alte prestazioni lo rende un'opzione ideale per gli OTA gestione degli update.
Conclusione
Riepilogo dei punti chiave
L'uso degli script npm semplifica la gestione degli aggiornamenti OTA di Capacitor. Integrati nelle pipeline CI/CD, questi script aiutano ad automatizzare i deployment garantendo sicurezza e prestazioni elevate.
Ecco le aree chiave su cui concentrarsi:
- Deployment automatizzato: Gestisce versionamento e deployment senza interventi manuali.
- Misure di Sicurezza: Garantisce una distribuzione sicura degli aggiornamenti tramite crittografia end-to-end.
- Monitoraggio delle Performance: Monitora la velocità di distribuzione e i tassi di successo degli update.
Queste funzionalità spiegano perché Capgo è uno strumento affidabile per gestire gli update OTA.
Vantaggi di Capgo
Con la chiusura di Microsoft CodePush nel 2024, il panorama degli update OTA è cambiato. Capgo è emerso come soluzione affidabile, con 23,5 milioni di update consegnati su 750 app in produzione. [1].
“Seguiamo uno sviluppo agile e @Capgo è fondamentale per il rilascio continuo ai nostri utenti!” – Rodrigo Mantica [1]
Le metriche di performance di Capgo parlano da sole:
| Indicatore di Performance | Risultato |
|---|---|
| Risposta media di API | 434 ms in tutto il mondo |
| Velocità di download del bundle | 114 ms per 5 MB |
| Tasso di successo degli update | 82% a livello globale |
A partire da $12/mese con update OTA e circa 15 Native Build/mese inclusi - i minuti extra vengono fatturati al minuto tramite crediti - Capgo offre un'opzione sicura, affidabile ed economica per gestire gli update OTA e l'automazione dei Native Build [1].
Continua con: Script npm per gli update OTA di Capacitor spiegati
Se stai usando Script npm per gli update OTA di Capacitor spiegati per pianificare sicurezza e compliance, collegalo a Crittografia per i dettagli di implementazione in Encryption, Conformità per i dettagli di implementazione in Compliance, Scanner di sicurezza Capgo per il workflow di Capgo Security Scanner, Sicurezza Capgo per il workflow di Capgo Security, e Trust Center di Capgo per il workflow di Capgo Trust Center.