Versione Tagging nei __CAPGO_KEEP_0__ App Capacitor applicazioni. Assicura aggiornamenti fluidi, traccia le modifiche e migliora la affidabilità dell'applicazione su piattaforme iOS, Android e web. Ecco un breve riassunto:
- Perché contaRileva aggiornamenti, abilita il ripristino e garantisce le distribuzioni stabili.
- Versioning Semantico: Use MAJOR.MINORE.PATCH a indicare cambiamenti di versione, nuove funzionalità o correzioni di bug.
- Sincronizza Across Piattaforme: Allineare i numeri di versione in
package.jsoniOSInfo.plist, and Androidbuild.gradle. - Automation: Automatizzare gli aggiornamenti con npm script e strumenti CI/CD.
- Aggiornamenti in Tempo Reale: Strumenti come Capgo conseguire aggiornamenti a 95% degli utenti entro 24 ore.
- Amministrazione Beta: Utilizza canali strutturati per versioni alpha, beta e di produzione.
Confronto rapido
| Caratteristica | Scopo | Example |
|---|---|---|
| Versioning Semantico | Versionamento Semantico | 1.2.3 → 2.0.0 |
| Versioni Sincronizzate | Sincronizza versioni | npx cap sync |
| Automation | Accelerano le aggiornamenti delle versioni | npm version patch |
| Aggiornamenti in tempo reale | Aggiornamenti veloci dell'utente | Capgo’s 95% in 24 ore |
| Canali di beta | Fasi di testing controllate | 1.3.0-beta.1 |
La gestione delle versioni semplifica app updatesMantiene gli utenti felici e consente ai developer di gestire le rilasci in modo efficace.
Come configurare automaticamente il tuo Capacitor Progetto ⚡️

Configurazione della Versione in Capacitor
Segui questi passaggi per garantire una gestione della versione coerente su tutte le piattaforme nel tuo app Capacitor.
Impostazione della Versione in package.json
Il package.json file rappresenta la fonte principale per i dettagli sulla versione del tuo app. Ecco un esempio di come impostarlo:
{
"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, utilizza le regole di versioning semantico (SemVer):
- Versione maggiore (1.x.x): Introduce modifiche dirompenti.
- Versione minore (x.2.x): Aggiunge nuove funzionalità compatibili con il passato.
- Versione di patch (x.x.3): Risolve bug o apporta miglioramenti minimi.
Mantienere le Versioni del Platform in Sincronia
È importante sincronizzare i numeri di versione su tutti i piattaforme per una corretta distribuzione dell'applicazione. 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 | nomeVersione |
| Web | package.json | versione |
Dopo l'aggiornamento della versione in package.json, utilizza questo comando per sincronizzare i cambiamenti con le configurazioni delle piattaforme native:
npx cap sync
Utilizza Capacitor CLI per la gestione della versione
La Capacitor CLI offre comandi utili per la gestione delle 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 della versione e riduce i potenziali disallineamenti. Seguendo questi passaggi, potrai mantenere una versioning corretta nel tuo app.
Configurazione della Versione Semantica
Principi di Versione Semantica
Versionamento Semantico (SemVer) utilizza il formato MAJOR.MINORE.PATCHdove ogni parte indica un tipo specifico di modifica:
| Componente di Versione | Scopo |
|---|---|
| MAJOR | Introduce modifiche di rottura nel API |
| MINOR | Aggiunge nuove funzionalità compatibili con le versioni precedenti |
| PATCH | Correzioni di bug o miglioramenti della prestazione senza compromettere la compatibilità |
Questo sistema consente ai developer di comunicare in modo chiaro gli aggiornamenti, mantenendo la compatibilità tra le diverse versioni dell'app. Ad esempio, passando da 1.2.3 a 2.0.0 aggiornamenti significativi che richiedono una pianificazione attenta
Quando aggiornare i numeri di versione
Ecco come decidere quale numero di versione aggiornare:
| Update Type | Quando utilizzare | Esempio di Modifica della Versione |
|---|---|---|
| Aggiornamento Principale | For breaking API changes or major UI redesigns | 1.2.3 → 2.0.0 |
| Aggiornamento Minore | Quando si introduce nuove funzionalità o si segnala 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 è essenziale per consegnare continuamente ai nostri utenti!” - Rodrigo Mantica [1]
Ora vediamo come automatizzare queste aggiornamenti per semplificare la gestione delle versioni.
Automazione dell'aggiornamento della versione
L'automazione degli aggiornamenti della versione può risparmiare tempo e ridurre gli errori nel tuo progetto Capacitor. Ecco come configurarlo:
- Script della versione NPM
Aggiungi questi script al tuo package.json file per gestire aggiornamenti di versione facilmente:
{
"scripts": {
"version:patch": "npm version patch",
"version:minor": "npm version minor",
"version:major": "npm version major"
}
}
- Integrazione CI/CD
Incorporare aggiornamenti di versione nella tua pipeline 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 produttività evitando lunghi revisioni di bug.” - Bessie Cooper [1]
Metodi di Etichettatura della Versione
Etichette della Versione Git
Le etichette della versione Git sono un modo affidabile per tenere traccia dei Capacitor rilasci dell'app. Per 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 |
| Versione Beta | v[VERSION]-beta.[NUMBER] | v1.2.3-beta.1 |
| Candidato alla Versione di Rilascio | v[VERSION]-rc.[NUMBER] | v1.2.3-rc.2 |
Integrazione del Numero di Costruzione
Numeri di build aiutano a tracciare i singoli build all'interno di ogni versione. Per iOS e Android, incrementa il numero di build 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 mentre si mantiene la versioning chiaro per gli utenti.
Gestione della Versione Beta
Gestire le versioni beta richiede un processo strutturato per distribuire i test. Capgo's il sistema di canale semplifica questo con i seguenti passaggi:
- Configurazione del Canale
Creare canali separati per ogni fase di testing:
{
"beta": {
"version": "1.3.0-beta.1",
"users": "beta-testers"
},
"production": {
"version": "1.2.3",
"users": "all"
}
}
- Controllo dell'accesso degli utenti
Configurare le autorizzazioni per controllare chi ottiene accesso alle versioni beta. Ciò assicura che solo i tester approvati ricevano le versioni beta mentre gli utenti di produzione ricevono rilasci stabili.
- Progressione della Versione
Usare un sistema di progressione della versione chiaro per tracciare le fasi di sviluppo:
| Fase | Formato della versione | Scopo |
|---|---|---|
| Fase alpha | 1.3.0-alpha.1 | Test interni |
| Fase beta | 1.3.0-beta.1 | Gruppo di test esterno |
| RC (Candidato alla rilascio) | 1.3.0-rc.1 | Test finale prima del rilascio |
| Produzione | 1.3.0 | Rilascio pubblico |
Questa approccio garantisce test approfonditi e transizioni liscie tra le fasi di sviluppo, mantenendo la tracciatura delle versioni organizzata e trasparente durante tutto il processo.
Visualizzazione della Versione dell'App
Mostrare informazioni di versione accurate nell'app è fondamentale per tenere informati gli utenti e gestire gli aggiornamenti in modo efficace.
Ottenimento della Versione con Capacitor
È possibile recuperare dettagli di 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 di versione nell'interfaccia dell'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>
`
})
I posti comuni per mostrare dettagli di versione includono:
| Posizione | Scopo | Implementazione |
|---|---|---|
| Pannello di configurazione | Versione completa e build | Informazioni sulla versione dettagliate |
| About Page | Visualizzazione di base della versione | Numero di versione solo |
| Piede della App | Visualizzazione minima | 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 che gli utenti abbiano 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 visibile dall'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 | context | Pubblico di riferimento |
|---|---|---|
| Production | Destinatari | Produzione |
| Beta | Versioni di anteprima | Gruppo di test |
| Priorità critica | Risoluzione 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 dell'applicazione.
Opzioni del Tool di Versione
Scegliendo gli strumenti di controllo delle versioni, è importante concentrarsi su quelli che semplificano gli aggiornamenti, proteggono il tuo code e supportano sia le rilasci delle app store che gli aggiornamenti in tempo reale.
Ecco alcune caratteristiche chiave da cercare:
| Caratteristica | Importanza | Impatto |
|---|---|---|
| Aggiornamenti in tempo reale | Cruciale | Minimizza i ritardi causati dalle recensioni dell'app store |
| Sicurezza | Essenziale | Garantisce l'integrità dei dati degli utenti e code |
| Analisi | Importante | Measures update success and user adoption |
| Integrazione CI/CD | Utile | Semplifica i processi di distribuzione |
| Efficienza di costo | Strategico | Influenza la pianificazione a lungo termine del budget |
Un'importante risorsa in questo settore è Capgo, che offre funzionalità specificamente progettate per Capacitor applicazioni.
Capgo Caratteristiche di controllo delle versioni

Capgo offre capacità di gestione delle versioni robuste, comprese:
- 23,5 milioni di aggiornamenti riusciti consegnati
- 95% degli utenti aggiornati entro 24 ore
- 82% di successo globale
- 434ms average API response time worldwide
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 live per le app ibride e @AppFlow è troppo costoso.” - Simon Flack [1]
Soluzioni per l'equipe
Capgo offre piani flessibili per accogliere squadre di tutte le dimensioni, rendendo la gestione delle versioni scalabile ed efficiente.
| Team Size | Piano | Caratteristiche principali |
|---|---|---|
| Caratteristiche chiave | Hosting cloud di base | Aggiornamenti in tempo reale, 1.000 MAU |
| Piccola squadra (2-5) | Piano Maker | 10.000 MAU, 500 GB di banda |
| Squadra media (6-20) | Piano di squadra | 100.000 MAU, autorizzazioni |
| Azienda | Pagamento a consumo | Supporto dedicato illimitato, MAU illimitati |
Per squadre più grandi, il sistema di canali 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 è fondamentale 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, gli squadre possono mantenere la sicurezza mentre scalano i loro flussi di lavoro di distribuzione.
Conclusioni
Capire la versione è fondamentale per semplificare i processi di sviluppo e di distribuzione. Ecco un rapido riassunto delle idee e dei passaggi principali per iniziare.
Prese di posizione chiave
Il versionamento aiuta gli sviluppatori a mantenere aggiornamenti fluidi e affidabili. Un controllo delle versioni corretto offre vantaggi chiari:
| Beneficio | Impatto | Esito |
|---|---|---|
| Aggiornamenti istantanei | Tempi di revisione più brevi | Adozione degli utenti più veloce [1] |
| Controllo delle versioni | Una gestione code più efficiente | Risultati di successo più alti [1] |
| Tracciamento degli aggiornamenti | Monitoraggio in tempo reale | Risoluzione dei problemi più veloce [1] |
| Controllo della distribuzione | Esecuzione di rilasci mirati | Sostegno a più piattaforme |
Il controllo delle versioni efficace è fondamentale per ottenere questi risultati.
Come iniziare
Per mettere in pratica questi benefici, segui questi passaggi:
- Configura la tracciatura delle versioni: Utilizza la versione semantica nei tuoi
package.jsonfile e integra i plugin necessari. - Aggiungi controlli di aggiornamento: Crea ambienti separati per la produzione, beta e sviluppo.
- Configura canali di distribuzione: Continua da qui Version Tagging in __CAPGO_KEEP_0__ Apps
Infine, considera l'aggiunta di un sistema live update per garantire che le distribuzioni siano sia veloci che sicure.
Continua con la versione etichettatura nei Capacitor Applicazioni
Se stai utilizzando Version Tagging in Capacitor Apps Implementa sistemi per verificare e tracciare gli aggiornamenti delle versioni Ripristini per il dettaglio di implementazione in Ripristini, Targetizzazione della Versione per i dettagli di implementazione nella versione Targeting. Comportamento di Aggiornamento per il dettaglio di implementazione nella gestione dell'aggiornamento. bundle per i dettagli di implementazione nel bundle, e Capgo Live Updates Capgo Aggiornamenti in Tempo Reale