Salta al contenuto principale

Guida alla configurazione CI/CD di Capacitor

Automatizza il processo di build, test e deployment della tua app Capacitor con una pipeline CI/CD per aggiornamenti più rapidi e maggiore efficienza.

Guida alla configurazione CI/CD di Capacitor

Vuoi aggiornamenti app più veloci con il minimo sforzo? Configurare una pipeline CI/CD per la tua Capacitor app automatizza build, test e deployment, risparmiando tempo e riducendo gli errori. Ecco cosa otterrai:

  • Live Update: Invia aggiornamenti istantaneamente senza i ritardi degli store. Il 95% degli utenti riceve gli update entro 24 ore.
  • Essenziali della Pipeline: Automatizza i build in base all'attività dei branch (main, staging, feature/*) e definisci ambienti separati per staging e produzione.
  • Capgo Integrazione: Usa Capgo per distribuire update sicuri e criptati, gestire i canali di updatee monitorare le performance.
  • Piani Convenienti: I piani partono da $12/mese con live updates, analytics e circa 15 Native Build/mese.

Le pipeline CI/CD di Capacitor semplificano il workflow, migliorano l'efficienza e garantiscono aggiornamenti seamless della tua app. Vediamo i dettagli.

Requisiti di configurazione

Prerequisiti

Assicurati di avere installato e configurato quanto segue:

Una volta pronti, procedi a definire i trigger e i passaggi della build all'interno della tua piattaforma CI.

Integra Appflow nella tua pipeline CI/CD

Passaggi per il setup della pipeline

Dopo aver completato i prerequisiti, è il momento di configurare i trigger e le impostazioni dell'ambiente della tua pipeline.

Trigger e passaggi della build

Configura la tua pipeline CI/CD per avviare automaticamente le build in base all'attività su branch specifici. Ecco come fare:

  • Trigger dei branch:

    • Usa main per i build di produzione.
    • Usa staging per scopi di testing.
    • Usa feature/* per lo sviluppo.
  • Step di build:

    • Installa tutte le dipendenze necessarie.
    • Esegui i unit test per garantire la qualità di code.
    • Build degli asset web per l'applicazione.
    • Genera i binari nativi per piattaforme mobile o desktop.
    • Distribuisci la build nel tuo ambiente di test per ulteriori validazioni.

Impostazioni dell'ambiente

Definisci file di configurazione separati per staging e produzione per mantenere tutto organizzato e sicuro. Ecco un esempio di setup:

# staging.env
ENVIRONMENT=staging
API_ENDPOINT=https://api-staging.example.com
LIVE_UPDATES_ENABLED=true

# production.env
ENVIRONMENT=production
API_ENDPOINT=https://api.example.com
LIVE_UPDATES_ENABLED=true

Per i dati sensibili come chiavi e certificati API, assicurati di memorizzarli in modo sicuro nel sistema di secrets management della tua piattaforma CI. Questo garantisce che la tua pipeline rimanga funzionale e sicura.

Capgo Guida all'integrazione

Capgo Live Update Interfaccia Dashboard

Una volta configurati gli stage di build e deploy, è il momento di integrare Capgo. Questo ti permette di inviare live update direttamente alla tua app, saltando i tempi di approvazione degli app store.

Passaggi per il setup di Capgo

Dopo aver preparato la tua pipeline CI/CD, segui questi passaggi per aggiungere Capgo al tuo progetto:

Per prima cosa, installa il Capgo CLI:

npx @capgo/cli init

Poi, procedi con questi comandi:

  • Build della tua app: npm install && npm run build
  • Distribuisci gli update: npx @capgo/cli deploy
  • Rollback degli update: npx @capgo/cli rollback

Ecco un esempio di un job GitHub Actions per il deployment degli update:

- name: Deploy to Capgo
  run: |
    npm install @capgo/cli
    npx @capgo/cli deploy
  env:
    CAPGO_TOKEN: ${{ secrets.CAPGO_TOKEN }}

Caratteristiche principali di Capgo

Capgo offre diversi vantaggi alle app Capacitor, tra cui:

  • Update sicuri ed efficienti: Gli update differenziali e criptati riducono il payload garantendo una consegna sicura.
  • Gestione canali: Crea canali di staging e production per controllare il rollout degli update.
  • Dashboard analytics: Monitora il tasso di successo degli update e l'adozione degli utenti con insight dettagliati.

Piani e Prezzi Capgo

Capgo offre piani flessibili per ogni esigenza:

  • SOLO: 12 $/mese (1.000 MAU, 2 GB storage, 50 GB bandwidth)
  • MAKER: 33 $/mese (10.000 MAU, 5 GB storage, 500 GB bandwidth)
  • TEAM: 83 $/mese (100.000 MAU, 10 GB storage, 2.000 GB bandwidth)
  • PAYG: A partire da 249 $/mese, con opzioni di scaling custom, accesso a API e domini personalizzati.

Attualmente, Capgo supporta oltre 1.900 app in produzione, confermandosi una scelta affidabile per il continuous deployment [1].

Gestione della Pipeline

Monitoraggio dello Stato

Monitorare costantemente la pipeline è fondamentale per mantenere la qualità dell'app e la soddisfazione degli utenti. Usa la tua piattaforma CI/CD per impostare alert automatici su:

  • Stato della build e progresso del deployment
  • Tasso di successo degli update
  • Metriche di adozione degli utenti
  • Report degli errori e crash logs

Abbina questi alert a una documentazione chiara per garantire un monitoraggio fluido e una risoluzione rapida dei problemi.

Guida alla Documentazione

Una buona documentazione tiene il team allineato e le operazioni fluide. Assicurati che la tua documentazione includa:

  • Configurazione della Pipeline: Dettagli come build triggers, variabili d'ambiente e impostazioni di sicurezza.
  • Procedure di Update: Passaggi per il deployment, istruzioni di rollback e gestione dei canali di update.
  • Configurazione del monitoraggio: Come configurare alert, monitorare le metriche e gestire i problemi.
  • Linee Guida di Compliance: Regole specifiche per piattaforma, restrizioni sugli update e altri requisiti.

Salva tutta la documentazione nel version control e aggiornala ogni volta che la pipeline cambia. Includi i passaggi di troubleshooting per gli errori comuni per risparmiare tempo in caso di problemi.

Linee Guida delle Piattaforme

Segui le policy di update di Apple e Android usando il sistema di canali di Capgo per garantire rollout fluidi e conformi:

  • Test beta: Rilascia update a piccoli gruppi di utenti per validare le modifiche.
  • Rilasci graduali: Roll out updates gradually to catch issues early.
  • Fix di Emergenza: Effettua il rollback degli aggiornamenti con un solo clic se qualcosa non va.

Riassunto

Panoramica dei passaggi di setup

Per iniziare, dovrai installare CLI, configurare build e variabili d'ambiente, mettere in sicurezza i segreti, abilitare il monitoraggio e distribuire gli aggiornamenti. Questo processo si integra perfettamente con gli strumenti di monitoraggio e rollback, garantendo che la tua app rimanga online con un downtime minimo.

Vantaggi della CI/CD

Il legame tra setup e risultati mostra come Capgo aumenti l'efficienza: gli aggiornamenti raggiungono il 95% degli utenti in sole 24 ore. Inoltre, i prezzi di Capgo partono da $12/mese, offrendo un enorme vantaggio in termini di costi rispetto ai servizi legacy che possono costare oltre $500/mese. Attualmente, Capgo supporta più di 1.900 app in produzione [1].

Continua con la Guida alla configurazione della CI/CD Pipeline di Capacitor

Se stai usando Guida alla configurazione CI/CD di Capacitor 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.

Live updates per le app Capacitor

Quando un bug nel web-layer è live, rilascia la fix tramite Capgo invece di aspettare giorni l'approvazione degli store. Gli utenti ricevono l'update in background, mentre le modifiche native restano nel normale processo di review.

Ultimi articoli dal blog

Capgo ti offre gli insight migliori che ti servono per creare un'app mobile davvero professionale.