Perubahan yang Mengganggu

Copas prompt pengaturan dengan langkah instalasi dan panduan markdown lengkap untuk plugin ini.

Skenario Contoh

Pengaturan dengan AI

Misalkan Anda memiliki:

Versi aplikasi 1.2.3 (versi lama) - menggunakan saluran produksi
Versi aplikasi 2.0.0 (versi baru dengan perubahan besar) - menggunakan saluran v2
Pembaruan hidup 1.2.4 (kompatibel dengan 1.2.3)
Pembaruan hidup 2.0.1 (kompatibel dengan 2.0.0)

Strategi: Selalu Gunakan defaultChannel untuk Versi Besar

Saran yang disarankan: Tetapkan defaultChannel untuk setiap versi besar. Dengan demikian, Anda dapat selalu membarui aplikasi untuk kelompok pengguna tertentu tanpa harus bergantung pada penugasan saluran dinamis.

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

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

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

1. Buat Saluran untuk Versi Baru

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

2. Perbarui Capacitor Konfigurasi untuk Versi 2.0.0

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

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;

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 lama yang mengharapkan native code/API yang tidak ada. Selalu bangun update dari cabang yang tepat:

cabang pemeliharaan v1Untuk update 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 Otomatis

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

6. Rilis ke App Store

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

Mengukur untuk Versi Masa Depan

Ketika Anda merilis versi 3.0.0 dengan perubahan yang lebih besar:

# 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 channel → Pengguna Versi 1.x
v2 channel → Pengguna Versi 2.x
v3 channel → Pengguna Versi 3.x

7. Pembersihan (Setelah Migrasi)

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

Hapus defaultChannel dari konfigurasi Capacitor Anda
Hapus saluran v2:

npx @capgo/cli channel delete v2

Hapus cabang v1-maintenance:

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

Selalu lakukan tes pembaruan secara menyeluruh di setiap saluran sebelum pengiriman

Mengatur Pembaruan Versi 1.x

Untuk mengirimkan pembaruan yang kompatibel dengan versi 1.x:

Pindah ke cabang v1-maintenance:

git checkout v1-maintenance

Buat perubahan Anda dan komit:

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

Buat dan unggah ke saluran produksi:

npx @capgo/cli bundle upload --channel production