11. Opzioni di copia pagina

Copiare una riga di impostazione con i passaggi di installazione e la guida markdown completa per questo plugin.

Questa documentazione spiega come gestire i cambiamenti di versione nell'applicazione utilizzando i canali versionati. Questa approccio consente di mantenere diverse versioni dell'applicazione, garantendo che gli utenti ricevano aggiornamenti compatibili.

Scenario di esempio

Supponiamo di avere:

Versione dell'app 1.2.3 (versione vecchia) - utilizza il canale di produzione
Versione dell'app 2.0.0 (nuova versione con modifiche di compatibilità) - utilizza il canale v2
Aggiornamento in tempo reale 1.2.4 (compatibile con 1.2.3)
Aggiornamento in tempo reale 2.0.1 (compatibile con 2.0.0)

Strategia: Utilizza sempre il defaultChannel per le versioni maggiori

Approccio consigliato: Definisci un defaultChannel per ogni versione maggiore. Ciò garantisce di poter sempre inviare aggiornamenti a specifiche fasce di utenti senza dover dipendere dall'assegnazione dinamica del canale.

// Version 1.x releases
defaultChannel: 'v1'

// Version 2.x releases
defaultChannel: 'v2'

// Version 3.x releases (future)
defaultChannel: 'v3'

1. Crea un canale per la nuova versione

# Create channel for version 2.x
npx @capgo/cli channel create v2

2. Aggiorna Capacitor Config per Versione 2.0.0

Aggiorna il tuo Capacitor config prima di costruire la versione 2.0.0 per la store dell'app:

import { CapacitorConfig } from '@capacitor/cli';

const config: CapacitorConfig = {
  appId: 'com.example.app',
  appName: 'Example App',
  plugins: {
    CapacitorUpdater: {
      // ... other options
      defaultChannel: 'v2' // All 2.0.0 users will use v2 channel
    }
  }
};

export default config;

3. Gestisci rami separati Code

Creare rami Git separati per mantenere la compatibilità tra versioni dell'applicazione:

# Create and maintain a branch for version 1.x updates
git checkout -b v1-maintenance
git push origin v1-maintenance

# Your main branch continues with version 2.x development
git checkout main

Importante: Non spingere mai i pacchetti JavaScript verso vecchie app che aspettano API native code che non hanno. Costruisci sempre gli aggiornamenti dal ramo appropriato:

ramo di manutenzione v1-maintenance: Per gli aggiornamenti alle app 1.x (canale di produzione)
branch principale: Per aggiornamenti per le app 2.x (canale v2)

4. Carica i pacchetti nei canali rispettivi

# For 1.x updates: Build from v1-maintenance branch
git checkout v1-maintenance
# Make your 1.x compatible changes here
npx @capgo/cli bundle upload --channel production

# For 2.x updates: Build from main branch
git checkout main
# Make your 2.x changes here
npx @capgo/cli bundle upload --channel v2

5. Abilita l'assegnazione automatica

# Allow apps to self-assign to v2 channel
npx @capgo/cli channel set v2 --self-assign

6. Distribuisci sull'App Store

Costruisci e distribuisci la versione 2.0.0 sul negozio di app. Tutti gli utenti che scaricano questa versione (siano nuovi utenti o utenti esistenti che stanno aggiornando) utilizzeranno automaticamente il canale v2 perché è configurato nel pacchetto dell'app.

Scaling to Future Versions

Quando rilasci la versione 3.0.0 con ulteriori modifiche di rottura:

# Create channel for version 3.x
npx @capgo/cli channel create v3

// capacitor.config.ts for version 3.0.0
const config: CapacitorConfig = {
  // ...
  plugins: {
    CapacitorUpdater: {
      defaultChannel: 'v3' // Version 3.x users
    }
  }
};

Ora puoi inviare aggiornamenti a qualsiasi versione:

production canale → Utenti della versione 1.x
v2 canale → Utenti della versione 2.x
v3 canale → Utenti della versione 3.x

7. Pulizia (Dopo la migrazione)

Una volta che tutti gli utenti sono stati migrati alla versione 2.x (conteggio 3-4 mesi):

Rimuovi defaultChannel dalla tua Capacitor configurazione
Elimina il canale v2:

npx @capgo/cli channel delete v2

Elimina la branca v1-maintenance:

git branch -d v1-maintenance
git push origin --delete v1-maintenance

Testa sempre gli aggiornamenti attentamente in ogni canale prima della distribuzione

Aggiornamenti della Versione 1.x

Per inviare aggiornamenti compatibili con la versione 1.x:

Passa al ramo v1-maintenance:

git checkout v1-maintenance

Fai le tue modifiche e commit:

# Make 1.x compatible changes
git add .
git commit -m "Fix for v1.x"
git push origin v1-maintenance

Compila e carica nel canale di produzione:

npx @capgo/cli bundle upload --channel production

Continua da Breaking Changes

Se stai utilizzando Modifiche dirottanti per pianificare la routing dei canali e la distribuzione in fasi, connettilo con Canali contexto: nome del feature di canali di rilascio di Capgo. Pagina/area: pagina di marketing delle soluzioni di Capgo. Ruolo: breve etichetta di navigazione o elemento UI. Visto in: pagina solutions/white-label.astro. Chiave di messaggio `solutions_white_label_visual_cell2_value` (Solutions White Label Visual Cell2 Value). per i dettagli di implementazione in Canali, Canali contexto: nome del feature di canali di rilascio di Capgo. Pagina/area: pagina di marketing delle soluzioni di Capgo. Ruolo: breve etichetta di navigazione o elemento UI. Visto in: pagina solutions/white-label.astro. Chiave di messaggio `solutions_white_label_visual_cell2_value` (Solutions White Label Visual Cell2 Value). per i dettagli di implementazione in Canali, Soluzione di Test Beta per il flusso di lavoro del prodotto nella Soluzione di Test Beta, e Soluzione di Targeting della Versione per il flusso di lavoro del prodotto nella Soluzione di Targeting della Versione.