Configurazione della CI/CD per le App Capacitor

Vuoi rilasciare le tue app per iOS e Android in modo più veloce e senza errori? Le pipeline CI/CD per le Capacitor app automatizzano la costruzione, il testing e la distribuzione, riducendo i tempi di rilascio di fino al 70% e gli errori del 60%. Questa guida copre tutto ciò di cui hai bisogno, dalla configurazione del tuo ambiente all'automazione degli aggiornamenti in tempo reale con Esegui Capgo.

Preselezione:

• Perché CI/CD è importante per Esegui Capacitor app: Accelera i build di 78% e riduce le rifiuti di store del 60%.
• Strumenti essenziali: Xcode, Android Studio, CocoaPods, e altro.
• Configurazione della pipeline: Automatizza compiti come npx cap syncCaching delle dipendenze e costruzioni specifiche per piattaforma.
• Aggiornamenti in tempo reale con Capgo: Abilita gli aggiornamenti post-rilascio con roll-out fasi e salvaguardie di rollback.

Passaggi di configurazione veloci:

1. Prepara il tuo ambiente: Installa gli strumenti richiesti per iOS e Android.
2. Configura il tuo progetto: Aggiorna capacitor.config.ts e gestisci le variabili di ambiente in modo sicuro.
3. Pipeline di costruzione: Automatizza l'installazione delle dipendenze, la costruzione e i test per entrambe le piattaforme.
4. Ottimizza le prestazioni: Utilizza il caching, gli edifici in parallelo e i flussi di lavoro condizionali.
5. : Aggiungi aggiornamenti in tempo reale: Integra Capgo per aggiornamenti OTA sicuri con rilasci fasi.

: Con CI/CD, le app Capacitor raggiungono rilasci più veloci, più fluidi, con minimizzazione degli errori e interventi manuali. Pronto a ottimizzare il tuo workflow? Entriamo nel vivo!

: Integra le tue pipeline CI/CD esistenti con capacità mobili.

: Preparazione dell'ambiente CI/CD

: Una volta che hai affrontato le basi di CI/CD, il passo successivo è la configurazione dell'ambiente. Questo è il nucleo dell'automazione affidabile.

: Configurazione degli strumenti e del software

: Assicurati di avere questi strumenti chiave installati:

: Per lo sviluppo di iOS:

• : Xcode 14 o versione successiva
• Strumenti di Linea di Comando di Xcode
• CocoaPods per la gestione delle dipendenze

Per lo sviluppo di Android:

• Android Studio
• Android SDK 33 o superiore
• Kit di Sviluppo per Java (JDK)

Per confermare che i tuoi Strumenti di Linea di Comando di Xcode sono installati, utilizza:

xcode-select -p

Creazione di un Capacitor Progetto

La tua Capacitor progetto deve essere configurato correttamente per i flussi di lavoro CI/CD. Il capacitor.config.ts file è al cuore di questa configurazione:

const config: CapacitorConfig = {
  appId: 'com.example.app',
  webDir: 'build',
  ios: { 
    scheme: 'MyApp'
  }
}

Questo file assicura che il tuo progetto si allinei con le esigenze dei flussi di lavoro CI/CD.

Configurazione delle Variabili di Ambiente

Gestire le credenziali in modo sicuro è un aspetto fondamentale per collegare la configurazione dell'ambiente con il flusso di lavoro CI/CD.

Variabili Chiave da Definire:

• BUILD_ENV: Specifica lo stadio di distribuzione (ad esempio, production)
• IOS_SIGNING_IDENTITY: Il tuo code certificato di firma
• ANDROID_KEYSTORE_PATH: Percorso del tuo keystore Android

Per le costruzioni Android, generare dinamicamente un local.properties file durante il processo CI:

echo "sdk.dir=$ANDROID_SDK_ROOT" > android/local.properties

Quando si lavora con le costruzioni iOS, assicurati che il tuo piattaforma CI supporti gli agenti macOS.

To check if your environment is ready:

node --version | grep "v16" && xcodebuild -version | grep "Xcode 14" || exit 1

La gestione corretta delle chiavi e dei credenziali può significativamente ridurre le possibilità di rifiuti dell'app store, come evidenziato dalle statistiche precedenti [1].

Creazione della tua pipeline CI/CD

Una volta pronto il tuo ambiente, il passo successivo è la configurazione di una pipeline CI/CD per il tuo Capacitorapp. Questa pipeline dovrebbe gestire in modo efficiente sia gli asset web che le build di piattaforma nativa.

Installazione e Aggiornamento delle Dipendenze

Nelle ambientazioni CI/CD, la gestione delle dipendenze richiede un controllo di versione rigoroso. Inizia con un processo di installazione pulita:

npm install --ignore-scripts
npm install @capacitor/cli

Per accelerare i build, utilizza il caching delle dipendenze. Ad esempio gli utenti di Azure DevOps hanno visto migliorare i tempi di build del 40-60% con questo setup: Configurazione dei build per iOS e Android

- task: Cache@2
  inputs:
    key: 'npm | "$(Agent.OS)" | package-lock.json'
    path: |
      node_modules
      android/.gradle
      ios/Pods

Configurazione dei build per iOS e Android

Ecco come configurare le costruzioni per entrambe le piattaforme:

Configurazione di costruzione per iOS:

steps:
  - task: InstallAppleCertificate@2
    inputs:
      certSecureFile: 'certificate.p12'
      certPwd: $(P12_PASSWORD)
  - script: |
      xcodebuild -workspace ios/App/App.xcworkspace -scheme App -configuration Release -archivePath ios/App/App.xcarchive archive

Configurazione di costruzione per Android:

cd android
./gradlew bundleRelease

Passaggi di testing e distribuzione

Esegui test di piattaforma in parallelo utilizzando una strategia di matrice:

test:
  steps:
    - run: npm run test:unit
    - run: npm run test:e2e
    - name: Run Platform Tests
      matrix:
        platform: [ios, android]
      run: npm run test:${{ matrix.platform }}

Per la distribuzione, configurare il trattamento di artefatti specifici per piattaforma:

L'utilizzo di costruzioni parallele può ridurre significativamente il tempo di esecuzione della pipeline quando configurato correttamente.

Una volta che le tue costruzioni sono state validate e pacchettizzate, sei pronto a passare alle aggiornamenti in tempo reale con Capgo (discusso nella sezione successiva).

sbb-itb-f9944d2

Aggiungere Capgo Aggiornamenti in Tempo Reale

L'integrazione di Capgo nel tuo workflow migliora il tuo processo CI/CD consentendo aggiornamenti post-rilascio. Ecco come configurarlo:

Capgo Configurazione della Pipeline

Prima, installa il Capgo CLI nel tuo ambiente di pipeline:

steps:
  - name: Install Capgo CLI
    run: npm install -g @capgo/cli
  - name: Configure Authentication
    env:
      CAPGO_KEY: ${{ secrets.CAPGO_API_KEY }}

Questa aggiunta estende il tuo ciclo di vita CI/CD incorporando la gestione degli aggiornamenti nel tuo processo di costruzione e distribuzione automatizzata. Successivamente, includi il comando di upload dopo i passaggi di costruzione:

Per

- name: Upload Update
  run: |
    capgo upload --api-key $CAPGO_KEY --bundle ./build/app-release.apk
    capgo deploy v${VERSION} --channel production

aggiornamenti sicuri , configura le impostazioni di validazione come segue:__CAPGO_KEEP_0__ Panoramica delle funzionalità

{
  "verification": {
    "checksum": "strict",
    "certificatePinning": true,
    "updateTimeout": 500
  }
}

Capgo Features Overview

Linee Guida Aggiornamento OTA

Migliora i processi di testing tracciando questi metriche chiave dopo la distribuzione:

Strategia di Distribuzione Fase per Fase

Usa un rollout a fasi per controllare come sono distribuiti gli aggiornamenti:

- name: Staged Rollout
  run: |
    capgo deploy v1.2.3 --group "beta-users" --rollout 10%
    capgo deploy v1.2.3 --rollout 50%

Monitoraggio Aggiornamenti

Tenere d'occhio questi metriche:

• Tasso di adozione: Mirare a un 40-60% entro le prime 24 ore.
• Sessioni senza crash: Mantenere sopra il 99,5%.
• Tempo di verifica: Assicurarsi che sia inferiore a 500ms.

Se i crash superano i livelli accettabili, automatizzare un rollback:

- name: Rollback Check
  run: |
    if [ $(capgo stats --version v1.2.3 --metric crashes) -gt 2 ]; then
      capgo rollback --channel production
    fi

Miglioramento della prestazione della pipeline

Concentrandosi su tre aree chiave può portare a miglioramenti rilevabili nella tua pipeline:

Ottimizzazione della velocità di costruzione

Per le modifiche web solo, utilizzare npx cap sync può risparmiare tempo evitando ricostruzioni native complete, riducendo il tempo di ricostruzione di circa il 40%. Ecco come puoi implementare la costruzione condizionale:

- name: Build Strategy
  run: |
    [ "$WEB_ONLY" = true ] && npx cap sync || (./gradlew assembleRelease && xcodebuild ...)

Questa approccio garantisce che solo i componenti necessari vengono ricostruiti, semplificando il processo.

Automazione del Controllo delle Versioni

L'automazione del controllo delle versioni può semplificare il tuo workflow. Utilizza lo script seguente per impostare dinamicamente versione e numeri di costruzione:

- name: Set Version
  run: |
    VERSION=$(node -p "require('./package.json').version")
    BUILD_NUMBER=$GITHUB_RUN_NUMBER
    echo "APP_VERSION=${VERSION}" >> $GITHUB_ENV
    echo "BUILD_ID=${BUILD_NUMBER}" >> $GITHUB_ENV

Inoltre, la versione semantica automatizzata può essere configurata con questa impostazione:

{
  "scripts": {
    "version": "standard-version",
    "build:prod": "npm version patch && ionic build --prod"
  }
}

Queste pratiche forniscono un solido framework per tracciare e migliorare le prestazioni della pipeline attraverso metriche come:

• Tempo di costruzione per fase
• Efficienza della cache (rapporti di colpo/colpo mancato)
• Utilizzo massimo di risorse

Configurazione per Ambienti Multipli

Gestire più ambienti può essere semplificato utilizzando configurazioni specifiche per l'ambiente. Ecco un esempio di configurazione:

È possibile configurare dinamicamente gli ambienti con questo script:

- name: Configure Environment
  env:
    API_KEY: ${{ secrets.ENV_SPECIFIC_API_KEY }}
    BUNDLE_ID: ${{ parameters.bundleId }}
  run: |
    echo "ENVIRONMENT=${{ parameters.environment }}" >> $GITHUB_ENV
    echo "API_ENDPOINT=${{ parameters.apiUrl }}" >> $GITHUB_ENV

La combinazione di queste configurazioni con il canale di distribuzione di Capgo consente aggiornamenti precisi e specifici per ambiente. Ciò garantisce una distribuzione più fluida e un controllo migliore sul comportamento dell'applicazione in diversi ambienti.

Riepilogo

Ruolo del CI/CD nel Development

L'utilizzo di pipeline CI/CD per le app Capacitor aumenta significativamente l'efficienza del workflow. Secondo dati dell'industria, i team possono raggiungere 50-70% cicli di rilascio più veloci grazie a costruzioni iOS e Android simultanee [3]. Automating tasks come tali come l'installazione delle dipendenze e la sincronizzazione delle piattaforme riduce gli errori di distribuzione di 40-60% [1][2].

Ad esempio, le squadre che utilizzano i flussi di Azure DevOps hanno automatizzato processi come i passaggi di costruzione sequenziali e il packaging di Xcode. Utilizzano anche ambienti parametrizzati per lo sviluppo e la produzione. Questa approccio elimina la necessità di operazioni manuali di Gradle e Xcode CLI, garantendo la creazione di artefatti affidabili ogni volta.

Queste migliorie creano le basi per una gestione degli aggiornamenti semplificata quando viene utilizzato Capgo.

Capgo per la Gestione degli Aggiornamenti

Capgo funziona in modo trasparente con i flussi di CI/CD per fornire aggiornamenti istantanei mentre rimane conforme alle politiche degli store di app. Gli aggiornamenti vengono distribuiti solo dopo aver superato le porte di testing automatizzate integrate nel flusso.

Combinationando la costruzione automatizzata con i rilasci fasi, le squadre ottengono risultati impressionanti: 80% di copertura degli utenti entro 7 giorni e capacità di rollback in meno di un'ora.

Una strategia comune consiste nel eseguire tracce di distribuzione parallele. Le costruzioni automatizzate vengono utilizzate per i test interni, mentre i rilasci fasi si concentrano su segmenti di utenti. Ciò garantisce che gli aggiornamenti siano sia veloci che sicuri, supportati da porte di testing automatizzate rigorose [1].

Domande frequenti

Come creare un'app Capacitor?

La creazione di un'app Capacitor richiede pochi passaggi diretti:

1. Imposta il tuo ambiente: Installa Node.js e npm sul tuo sistema. Poi, utilizza l'Ionic CLI per avviare un nuovo progetto con supporto per Capacitor:

   ionic start myApp tabs --capacitor

2. Aggiungi supporto per piattaforma: Aggiungi le piattaforme che desideri raggiungere, come iOS o Android:

   npx cap add ios
   npx cap add android

3. Sincronizza il tuo web code: Assicurati che il tuo web code sia allineato con le piattaforme native eseguendo:

   npx cap sync

Lo step di sincronizzazione è cruciale per mantenere la tua app coerente across piattaforme e assicurare un funzionamento liscio nei pipeline CI/CD. Per ulteriori informazioni sull'impostazione del tuo ambiente, consulta la sezione Strumenti.

Continua da Impostazione del CI/CD per le App Capacitor

: Se stai utilizzando Impostazione del CI/CD per le App Capacitor per pianificare l'automazione del 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.