Lompat ke konten utama

Penggunaan Tanda Versi di Aplikasi Capacitor

Pelajari dasar-dasar penggunaan tanda versi di aplikasi Capacitor , termasuk praktik terbaik untuk perbarui, sinkronisasi, dan otomatisasi.

Martin Donadieu

Martin Donadieu

Pemasar Konten

Penggunaan Tanda Versi di Aplikasi Capacitor

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

  • Mengapa Ini PentingMengikuti pembaruan, memungkinkan pengembalian, dan memastikan pengembangan stabil.
  • Pengendalian Versi Semantik: Gunakan MAJOR.MINOR.PATCH untuk menunjukkan perubahan yang mengganggu, fitur baru, atau perbaikan bug.
  • Sinkronisasi di Berbagai Platform: Sama-kan nomor versi di package.json, iOS Info.plist, dan Android build.gradle.
  • Automasi: Mengautomasi pembaruan dengan skrip npm dan alat CI/CD.
  • Live Updates: 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

FiturTujuanContoh
Pengaturan Versi SemantikMengikuti perubahan dengan jelas1.2.3 → 2.0.0
Versi SinkronSinkronisasi di berbagai platformnpx cap sync
AutomasiMenghemat waktu untuk memperbarui versinpm version patch
Pembaruan LangsungPengadopsian pengguna yang cepatCapgo mencapai 95% dalam 24 jam
Saluran BetaFase pengujian yang terkendali1.3.0-beta.1

Penggunaan label versi memudahkan Pembaruan aplikasi, membuat pengguna bahagia, dan memastikan pengembang dapat mengelola rilis dengan efektif.__CAPGO_KEEP_0__

Cara MENGATURULAH AUTOMATIS konfigurasi Anda Capacitor projek Anda ⚡️

Capacitor Dokumentasi Framework Website

Pengaturan Versi di Capacitor

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

Mengatur Versi di package.json

File ini berfungsi sebagai sumber utama untuk detail versi aplikasi Anda. Berikut adalah contoh cara mengaturnya: package.json Ketika mengupdate nomor versi, gunakan aturan SemVer (Semantic Versioning):

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

Versi mayor

  • Versi Utama (1.x.x): Mengenalkan perubahan yang mengganggu.
  • Minor version (x.2.x): Menambahkan fitur baru yang kompatibel ke belakang.
  • Patch version (x.x.3): Memperbaiki bug atau membuat perbaikan kecil.

Mengatur Versi Platform untuk Synchronisasi

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

PlatformFile KonfigurasiKunci Versi
iOSInfo.plistCFBundleShortVersionString
Androidbuild.gradleversionName
Webpackage.jsonversi

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

npx cap sync

Menggunakan Capacitor CLI untuk Pengelolaan Versi

Dengan menjaga Capacitor CLI Anda terupdate, Anda dapat memastikan konsistensi dengan fitur yang spesifik untuk versi tertentu dan mengurangi potensi kesalahan. Dengan mengikuti langkah-langkah ini, Anda dapat memastikan pengelolaan versi yang tepat di aplikasi Anda.

# 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

Menggunakan Capacitor CLI untuk Pengelolaan Versi ini menawarkan perintah yang berguna untuk mengelola versi:

Pengaturan Versi Semantik

Dasar-Dasar Versi Semantik

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

Komponen VersiTujuan
MAJORMengenalkan perubahan yang memecah ke API
MINORMengambahkan fitur-fitur baru yang tetap kompatibel dengan versi sebelumnya
PATCHMengatasi bug atau meningkatkan kinerja tanpa mengganggu konsistensi

Sistem ini memungkinkan para pengembang untuk berkomunikasi secara jelas tentang perubahan-perubahan sambil menjaga konsistensi di antara versi aplikasi. Misalnya, beralih dari 1.2.3 ke 2.0.0 menandakan perubahan besar yang memerlukan perencanaan yang hati-hati.

Mengapa Mengubah Nomor Versi?

Berikut cara untuk menentukan nomor versi mana yang harus diubah:

Jenis PerubahanMenggunakan KapanContoh Perubahan Versi
Perubahan BesarMenggunakan perubahan besar API atau merancang ulang antarmuka pengguna besar1.2.3 → 2.0.0
Perbarui RinganMengenai fitur-fitur baru atau menandai fitur-fitur sebagai yang sudah tidak digunakan lagi1.2.3 → 1.3.0
Perbarui RinganUntuk memperbaiki bug atau perbaikan kecil pada kinerja1.2.3 → 1.2.4

“Kami melaksanakan pengembangan yang fleksibel dan @Capgo sangat penting dalam menyampaikan secara terus-menerus kepada pengguna kami!” - Rodrigo Mantica [1]

Sekarang mari kita lihat bagaimana mengotomatisasi perbarui ini untuk memudahkan pengelolaan rilis.

Pengaturan Perbarui Versi

Mengotomatisasi perbarui versi Mengotomatisasi perbarui versi dapat menghemat waktu dan mengurangi kesalahan pada proyek Capacitor Anda. Berikut cara mengaturnya:

  1. Skrip Versi NPM

Tambahkan skrip ini ke file Anda untuk mengelola perbarui versi dengan mudah: package.json __CAPGO_KEEP_0__

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

“@Capgo adalah alat yang wajib dimiliki oleh para pengembang yang mencari produktivitas dengan menghindari ulasan bug yang panjang.” - Bessie Cooper [1]

Metode Tanda Versi Git

Tanda Versi Git

Tanda versi Git adalah cara yang dapat diandalkan untuk mengikuti rilis aplikasi __CAPGO_KEEP_0__ Integrasi CI/CD adalah salah satu fitur utama dari Capacitor yang memungkinkan pengembang untuk mengintegrasikan versi aplikasi ke dalam pipeline CI/CD mereka.Membuat tag yang jelas dan informatif dengan menggabungkan versi semantik dengan deskripsi singkat:

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

Menggunakan format penandaan yang konsisten di tim Anda:

Penanda KomponenFormatContoh
Versi Rilisv[MAJOR].[MINOR].[PATCH]v1.2.3
Versi Betav[VERSION]-beta.[NUMBER]v1.2.3-beta.1
Kandidat Rilisv[VERSION]-rc.[NUMBER]v1.2.3-rc.2

Pengaturan Nomor Pembangunan

Nomor pembangunan membantu mengikuti pembangunan individu dalam setiap versi. Untuk iOS dan Android, meningkatkan nomor pembangunan setiap kali pengiriman:

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

Nomor pembangunan harus selalu meningkat, bahkan jika versi tetap sama. Hal ini memastikan setiap pengiriman aplikasi toko unik sementara menjaga versi tetap jelas bagi pengguna.

Pengelolaan Versi Beta

Pengelolaan versi beta memerlukan proses struktur untuk mendistribusikan pembangunan uji. Capgo’s sistem saluran mengurangi kompleksitas 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 saja yang mendapatkan akses ke versi beta. 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 akhir sebelum rilis
Produksi1.3.0Rilis publik

Dengan cara ini, pengujian yang menyeluruh dan transisi yang halus antara tahap pengembangan dapat dijamin, serta pengaturan dan transparansi tracking versi yang terorganisir 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.

Mengambil Versi dengan Capacitor

Anda dapat mengambil detail versi menggunakan Capacitor dengan 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-tempat umum untuk menampilkan detail versi meliputi:

LokasiTujuanImplementasi
Layar PengaturanVersi lengkap dan buildInformasi 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
    });
  }
}

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

Pengguna juga dapat menambahkan notifikasi update yang dapat dilihat pengguna, seperti ini:

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

Untuk aplikasi perusahaan, Capgo’s sistem saluran memungkinkan Anda mengontrol distribusi update:

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

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

Solusi Pengelolaan Versi

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

Opsi Alat Versi

Ketika memilih alat pengendalian versi, penting untuk memfokuskan pada alat yang memudahkan pembaruan, melindungi code, dan mendukung baik rilis toko aplikasi dan pembaruan langsung.

Berikut beberapa fitur kunci yang perlu dicari:

FiturKepentinganPengaruh
Pembaruan LangsungKritisMengurangi keterlambatan yang disebabkan oleh ulasan toko aplikasi
KeamananWajibMengamankan data pengguna dan integritas code
AnalitikPentingMengukur kesuksesan pembaruan dan pengadopsian pengguna
Integrasi CI/CDBermanfaatMengalirkan proses pengembangan
Efisiensi BiayaStrategisMengaruh perencanaan anggaran jangka panjang

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

Capgo Fitur Pengendalian Versi

Capgo Dashboard Perbarui Hidup Antarmuka

Capgo menyediakan kemampuan pengelolaan versi yang kuat, termasuk:

  • 23,5 juta perbarui sukses yang disampaikan
  • 95% pengguna diperbarui dalam 24 jam
  • 82% tingkat kesuksesan global
  • 434 ms rata-rata waktu respons 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 sedang mencoba @Capgo karena Appcenter telah menghentikan dukungan perbarui hidup pada aplikasi hybrid dan @AppFlow terlalu mahal.” - Simon Flack [1]

Solusi Ukuran Tim

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

Ukuran TimRencanaFitur Utama
Pengembang SoloHosting Cloud DasarPembaruan Langsung, 1.000 Pengguna Aktif Bulanan
Tim Kecil (2-5)Rencana Membuat10.000 Pengguna Aktif Bulanan, 500GB Bandwidth
Tim Menengah (6-20)Rencana Tim100.000 Pengguna Aktif Bulanan, Izin Akses
EnterpriseBayar Sesuai PenggunaanTidak ada batasan pengguna aktif, dukungan dedikasi

Untuk tim yang lebih besar, sistem kanal 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 adopsi versi dan mendeteksi potensi masalah sejak awal. Dengan enkripsi bawaan dan pilihan hosting yang dapat disesuaikan, tim dapat menjaga keamanan sambil meningkatkan alur kerja pengiriman versi.

Kesimpulan

Pemahaman tentang penanda versi sangat penting untuk memudahkan pengembangan dan proses pengiriman. 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:

ManfaatDampakHasil
Pembaruan InstanJadwal Ulasan yang Lebih SingkatPenerimaan Pengguna yang Lebih Cepat [1]
Pengendalian VersiPengelolaan code yang Lebih BaikTingkat Kesuksesan yang Lebih Tinggi [1]
Pantauan PembaruanPantauan Skenario Masa NyataPenyelesaian Masalah yang Lebih Cepat [1]
Kontrol DistribusiPeluncuran yang DitargetkanDukungan Multi-Platform

Hasil ini menunjukkan pentingnya menggunakan alat pengelolaan versi yang efektif.

Cara Mulai

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

  • Tetapkan pengawasan versi: Gunakan pengelolaan versi semantik dalam file Anda dan integrasikan plugin yang diperlukan. package.json Tambahkan periksa update
  • : Implementasikan sistem untuk memverifikasi dan mengikuti pembaruan versi.Konfigurasi saluran distribusi
  • : Buat lingkungan terpisah untuk produksi, beta, dan pengembangan.Akhirnya, pertimbangkan untuk menambahkan sistem update langsung untuk memastikan pengiriman yang cepat dan aman.

Lanjutkan dari Pengtagian Versi di __CAPGO_KEEP_0__ Aplikasi

Capacitor

Jika Anda menggunakan Tag Versi di Aplikasi Capacitor untuk merencanakan rollback dan pengendalian versi, hubungkannya dengan Rollbacks untuk detail implementasi di Rollbacks, Target Versi untuk detail implementasi di Target Versi, Behavior Perbarui untuk detail implementasi di Behavior Perbarui, Paket untuk detail implementasi di Paket, dan Capgo Live Updates untuk alur kerja produk di Capgo Live Updates.

Update Langsung untuk Aplikasi Capacitor

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

Mulai Sekarang

Terbaru dari Blog Kami

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