Perubahan yang Mengganggu

Dokumentasi ini menjelaskan cara mengatasi perubahan yang memecah dalam aplikasi Anda menggunakan saluran versi. Pendekatan ini memungkinkan Anda untuk menjaga versi aplikasi yang berbeda sambil memastikan pengguna menerima pembaruan yang kompatibel.

Skenario Contoh

Mari kita katakan Anda memiliki:

• Versi aplikasi 1.2.3 (versi lama) - menggunakan saluran produksi
• Versi aplikasi 2.0.0 (versi baru dengan perubahan yang memecah) - menggunakan saluran v2
• Pembaruan hidup 1.2.4 (kompatibel dengan 1.2.3)
• Live update 2.0.1 (kompatibel dengan 2.0.0)

Strategi: Selalu Gunakan defaultChannel untuk Versi Utama

Saran yang Dianjurkan: Tetapkan sebuah defaultChannel untuk setiap versi utama. Hal ini memastikan Anda selalu dapat memperbarui update ke kelompok pengguna tertentu tanpa bergantung pada penugasan kanal dinamis.

// Version 1.x releases
defaultChannel: 'v1'

// Version 2.x releases
defaultChannel: 'v2'

// Version 3.x releases (future)
defaultChannel: 'v3'

Tips

Manfaat dari strategi ini:

• Selalu memiliki kendali atas siapa yang menerima update
• Tidak ada penggantian saluran dinamis diperlukan di aplikasi Anda code
• Pemisahan yang Jelas antara versi aplikasi yang berbeda
• Kemampuan fleksibel Untuk memasukkan perubahan ke dalam kelompok versi tertentu

1. Buat Saluran untuk Versi Baru

# Create channel for version 2.x
npx @capgo/cli channel create v2

2. Perbarui Konfigurasi Capacitor untuk Versi 2.0.0

Perbarui konfigurasi Capacitor Anda sebelum membangun versi 2.0.0 untuk toko aplikasi:

capacitor.config.ts

import { CapacitorConfig } from '@capacitor/cli';

const config: CapacitorConfig = {
  appId: 'com.example.app',
  appName: 'Example App',
  plugins: {
    CapacitorUpdater: {
      // ... other options
      defaultChannel: 'v2' // All 2.0.0 users will use v2 channel
    }
  }
};

export default config;

Catatan

Untuk versi 1.x: Jika Anda tidak menyetel defaultChannel awalnya, pengguna versi 1.x berada di production saluran. Untuk versi mayoran di masa depan, selalu tetapkan saluran tertentu seperti v3, v4Tidak ada informasi yang perlu diterjemahkan.

3. Kelola Cabang Terpisah Code

Buat cabang git terpisah untuk menjaga konsistensi antara versi aplikasi:

# Create and maintain a branch for version 1.x updates
git checkout -b v1-maintenance
git push origin v1-maintenance

# Your main branch continues with version 2.x development
git checkout main

Kritis: Jangan pernah memasukkan bundle JavaScript ke aplikasi yang lebih tua yang hanya mendukung code/API native mereka. Selalu bangun pembaruan dari cabang yang tepat:

• cabang pemeliharaan v1: Untuk pembaruan aplikasi 1.x (saluran produksi)
• cabang utama: Untuk pembaruan ke aplikasi 2.x (saluran v2)

4. Unggah Paket ke Saluran yang Sesuai

# For 1.x updates: Build from v1-maintenance branch
git checkout v1-maintenance
# Make your 1.x compatible changes here
npx @capgo/cli bundle upload --channel production

# For 2.x updates: Build from main branch
git checkout main
# Make your 2.x changes here
npx @capgo/cli bundle upload --channel v2

5. Aktifkan Penugasan Sendiri

# Allow apps to self-assign to v2 channel
npx @capgo/cli channel set v2 --self-assign

6. Rilis ke App Store

Buat dan rilis versi 2.0.0 ke toko aplikasi. Semua pengguna yang mengunduh versi ini (baik pengguna baru maupun pengguna yang mengupgrade) akan secara otomatis menggunakan saluran v2 karena telah dikonfigurasi dalam bundle aplikasi.

Catatan

Tidak ada perubahan code yang diperlukan! Sejak defaultChannel: 'v2' tersedia bersama dengan versi toko aplikasi, semua pengguna yang mengunduh versi 2.0.0 akan secara otomatis menggunakan saluran yang benar.

Mengalami Skala ke Versi Masa Depan

Ketika Anda merilis versi 3.0.0 dengan perubahan yang lebih berisiko:

# Create channel for version 3.x
npx @capgo/cli channel create v3

// capacitor.config.ts for version 3.0.0
const config: CapacitorConfig = {
  // ...
  plugins: {
    CapacitorUpdater: {
      defaultChannel: 'v3' // Version 3.x users
    }
  }
};

Sekarang Anda dapat memperbarui versi apa pun:

• production saluran → Pengguna versi 1.x
• v2 saluran → Pengguna versi 2.x
• v3 saluran → Pengguna versi 3.x

7. Pembersihan (Setelah Migrasi)

Setelah semua pengguna telah beralih ke versi 2.x (hitung 3-4 bulan):

1. Hapus defaultChannel dari konfigurasi Capacitor Anda
2. Hapus saluran v2:

npx @capgo/cli channel delete v2

3. Hapus cabang v1-maintenance:

git branch -d v1-maintenance
git push origin --delete v1-maintenance

Tips

Menggunakan cara ini, pengguna hanya akan menerima pembaruan yang kompatibel dengan versi aplikasi mereka.

Selalu tes pembaruan secara menyeluruh di setiap saluran sebelum di-deploy.

Catatan

You can safely delete the v2 channel in Capgo even if some users still have the channel override. They will automatically receive updates from the production channel instead.

Mengelola Pembaruan Versi 1.x

Untuk mengirimkan pembaruan yang kompatibel dengan versi 1.x:

1. Pindah ke cabang v1-maintenance:

git checkout v1-maintenance

2. Lakukan perubahan dan commit:

# Make 1.x compatible changes
git add .
git commit -m "Fix for v1.x"
git push origin v1-maintenance

3. Buat dan unggah ke saluran produksi:

npx @capgo/cli bundle upload --channel production

Tips

Pastikan cabang v1-maintenance Anda selalu up-to-date dengan perbaikan bug yang kompatibel dengan versi 1.x, namun jangan pernah menggabungkan perubahan yang memecah dari main