Saltare al contenuto principale

Etichettatura di versione nei Capacitor Applicazioni

Impara le basi dell'etichettatura di versione nelle Capacitor applicazioni, compresi i migliori metodi per gli aggiornamenti, la sincronizzazione e l'automazione.

Etichettatura di versione nelle Capacitor Applicazioni

L'etichettatura di versione è essenziale per la gestione dei Capacitor applicazioni. Assicura aggiornamenti fluidi, traccia le modifiche e migliora la affidabilità dell'applicazione su iOS, Android e piattaforme web. Ecco un breve riassunto:

  • Perché è importante: Traccia gli aggiornamenti, abilita il ripristino e assicura le distribuzioni stabili.
  • Versionamento semantico: Utilizza MAJOR.MINOR.PATCH per indicare le modifiche di rottura, le nuove funzionalità o i bug fix.
  • Sincronizzazione su piattaforme: Sincronizza i numeri di versione in package.jsoniOS Info.pliste Android build.gradle.
  • Automazione: Automate aggiornamenti con npm script e strumenti CI/CD.
  • Aggiornamenti in tempo realecontext: Pagina/Area: Sezione del problema/soluzione. Ruolo: Intestazione di sezione o pagina. Visto in: pagina premium-support.astro. Messaggio chiave `ps_help_updates_title` (Ps Aiuto Aggiornamenti Titolo). Capgo __CAPGO_KEEP_0__
  • context: Frammento di testo HTML da una stringa Capgo UI più lunga (chiave madre `submitting_a_pr_to_capgo`). Pagina/Area: Sito web di marketing Capgo. Ruolo: Frase di copertina del sito web. Visto in: pagina contributing.astro. Preservare esattamente i termini prodotto/marca e sviluppatore Capgo.inviano aggiornamenti a 95% degli utenti entro 24 ore.

Gestione Beta

: Utilizzare canali strutturati per versioni alpha, beta e di produzione. Confronto rapido Caratteristica
Versioning Semantico Racchiude le modifiche in modo chiaro 1.2.3 → 2.0.0
Sincronizza Versioni Allinea all'interno delle piattaforme npx cap sync
Automazione Semplifica gli aggiornamenti delle versioni npm version patch
Aggiornamenti in tempo reale Adozione rapida degli utenti Capgo’s 95% in 24 ore
Canali Beta Fasi di testing controllate 1.3.0-beta.1

La versioning semplifica Aggiornamenti dell'appAggiorna automaticamente i tuoi utenti, li mantiene felici e garantisce ai sviluppatori di gestire le rilasci in modo efficace.

Come configurare automaticamente il tuo Capacitor Progetto ⚡️

Capacitor Framework Documentation Website

Version Setup in Capacitor

Follow these steps to ensure consistent version management across all platforms in your Capacitor app.

Impostazione della versione in package.json

La package.json file rappresenta la fonte principale per i dettagli sulla versione dell'app. Ecco un esempio di come configurarla:

{
  "name": "your-app-name",
  "version": "1.2.3",
  "private": true,
  "dependencies": {
    "@capacitor/core": "5.5.0",
    "@capacitor/ios": "5.5.0",
    "@capacitor/android": "5.5.0"
  }
}

Quando si aggiorna il numero di versione, utilizzare le regole di versioning semantico (SemVer):

  • Versione maggiore (1.x.x): Introduce modifiche di rottura.
  • Versione minore (x.2.x): Aggiunge nuove funzionalità compatibili con il passato.
  • Versione di patch (x.x.3): Corregge bug o apporta miglioramenti minimi.

Mantenimento delle versioni delle piattaforme in sincronia

È importante allineare i numeri di versione su tutte le piattaforme per una distribuzione app di app smooth. Ogni piattaforma ha il proprio file di configurazione per la versioning:

Piattaforma File di configurazione Chiave di versione
iOS Info.plist CFBundleShortVersionString
Android build.gradle versionName
Web package.json version

Dopo l'aggiornamento della versione in package.jsonUtilizza il comando seguente per sincronizzare i cambiamenti con le configurazioni native delle piattaforme:

npx cap sync

Utilizzo Capacitor CLI per la gestione delle versioni

La Capacitor CLI offre comandi utili per gestire le versioni:

# Check the current version of Capacitor
npx cap --version

# Update Capacitor core and platform dependencies
npm install @capacitor/core@latest
npm install @capacitor/ios@latest
npm install @capacitor/android@latest

# Sync version changes to native platforms
npx cap sync

Tenere aggiornata la tua Capacitor CLI garantisce la compatibilità con le funzionalità specifiche delle versioni e riduce i potenziali disallineamenti. Seguendo questi passaggi potrai mantenere una versioning corretta nel tuo app.

Configurazione della versione semantica

Principi di versione semantica

La versione semantica (SemVer) utilizza il formato MAJOR.MINOR.PATCHdove ogni parte indica un tipo specifico di modifica:

Componente di versione Proposito
context: Pagina/Area: Sito web di marketing Capgo. Ruolo: Etichetta di navigazione o elemento UI breve. Chiave di messaggio `subprocessors_table_purpose` (Proposito della tabella dei sottoprocessori). Introduces breaking changes to the API
MINORE Aggiunge nuove funzionalità compatibili con le versioni precedenti
PATCH Corregge bug o migliora le prestazioni senza compromettere la compatibilità

Questo sistema garantisce ai sviluppatori di comunicare in modo chiaro gli aggiornamenti senza compromettere la compatibilità tra le versioni dell'app. Ad esempio, passare da 1.2.3 to 2.0.0 context

Live updates product page. Ruolo: Etichetta UI breve o elemento di navigazione. Chiave di messaggio `live_update_dynamic_label_to` (Live Update Dynamic Label To).

indica aggiornamenti maggiori e rovinanti che richiedono una pianificazione attenta.

Quando aggiornare i numeri di versione Ecco come decidere quale numero di versione aggiornare: Tipo di Aggiornamento
Aggiornamento Principale Per modifiche di base o per un completo restyling dell'interfaccia utente API 1.2.3 → 2.0.0
Aggiornamento Minore Quando si introducono nuove funzionalità o si segnalano funzionalità come obsolete 1.2.3 → 1.3.0
Aggiornamento di Patch Per correzioni di bug o piccoli miglioramenti di prestazioni 1.2.3 → 1.2.4

“Pratichiamo lo sviluppo agile e @Capgo è fondamentale per la consegna continua ai nostri utenti!” - Rodrigo Mantica [1]

Ora vediamo come automatizzare questi aggiornamenti per semplificare la gestione delle release.

Aggiornamento della Versione

L'automazione degli aggiornamenti della versione L'automazione degli aggiornamenti della versione può risparmiare tempo e ridurre gli errori nel tuo progetto Capacitor. Ecco come configurarla:

  1. Script della Versione NPM

Aggiungi questi script al tuo package.json file per gestire le aggiornamenti di versione in modo facile:

{
  "scripts": {
    "version:patch": "npm version patch",
    "version:minor": "npm version minor",
    "version:major": "npm version major"
  }
}
  1. Integrazione CI/CD
    Incorpora gli aggiornamenti di versione nel tuo flusso di lavoro CI/CD. Capgo supporta strumenti come GitHub Actions, GitLab CI, e Jenkins, rendendo semplice l'automazione del processo.

"@Capgo è uno strumento imprescindibile per i developer che cercano di aumentare la produttività evitando lunghi revisioni dei bug.", - Bessie Cooper [1]

Metodi di Etichettatura della Versione

Etichette della Versione Git

Le etichette di versione Git sono un modo affidabile per tenere traccia dei rilasci dell'app Capacitor rilasci dell'appPer creare etichette chiare e informative, combina la versione semantica con una breve descrizione:

git tag -a v1.2.3 -m "Release v1.2.3: Added offline mode support"

Per mantenere la consistenza all'interno della tua squadra, utilizza un formato di etichettatura standardizzato:

Etichetta del componente Formato Esempio
Versione di rilascio v[MAJOR].[MINOR].[PATCH] v1.2.3
Rilascio beta v[VERSION]-beta.[NUMBER] v1.2.3-beta.1
Candidato di Rilascio v[VERSION]-rc.[NUMBER] v1.2.3-rc.2

Integrazione del Numero di Costruzione

Il numero di costruzione aiuta a tracciare i singoli costruzioni all'interno di ogni versione. Per iOS e Android, incrementare il numero di costruzione con ogni invio:

{
  "ios": {
    "version": "1.2.3",
    "build": "10234"
  },
  "android": {
    "version": "1.2.3",
    "versionCode": "10234"
  }
}

Il numero di costruzione dovrebbe sempre aumentare, anche se la versione rimane la stessa. Ciò assicura che ogni invio negli store sia univocamente identificato, mantenendo la versioning chiara per gli utenti.

Gestione della Versione Beta

Gestire le versioni beta richiede un processo strutturato per distribuire i test. Capgo’s il sistema dei canali semplifica questo con i seguenti passaggi:

  1. Configurazione del Canale

Crea canali separati per ogni fase di testing:

{
  "beta": {
    "version": "1.3.0-beta.1",
    "users": "beta-testers"
  },
  "production": {
    "version": "1.2.3",
    "users": "all"
  }
}
  1. Controllo dell'accesso utente

Configura le autorizzazioni per controllare chi ha accesso alle versioni beta. Ciò assicura che solo i tester approvati ricevano le versioni beta mentre gli utenti di produzione ricevono rilasci stabili.

  1. Progressione della versione

Fase

Formato della versione Scopo Alpha
1.3.0-alpha.1 Testing interno Beta
Controllo dell'accesso utente 1.3.0-beta.1 Gruppo di test esterno
RC (Candidato alla rilascio) 1.3.0-rc.1 Ultimo test prima del rilascio
Produzione 1.3.0 Rilascio pubblico

Questa approccio garantisce test approfonditi e transizioni lente tra le fasi di sviluppo, mantenendo la gestione delle versioni organizzata e trasparente nel processo.

Visualizzazione della versione dell'app

La visualizzazione di informazioni di versione accurate nell'app è fondamentale per tenere informati gli utenti e gestire gli aggiornamenti in modo efficace.

Ottieni la versione con Capacitor

Puoi recuperare i dettagli della versione utilizzando Capacitor con questo code:

import { App } from '@capacitor/app';

async function getAppInfo() {
  const info = await App.getInfo();
  console.log(`Version: ${info.version}`);
  console.log(`Build: ${info.build}`);
}

Per un approccio più fluido, crea una funzione riutilizzabile:

export const getVersionString = async () => {
  const info = await App.getInfo();
  return `v${info.version} (${info.build})`;
};

Questa funzione semplifica il processo di visualizzazione delle informazioni sulla versione nell'interfaccia del tuo app.

Implementazione dell'interfaccia della versione

Ecco un esempio di come integrare la visualizzazione della versione in un componente di impostazioni:

@Component({
  selector: 'app-settings',
  template: `
    <div class="version-info">
      <span>Version: {{ versionString }}</span>
      <span *ngIf="updateAvailable" class="update-badge">
        Update Available
      </span>
    </div>
  `
})

Luoghi comuni per mostrare dettagli sulla versione includono:

Posizione Scopo Implementazione
Schermo delle impostazioni Versione completa e build Informazioni sulla versione dettagliate
Pagina Informazioni Visualizzazione versione base Numero di versione solo
Piede pagina dell'app Visualizzazione minima Categoria di versione condensata

Inoltre, oltre a visualizzare le informazioni sulla versione, integrare un sistema di controllo delle aggiornamenti può migliorare l'esperienza utente.

Sistema di controllo delle aggiornamenti

Un sistema di controllo delle aggiornamenti assicura agli utenti l'accesso alle ultime funzionalità e correzioni. Capgo fornisce notifiche in tempo reale e canali di aggiornamento controllati per gestire questo processo:

import { CapacitorUpdater } from '@capgo/capacitor-updater';

async function checkForUpdates() {
  const current = await CapacitorUpdater.current();
  const latest = await CapacitorUpdater.getLatest();

  if (current.version !== latest.version) {
    await CapacitorUpdater.download({
      version: latest.version
    });
  }
}

“Pratichiamo lo sviluppo agile e @Capgo è essenziale per consegnare continuamente ai nostri utenti!” - Rodrigo Mantica [1]

Puoi anche aggiungere una notifica di aggiornamento per l'utente, come questo:

@Component({
  template: `
    <update-modal 
      [version]="newVersion"
      [features]="updateFeatures"
      (updateNow)="performUpdate()"
    />
  `
})

Per le app aziendali, il sistema di canali di Capgo consente di controllare la distribuzione degli aggiornamenti:

Canale Tipo di Aggiornamento Destinatari
Produzione Versioni stabilite Tutti gli utenti
Beta Versioni pre-release Gruppo di test
Cruciale Rimedi di emergenza Utenti interessati

Questo metodo garantisce la affidabilità dell'applicazione mentre traccia le prestazioni degli aggiornamenti attraverso il dashboard di analisi di Capgo.

Soluzioni di Gestione delle Versioni

Scendiamo a fondo nelle soluzioni avanzate per la gestione delle versioni degli app efficaci.

Opzioni per gli Strumenti di Gestione delle Versioni

Scegliendo gli strumenti di controllo delle versioni, è importante concentrarsi su quelli che semplificano gli aggiornamenti, proteggono il tuo code, e supportano sia le rilasci negli store che gli aggiornamenti in tempo reale.

Ecco alcune caratteristiche chiave da cercare:

Caratteristica Importanza Impatto
Aggiornamenti in Tempo Reale Importante Minimizza i ritardi causati dalle recensioni degli store
Sicurezza Essenziale Safeguards user data and code integrity
Analisi Importante Valuta il successo degli aggiornamenti e l'adozione degli utenti
Integrazione CI/CD Utile Semplifica i processi di distribuzione
Efficienza dei costi Strategico Influenza la pianificazione a lungo termine dei budget

One standout tool in this space is Capgo, which offers features specifically designed for Capacitor app.

Capgo Version Control Features

Capgo Dashboard di Aggiornamento in Tempo Reale

Capgo offre funzionalità di gestione delle versioni robuste, tra cui:

  • 23,5 milioni di aggiornamenti riusciti consegnati
  • 95% degli utenti aggiornati entro 24 ore
  • 82% di successo globale
  • 434 ms di tempo medio di risposta di API in tutto il mondo

Ecco un esempio di come utilizzare Capgo per il controllo delle versioni:

// Capgo version control example
import { CapacitorUpdater } from '@capgo/capacitor-updater';

const versionControl = {
  async checkVersion() {
    const current = await CapacitorUpdater.current();
    return current.version;
  },

  async deployUpdate(version: string) {
    await CapacitorUpdater.setChannel({
      channel: 'production',
      version: version
    });
  }
};

“Stiamo dando un'occhiata a Capgo poiché Appcenter ha smesso di supportare gli aggiornamenti in tempo reale per le app ibride e @AppFlow è troppo costoso.” - Simon Flack [1]

Soluzioni per Dimensioni di Squadra

Capgo offre piani flessibili per soddisfare le esigenze di team di tutte le dimensioni, rendendo la gestione delle versioni scalabile ed efficiente.

Peso del Team Piano Caratteristiche Chiave
Sviluppatore Singolo Hosting cloud di base Aggiornamenti in tempo reale, 1.000 utenti attivi mensili
Team piccolo (2-5) Piano Maker 10.000 utenti attivi mensili, 500 GB di banda
Team medio (6-20) Piano Team 100.000 MAU, autorizzazioni
Azienda Personalizzazione PAYG Senza limitazioni MAU, supporto dedicato

Per le squadre più grandi, il sistema di canale di Capgo consente un controllo preciso sulla distribuzione delle versioni:

const enterpriseVersionControl = {
  channels: {
    production: 'stable-releases',
    beta: 'early-access',
    internal: 'development'
  },

  async deployToChannel(channel: string, version: string) {
    await CapacitorUpdater.setChannel({
      channel: channel,
      version: version
    });
  }
};

“Pratichiamo lo sviluppo agile e @Capgo è essenziale per consegnare continuamente ai nostri utenti!” - Rodrigo Mantica [1]

Capgo include anche un dashboard di analisi per monitorare le tassi di adozione delle versioni e rilevare potenziali problemi in anticipo. Con crittografia integrata e opzioni di hosting personalizzabili, le squadre possono mantenere la sicurezza mentre scalano i loro flussi di distribuzione.

Conclusioni

Riepilogo chiave

L'etichettatura delle versioni aiuta gli sviluppatori a mantenere aggiornamenti lisci e affidabili. Un controllo delle versioni appropriato offre vantaggi chiari:

Beneficio

Enterprise Impatto Esito
Aggiornamenti istantanei Tempi di revisione più brevi Adozione da parte degli utenti più rapida [1]
Gestione del controllo delle versioni Miglior gestione del code Tassi di successo più alti [1]
Tracciamento degli aggiornamenti Monitoraggio in tempo reale Risoluzione dei problemi più rapida [1]
Controllo della distribuzione Rilasci mirati Sostegno multi-piattaforma

Ecco i risultati che evidenziano l'importanza dell'utilizzo di strumenti di gestione delle versioni efficaci.

Come iniziare

Per mettere in pratica questi benefici, segui questi passaggi:

  • Configura la tracciatura delle versioni: Utilizza la versione semantica nel tuo package.json file e integra i plugin necessari.
  • Aggiungi controlli di aggiornamento: Implementa sistemi per verificare e tracciare gli aggiornamenti delle versioni.
  • Configura i canali di distribuzione: Crea ambienti separati per la produzione, la beta e lo sviluppo.

Infine, considera l'aggiunta di un sistema di aggiornamento in tempo reale per garantire che le distribuzioni siano sia veloci che sicure.

Continua da Version Tagging nelle Capacitor Applicazioni

Se stai utilizzando Version Tagging nelle Capacitor Applicazioni Se stai utilizzando Version Tagging nelle __CAPGO_KEEP_0__ Applicazioni per pianificare il rollback e il controllo delle versioni, connettilo con Rollbacks per i dettagli di implementazione in Rollbacks, Version Targeting per i dettagli di implementazione in Version Targeting, Comportamento dell'aggiornamento per la dettagliata implementazione nel bundle, e Aggiornamenti in tempo reale Capgo per il workflow del prodotto in Capgo Aggiornamenti in tempo reale.

Aggiornamenti in tempo reale per gli applicazioni Capacitor

Quando un bug nel layer web è attivo, invia la correzione attraverso Capgo invece di attendere giorni per l'approvazione della store. Gli utenti ricevono l'aggiornamento in background mentre le modifiche native rimangono nel normale percorso di revisione.

Sostegno umano da parte di Martin

Inizia subito

Ultimi articoli dal nostro Blog

Capgo ti offre le migliori informazioni che ti servono per creare un'app mobile davvero professionale.