Pindah ke konten utama

Penandaan Versi di Aplikasi Capacitor

Belajar dasar-dasar penandaan versi di aplikasi Capacitor, termasuk praktik terbaik untuk pembaruan, sinkronisasi, dan otomatisasi.

Penggunaan Penandaan Versi di Aplikasi Capacitor

Penggunaan penandaan versi sangat penting untuk mengelola Capacitor Aplikasi. Ini memastikan pembaruan yang lancar, mengikuti perubahan, dan meningkatkan keandalan aplikasi di platform iOS, Android, dan web. Berikut adalah gambaran singkat:

  • Mengapa Ini PentingMengikuti perubahan, memungkinkan pengembalian ke versi sebelumnya, dan memastikan peluncuran stabil.
  • Penggunaan Versi Semantik: Gunakan MAJOR.MINOR.PATCH untuk menunjukkan perubahan yang mengganggu, fitur baru, atau perbaikan bug.
  • Sinkronisasi di Seluruh Platform: Saling sesuaikan nomor versi di package.jsoniOS Info.plistdan Android build.gradle.
  • Automasi: Mengaktifkan Perbaruan Otomatis dengan skrip npm dan alat CI/CD.
  • Pembaruan Langsung: Alat seperti Capgo mengirimkan pembaruan ke 95% pengguna dalam waktu 24 jam.
  • Manajemen Beta: Gunakan saluran terstruktur untuk versi alpha, beta, dan produksi.

Perbandingan Cepat

Fungsi Tujuan Example
Penggunaan Versi Semantik Pengaturan Versi Semantik 1.2.3 → 2.0.0
Mengikuti perubahan dengan jelas Sinkronisasi Versi npx cap sync
Automation Mempercepat pembaruan versi npm version patch
Pembaruan Langsung Perbarui versi dengan cepat Capgo’s 95% in 24 hours
95% dalam 24 jam Fase pengujian terkendali 1.3.0-beta.1

Fase pengujian yang terkendali perbarui aplikasiMenggunakan tag versi memastikan pengguna bahagia, dan memungkinkan pengembang mengelola rilis dengan efektif.

Bagaimana cara MENGONFIGURASI OTOMATIS aplikasi Anda Capacitor project ⚡️

Capacitor Dokumentasi Framework Website

Konfigurasi Versi di Capacitor

Ikuti langkah-langkah ini untuk memastikan manajemen versi yang konsisten di semua platform di aplikasi Capacitor Anda.

Pengaturan Versi di package.json

The package.json Berikut adalah file yang berfungsi sebagai sumber utama untuk detail versi aplikasi Anda. Berikut adalah contoh cara mengatur halaman ini:

{
  "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"
  }
}

Ketika mengupdate nomor versi, gunakan aturan versi semantik (SemVer):

  • Versi Utama (1.x.x): Mengenalkan perubahan besar.
  • Versi kecil (x.2.x): Menambahkan fitur-fitur baru yang kompatibel dengan versi sebelumnya.
  • Versi Patch (x.x.3): Mengatasi bug atau membuat perbaikan kecil.

Menjaga Versi Platform Sama

Penting untuk menyamakan nomor versi di semua platform untuk pengembangan aplikasi yang lancar. Setiap platform memiliki file konfigurasi sendiri untuk versi:

Platform File Konfigurasi Kunci Versi
iOS Info.plist CFBundleShortVersionString
Andoid build.gradle Versi Nama
Web file package.json Versi

Setelah mengupdate versi di package.json, gunakan perintah ini untuk sinkronisasi perubahan dengan konfigurasi platform native:

npx cap sync

Menggunakan Capacitor CLI untuk Pengelolaan Versi

Capacitor CLI menawarkan perintah bermanfaat untuk mengelola versi:

# 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

Mengupdate Capacitor CLI Anda memastikan konsistensi dengan fitur versi tertentu dan mengurangi potensi kesalahan. Dengan mengikuti langkah-langkah ini, Anda dapat menjaga versi aplikasi Anda dengan benar.

Pengaturan Versi Semantik

Dasar-Dasar Versi Semantik

Versi Semantik (SemVer) Menggunakan format MENJADI.MINOR.PATCHdi mana setiap bagian menunjukkan jenis perubahan tertentu:

Komponen Versi Tujuan
MAJOR Mengenalkan perubahan besar pada API
MINOR Menambahkan fitur-fitur baru yang masih kompatibel dengan versi sebelumnya
PATCH Mengatasi masalah atau meningkatkan kinerja tanpa mengganggu konsistensi kompatibilitas

Sistem ini memungkinkan para pengembang untuk menyampaikan perubahan dengan jelas sambil menjaga konsistensi versi aplikasi. Misalnya, beralih dari 1.2.3 ke 2.0.0 mengirimkan peringatan besar yang memerlukan perencanaan yang hati-hati.

Kapan Mengupdate Nomor Versi

Berikut cara menentukan nomor versi mana yang harus diperbarui:

Jenis Update Kapan Menggunakan Contoh Perubahan Versi
Pembaruan Besar For breaking API changes or major UI redesigns 1.2.3 → 2.0.0
Pembaruan Kecil Ketika memperkenalkan fitur baru atau menandai fitur sebagai deprecated 1.2.3 → 1.3.0
Pembaruan Patch Untuk memperbaiki bug atau perbaikan kecil pada kinerja 1.2.3 → 1.2.4

“Kami menerapkan pengembangan agile dan @Capgo sangat kritis dalam menyampaikan secara terus-menerus kepada pengguna kami!” - Rodrigo Mantica [1]

Sekarang mari kita lihat bagaimana mengotomatisasi pembaruan ini untuk memudahkan manajemen rilis.

Pembaruan Versi Otomatis

Mengotomatisasi pembaruan versi dapat menghemat waktu dan mengurangi kesalahan dalam proyek Capacitor Anda. Berikut cara mengaturinya:

  1. NPM Skrip Versi

Tambahkan skrip ini ke aplikasi Anda package.json file untuk mengelola pembaruan versi dengan mudah:

{
  "scripts": {
    "version:patch": "npm version patch",
    "version:minor": "npm version minor",
    "version:major": "npm version major"
  }
}
  1. Integrasi CI/CD
    Integrasi pembaruan versi ke dalam pipeline CI/CD Anda. Capgo mendukung alat seperti GitHub Actions, GitLab CI, dan Jenkins, sehingga membuatnya mudah untuk mengotomatisasi proses.

"@Capgo adalah alat wajib bagi para pengembang yang mencari produktivitas dengan menghindari ulasan bugfix yang panjang." - Bessie Cooper [1]

Methode Tag Versi

Tag Versi Git

Tag versi Git adalah cara yang dapat diandalkan untuk menjaga track terhadap Capacitor rilis aplikasi. Untuk membuat tag yang jelas dan informatif, kombinasikan penggunaan versi semantik dengan deskripsi singkat:

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

Menggunakan format penandaan yang baku akan membantu Anda menjaga konsistensi di antara tim Anda:

Tag Komponen Format Contoh
Versi Rilis v[Major].[Minor].[Patch] v1.2.3
Versi Beta v[VERSION]-beta.[NUMBER] v1.2.3-beta.1
Kandidat Rilis v[VERSION]-rc.[NUMBER] v1.2.3-rc.2

Pengintegrasian Nomor Pembangunan

Nomor build membantu mengikuti build individu dalam setiap versi. Untuk iOS dan Android, tingkatkan nomor build dengan setiap pengiriman:

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

Nomor build harus selalu meningkat, bahkan jika versi tetap sama. Hal ini memastikan setiap pengiriman aplikasi toko unik diidentifikasi sementara menjaga versi yang jelas untuk pengguna.

Pengelolaan Versi Beta

Pengelolaan versi beta memerlukan proses struktural untuk mendistribusikan build uji. Sistem Capgo’s sistem saluran sederhana proses ini dengan langkah-langkah berikut:

  1. Pengaturan Saluran

Buat saluran terpisah untuk setiap fase pengujian:

{
  "beta": {
    "version": "1.3.0-beta.1",
    "users": "beta-testers"
  },
  "production": {
    "version": "1.2.3",
    "users": "all"
  }
}
  1. Pengaturan Akses Pengguna

Atur izin untuk mengontrol siapa yang mendapatkan akses ke versi beta. Hal ini memastikan hanya tester yang disetujui yang menerima build beta sementara pengguna produksi mendapatkan rilis stabil.

  1. Progresi Versi

Gunakan sistem progresi versi yang jelas untuk mengikuti tahap pengembangan:

Stadium Format Versi Tujuan
Alpha 1.3.0-alpha.1 Pengujian Internal
Beta 1.3.0-beta.1 Pengujian Kelompok Eksternal
RC (Kandidat Rilis) 1.3.0-rc.1 Pengujian Akhir Sebelum Rilis
Produksi 1.3.0 Rilis publik

Ini cara memastikan pengujian yang teliti dan transisi yang lancar antara tahap pengembangan, menjaga pengaturan versi yang terorganisir dan transparan sepanjang proses.

Pengaturan Versi Aplikasi

Menampilkan informasi versi yang akurat di aplikasi Anda adalah kunci untuk memastikan pengguna Anda terinformasi dan mengelola pembaruan dengan efektif.

Mendapatkan Versi dengan Capacitor

Anda dapat mengambil detail versi menggunakan Capacitor dengan cara ini code:

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

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

Untuk pendekatan yang lebih terstruktur, buatlah fungsi yang dapat digunakan kembali:

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

Fungsi ini memudahkan proses menampilkan informasi versi di antarmuka aplikasi Anda.

Pengimplementasian UI Versi

Berikut adalah contoh cara mengintegrasikan tampilan versi ke dalam komponen pengaturan:

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

Tempat-tempat umum untuk menampilkan detail versi termasuk:

Lokasi Purpose Implementation
Implementasi Panel Pengaturan Versi Penuh dan Build
Versi Rinci Tentang Halaman Penggunaan Versi Dasar
Nomor Versi Footer Aplikasi Penggunaan Minimal

Ini adalah tambahan untuk menampilkan informasi versi, mengintegrasikan sistem cek update dapat meningkatkan pengalaman pengguna.

Sistem Cek Update

Sistem cek update memastikan pengguna memiliki akses ke fitur dan perbaikan terbaru. Capgo menyediakan notifikasi waktu nyata dan saluran update yang dikendalikan untuk mengelola proses ini:

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
    });
  }
}

“Kami berlatih pengembangan agile dan @Capgo sangat kritis dalam menyampaikan secara terus-menerus kepada pengguna kami!” - Rodrigo Mantica [1]

Pengguna juga dapat menambahkan notifikasi update pengguna, seperti ini:

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

Untuk aplikasi perusahaan, Capgo memungkinkan Anda mengontrol distribusi update:

Saluran Jenis Update Audien Sasaran
Produksi Rilis stabil Pengguna semua
Versi Beta Versi Pra-Rilis Kelompok Uji Coba
Kritis Pembaruan Darurat Pengguna yang Terkena Dampak

Menggunakan metode ini memastikan keandalan aplikasi sambil mengikuti kinerja pembaruan melalui dashboard analitik Capgo.

Paket Pengelolaan Versi

Mari kita telusuri lebih dalam tentang solusi canggih untuk mengelola versi aplikasi secara efektif.

Pilihan Alat Pengelola Versi

Ketika memilih alat pengelola versi, penting untuk memprioritaskan alat yang dapat memudahkan pembaruan, menjaga keamanan code, dan mendukung baik rilis aplikasi di toko maupun pembaruan langsung.

Berikut beberapa fitur yang perlu Anda cari:

Fitur Kepentingan Pengaruh
Pembaruan Hidup Kritis Mengurangi keterlambatan yang disebabkan oleh ulasan aplikasi toko
Keamanan Essensial Mengamankan data pengguna dan integritas code
Pengukuran Penting Mengukur kesuksesan pembaruan dan pengadopsian pengguna
Integrasi CI/CD Berharga Mengalirkan proses pengiriman
Effisiensi Biaya Strategis Mempengaruhi perencanaan anggaran jangka panjang

Satu alat yang menonjol di ruang ini adalah Capgo, yang menawarkan fitur yang dirancang khusus untuk Capacitor aplikasi.

Capgo Fitur Pengendalian Versi

Capgo Live Update Interface Dashboard

Capgo menyediakan kemampuan pengelolaan versi yang kuat, termasuk:

  • 23,5 juta pembaruan sukses disampaikan
  • 95% pengguna diperbarui dalam 24 jam
  • 82% tingkat kesuksesan global
  • 434ms waktu respons rata-rata API di seluruh dunia

Berikut contoh cara menggunakan Capgo untuk pengendalian versi:

// 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
    });
  }
};

“Saat ini kami mencoba menggunakan @Capgo karena Appcenter telah menghentikan dukungan pembaruan hidup untuk aplikasi hybrid dan @AppFlow terlalu mahal.” - Simon Flack [1]

Jumlah Anggota Tim

Capgo menawarkan rencana fleksibel untuk menyesuaikan tim berbagai ukuran, membuat pengelolaan versi skalabel dan efisien.

Jumlah Anggota Rencana Fitur Utama
Tim Pengembang Solo Hosting Cloud Dasar Update Hidup, 1.000 Pengguna Aktif
Tim Kecil (2-5) Rencana Membuat 10.000 Pengguna Aktif, 500GB Bandwidth
Tim Menengah (6-20) Rencana Tim 100.000 Pengguna Aktif, Izin
Pelayanan Bisnis Custom PAYG Tanpa Batas Pengguna Aktif, Dukungan Khusus

Untuk tim yang lebih besar, sistem saluran Capgo memungkinkan kontrol yang tepat atas pengiriman versi:

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

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

“Kami menerapkan pengembangan agile dan @Capgo sangat kritis dalam menyampaikan secara terus-menerus kepada pengguna kami!” - Rodrigo Mantica [1]

Capgo juga mencakup dashboard analitis untuk memantau tingkat penyebaran versi dan mendeteksi potensi masalah sejak awal. Dengan enkripsi bawaan dan pilihan hosting yang dapat disesuaikan, tim dapat menjaga keamanan sambil meningkatkan alur kerja pengembangan.

Kesimpulan

Pemahaman tentang penanda versi sangat penting untuk memudahkan proses pengembangan dan pengembangan. Berikut adalah ringkasan singkat dari ide utama dan langkah-langkah untuk memulai.

Kunci Pemahaman

Penanda versi membantu pengembang menjaga pembaruan yang halus dan dapat diandalkan. Pengendalian versi yang tepat menawarkan keuntungan yang jelas:

Manfaat Dampak Hasil
Pembaruan Instan Jadwal tinjauan yang lebih singkat Penyebaran pengguna yang lebih cepat [1]
Pengendalian Versi Pengelolaan code yang lebih baik Kesempatan sukses yang lebih tinggi [1]
Pengawasan Update Pengawasan waktu nyata Pemecahan masalah yang lebih cepat [1]
Pengendalian Distribusi Peluncuran yang tertarget Dukungan multi-platform

Hasil ini menunjukkan pentingnya menggunakan alat pengelolaan versi yang efektif.

Bagaimana Membuatnya

Untuk menerapkan manfaat-manfaat ini, ikuti langkah-langkah berikut:

  • Konfigurasi pengaturan versiGunakan versi semantik dalam aplikasi Anda package.json Tambahkan pengecekan update
  • Periksa PerbaruiImplementasikan sistem untuk memverifikasi dan mengikuti pembaruan versi.
  • Konfigurasi saluran distribusiBuat lingkungan terpisah untuk produksi, beta, dan pengembangan.

Terakhir, pertimbangkan untuk menambahkan sistem live update untuk memastikan pengiriman yang cepat dan aman.

Teruskan dari Tag Versi di Aplikasi Capacitor

Pengaturan Versi di Aplikasi __CAPGO_KEEP_0__ Pengtagan Versi di Aplikasi Capacitor hubungkan untuk mengatur ulang dan pengendalian versi Rollbacks untuk detail implementasi di Rollbacks, Target Versi untuk detail implementasi dalam Target Versi Perilaku Perbarui untuk detail implementasi di Pengaturan Perbarui. bundle untuk detail implementasi di bundle, dan Capgo Pembaruan Hidup untuk alur kerja produk dalam Capgo Live Updates.

Update Langsung untuk Aplikasi Capacitor

Ketika bug layer web masih hidup, kirimkan perbaikan melalui Capgo daripada menunggu hari-hari untuk persetujuan toko aplikasi. Pengguna mendapatkan update di latar belakang sementara perubahan native tetap dalam jalur review normal.

Terbaru dari Blog Kami

Capgo memberikan Anda wawasan terbaik yang Anda butuhkan untuk membuat aplikasi mobile profesional yang sebenarnya.