Lompat ke konten utama

Penandaan Versi di Aplikasi Capacitor

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

Martin Donadieu

Martin Donadieu

Pengembang Konten

Pengidentifikasi Versi di Aplikasi Capacitor

Penggunaan label 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 ringkasan singkat:

  • Mengapa Ini PentingMengikuti perubahan, memungkinkan pengembalian ke versi sebelumnya, dan memastikan pengembangan stabil.
  • Pengaturan Versi SemantikGunakan MAJOR.MINOR.PATCH untuk menunjukkan perubahan besar, fitur baru, atau perbaikan bug.
  • Sinkronisasi di Berbagai Platform: Tampilkan nomor versi yang sesuai di package.json, iOS Info.plist, dan Android build.gradle.
  • Automasi: Automatisasi pembaruan dengan skrip npm dan alat CI/CD.
  • Pembaruan Langsung: Alat seperti Capgo Mengirimkan pembaruan ke 95% pengguna dalam waktu 24 jam.
  • Pengelolaan Beta: Gunakan saluran terstruktur untuk versi alpha, beta, dan produksi.

Perbandingan Cepat

FiturTujuanContoh
Penomoran Versi SemantikMengikuti perubahan dengan jelas1.2.3 → 2.0.0
Sinkronisasi VersiSesuaikan di semua platformnpx cap sync
OtomatisasiMenghemat waktu update versinpm version patch
Pembaruan LangsungPengadopsian pengguna yang cepat95% dalam 24 jam oleh Capgo
Saluran BetaFase pengujian yang dikendalikan1.3.0-beta.1

Penandaan versi memudahkan Pembaruan aplikasi, menjaga pengguna bahagia, dan memastikan pengembang dapat mengelola rilis dengan efektif.

Cara MENGATURKAN OTOMATIS konfigurasi Anda untuk Capacitor projek ⚡️

Dokumentasi Framework Capacitor

Pengaturan Versi di Capacitor

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

Mengatur Versi di package.json

The package.json File ini berfungsi sebagai sumber utama untuk detail versi aplikasi Anda. Berikut adalah contoh cara mengaturnya:

{
  "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 SemVer (SemVer):

  • Versi mayor (1.x.x): Mengenalkan perubahan yang memecah.
  • Versi minor (x.2.x): Menambahkan fitur baru yang kompatibel mundur.
  • Versi Perbaikan (x.x.3): Mengatasi bug atau membuat perbaikan kecil.

Menggunakan Versi Platform yang Sama

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

PlatformFile KonfigurasiKunci Versi
iOSInfo.plistCFBundleShortVersionString
Androidbuild.gradleNama Versi
Webfile package.jsonVersi

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

The Capacitor CLI offers helpful commands to manage versions:

# 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 yang tepat di aplikasi Anda.

Pengaturan Versi Semantik

Dasar-Dasar Versi Semantik

Versi Semantik (SemVer) menggunakan format MAJOR.MINOR.PATCH, di mana setiap bagian menunjukkan jenis perubahan tertentu:

Komponen VersiTujuan
MAJORMengenalkan perubahan yang memecah API
MINORMenambahkan fitur baru yang tetap kompatibel dengan versi sebelumnya
PATCHMengatasi bug atau meningkatkan kinerja tanpa memecahkan kompatibilitas

Sistem ini memungkinkan developer untuk berkomunikasi dengan jelas tentang update sambil menjaga kompatibilitas di antara versi aplikasi. 1.2.3 Misalnya, berpindah dari 2.0.0 perubahan besar, pembaruan yang memerlukan perencanaan yang hati-hati.

Kapan Mengupdate Nomor Versi

Berikut cara menentukan nomor versi mana yang harus diperbarui:

Tipe PerubahanKapan MenggunakanContoh Perubahan Versi
Perubahan BesarUntuk perubahan besar API atau perancangan ulang antarmuka pengguna yang signifikan1.2.3 → 2.0.0
Perubahan KecilKetika memperkenalkan fitur baru atau menandai fitur sebagai yang sudah tidak digunakan lagi1.2.3 → 1.3.0
Perubahan PatchUntuk perbaikan bug atau perbaikan kecil pada kinerja1.2.3 → 1.2.4

“Kami melaksanakan pengembangan berbasis 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 pengelolaan rilis.

Automasi Pembaruan Versi

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

  1. NPM Skrip Versi

Tambahkan skrip ini ke 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
    Tambahkan pembaruan versi ke pipeline CI/CD Anda. Capgo mendukung alat seperti GitHub Actions, GitLab CI,dan" JenkinsMembuatnya sederhana untuk mengotomatisasi proses tersebut.

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

Metode Tag Versi

Versi Git Tags

Versi Git tags adalah cara yang dapat diandalkan untuk mengikuti perubahan Rilis aplikasi CapacitorUntuk membuat tag yang jelas dan informatif, gabungkan versi semantik dengan deskripsi singkat:

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

Gunakan format penandaan standar untuk mempertahankan konsistensi di antara tim Anda:

Komponen TagFormatContoh
Versi Rilisv[MAJOR].[MINOR].[PATCH]v1.2.3
Rilis Betav[VERSION]-beta.[NUMBER]v1.2.3-beta.1
Kandidat Rilisv[VERSION]-rc.[NUMBER]v1.2.3-rc.2

Integrasi Nomor Pembangunan

Nomor pembangunan membantu mengikuti pembangunan individu dalam setiap versi. Untuk iOS dan Android, tingkatkan nomor pembangunan 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 pengajuan aplikasi toko unik diidentifikasi sementara menjaga versi yang jelas untuk pengguna.

Pengelolaan Versi Beta

Pengelolaan versi beta memerlukan proses struktural untuk mendistribusikan build uji. Capgo’s sistem kanal mengurangi hal 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

Tetapkan 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 tahapan pengembangan:

TahapFormat VersiTujuan
Alpha1.3.0-alpha.1Pengujian internal
Beta1.3.0-beta.1Kelompok pengujian eksternal
RC (Kandidat Rilis)1.3.0-rc.1Pengujian sebelum rilis
Penggunaan produksi1.3.0Rilis Publik

Menggunakan pendekatan ini memastikan pengujian yang teliti dan transisi yang lancar antara tahap pengembangan, menjaga pengaturan versi yang terorganisir dan transparan sepanjang proses.

Tampilkan Versi Aplikasi

Menampilkan informasi versi yang akurat di aplikasi Anda sangat penting untuk memastikan pengguna tetap terinformasi dan mengelola update dengan efektif.

Mendapatkan Versi dengan Capacitor

Anda dapat mengambil detail versi menggunakan Capacitor dengan menggunakan 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.

Implementasi 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 umum untuk menampilkan detail versi termasuk:

LokasiTujuanImplementasi
Layar PengaturanVersi lengkap dan pembangunanInformasi versi rinci
Halaman TentangTampilan versi dasarNomor versi saja
Footer AplikasiTampilan minimalString versi terkompakkan

Selain menampilkan informasi versi, mengintegrasikan sistem periksa update dapat meningkatkan pengalaman pengguna.

Sistem Periksa Update

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

“We practice agile development and @Capgo is mission-critical in delivering continuously to our users!” - Rodrigo Mantica [1]

Kamu juga dapat menambahkan notifikasi update pengguna, seperti ini:

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

Untuk aplikasi bisnis, Capgo's sistem saluran memungkinkan Anda mengontrol distribusi update:

SaluranJenis UpdateAudien Sasaran
ProduksiRilis stabilSemua pengguna
BetaVersi pra-rilisKelompok uji coba
Perbaikan kritisPerbaikan daruratPengguna yang terkena dampak

Metode ini memastikan keandalan aplikasi sambil melacak kinerja pembaruan melalui dashboard analitik Capgo.

Solusi Pengelolaan Versi

Mari kita telusuri lebih dalam ke solusi-solusi canggih untuk mengelola versi aplikasi dengan efektif.

Opsi Alat Pengelola Versi

Ketika memilih alat pengendalian versi, perlu diutamakan alat yang dapat memudahkan pembaruan, menjaga keamanan code, dan mendukung rilis aplikasi toko dan pembaruan langsung.

Berikut adalah fitur-fitur penting yang perlu dicari:

FiturPrioritasDampak
Pembaruan HidupKritisMengurangi keterlambatan yang disebabkan oleh tinjauan aplikasi toko
KeamananEssensialMelindungi data pengguna dan integritas code
AnalitisPentingMengukur kesuksesan pembaruan dan peningkatan pengguna
Integrasi CI/CDBermanfaatMengalirkan proses pengembangan
Efisiensi BiayaStrategisMengatur perencanaan anggaran jangka panjang

Salah satu alat yang menonjol di bidang ini adalah Capgo, yang menawarkan fitur yang dirancang khusus untuk Capacitor aplikasi.

Capgo Fitur Pengendalian Versi

Capgo Dashboard Interfase Update Langsung

Capgo menyediakan kemampuan pengelolaan versi yang kuat, termasuk:

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

Berikut adalah 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 live update untuk aplikasi hybrid dan @AppFlow terlalu mahal.” - Simon Flack [1]

Solutions untuk Ukuran Tim

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

Ukuran TimRencanaFitur Utama
Developer SoloHosting cloud dasarPembaruan langsung, 1.000 pengguna aktif bulanan
Tim kecil (2-5 orang)Rencana pembuat10.000 pengguna aktif bulanan, 500 GB bandwidth
Tim menengah (6-20 orang)Rencana tim100.000 pengguna aktif bulanan, hak akses
EnterpriseBayar per penggunaUntuk tim yang lebih besar, sistem kanal __CAPGO_KEEP_0__ memungkinkan kontrol yang tepat atas pengiriman versi:

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

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

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

Untuk tim yang lebih besar, Capgo's channel system memungkinkan kontrol yang tepat atas pengiriman versi: [1]

Capgo juga termasuk dashboard analitis untuk memantau tingkat adopsi versi dan mendeteksi potensi masalah sebelumnya. Dengan enkripsi bawaan dan opsi hosting yang dapat disesuaikan, tim dapat menjaga keamanan sambil meningkatkan alur kerja pengembangan dan pengembangan.

Kesimpulan

Mengerti tentang penanda versi adalah kunci untuk memudahkan proses pengembangan dan pengembangan. Berikut adalah ringkasan singkat dari ide utama dan langkah-langkah untuk memulai.

Poin Utama

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

ManfaatDampakHasil
Pembaruan InstanJadwal tinjauan yang lebih singkatPengadopsian pengguna yang lebih cepat [1]
Pengendalian VersiPengelolaan code yang lebih baikRasio kesuksesan yang lebih tinggi [1]
Pantauan PerbaruanPantauan waktu nyataPenyelesaian masalah yang lebih cepat [1]
Kontrol DistribusiPeluncuran yang tertargetDukungan multi-platform

Hasil ini menunjukkan pentingnya menggunakan alat pengelolaan versi yang efektif.

Cara Membuatnya

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

  • Atur pantauan versi: Gunakan versi semantik pada file dan integrasikan plugin yang diperlukan. package.json : Tambahkan cek update
  • : Implementasikan sistem untuk memverifikasi dan mengikuti pembaruan versi.: Konfigurasi saluran distribusi
  • : Buat lingkungan terpisah untuk produksi, beta, dan pengembangan.: Akhirnya, pertimbangkan menambahkan sistem update langsung untuk memastikan peluncuran yang cepat dan aman.

: Ditulis oleh

Pembaruan Langsung untuk Aplikasi Capacitor

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

Mulai Sekarang

Terbaru dari Blog Kami

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