Pengaturan Versi

Petunjuk ini menjelaskan cara mengirimkan bundle terbaru yang kompatibel ke pengguna berdasarkan versi aplikasi native mereka, seperti pendekatan Ionic AppFlow. Ini memastikan pengelolaan update yang lebih sederhana dan peluncuran yang lebih cepat sambil mencegah masalah kompatibilitas.

Migrasi dari Ionic AppFlow?

Jika Anda berasal dari Ionic AppFlow, panduan ini sangat penting bagi Anda. AppFlow secara otomatis memasangkan update dengan versi native, dan Capgo menyediakan kemampuan yang sama dengan kontrol dan fleksibilitas yang lebih banyak. Lihat Panduan Migrasi AppFlow untuk instruksi migrasi langkah demi langkah. Ringkasan

Judul bagian ‘Ringkasan’

Capgo’s version targeting system allows you to:

• Mengirimkan update yang kompatibel secara otomatis ke pengguna berdasarkan versi aplikasi asli mereka
• Mencegah perubahan yang mengganggu agar tidak mencapai versi aplikasi yang tidak kompatibel
• Manajemen versi aplikasi yang berbeda secara bersamaan tanpa logika kompleks
• Melakukan perubahan besar secara halus ke segmen pengguna tertentu

Mengapa Targeting Versi Penting (Terutama untuk Pengguna AppFlow)

Jika Anda sudah familiar dengan Ionic AppFlow, Anda tahu betapa pentingnya memastikan pengguna hanya menerima update yang kompatibel. AppFlow secara otomatis memasangkan paket update live ke versi aplikasi asli, sehingga JavaScript yang tidak kompatibel tidak akan disampaikan ke versi aplikasi asli code.

Capgo menyediakan jaminan keamanan yang sama, dengan fitur tambahan:

• Kontrol yang lebih halus atas matching versi
• Strategi yang lebih dari satu (saluran, semver, konstrain native)
• Keterlihatan yang lebih baik atas distribusi versi
• API dan CLI mengontrol bersama dengan pengelolaan dashboard

Metode ini sangat berguna ketika:

• Pengguna Anda berada pada versi mayor yang berbeda dari aplikasi Anda (misalnya, v1.x, v2.x, v3.x)
• Pengguna memerlukan kompatibilitas mundur sementara mengeluarkan perubahan yang mengganggu
• Pengguna ingin mencegah bundle yang lebih baru mengganggu native code yang lebih tua
• Pengguna sedang melakukan migrasi secara bertahap dari satu versi ke versi lain
• Pengguna sedang melakukan migrasi dari AppFlow dan ingin menjaga keamanan pembaruan yang sama

How It Works

Capgo uses a multi-layered approach to match users with compatible updates:

1. __CAPGO_KEEP_0__ menggunakan pendekatan multi-layered untuk mencocokkan pengguna dengan pembaruan yang kompatibel:Konstruksi Versi Nativ
2. : Mencegah bundle dari pengiriman ke versi native yang tidak kompatibelPengaturan Rute Berdasarkan Saluran
3. : Mengarahkan versi aplikasi yang berbeda ke saluran pembaruan yang berbedaPengendalian Versi Semantik
4. : Mengblokir otomatis pembaruan di batas-batas mayor/minor/patchPenyesuaian Tingkat Perangkat

Alur Pemilihan Versi

graph TD
    A[User Opens App] --> B{Check Device Override}
    B -->|Override Set| C[Use Override Channel]
    B -->|No Override| D{Check local plugin channel}
    D -->|setChannel value| E[Use local setChannel channel]
    D -->|No local channel| F{Check defaultChannel in App}
    F -->|Has defaultChannel| G[Use App's defaultChannel]
    F -->|No defaultChannel| H[Use Cloud Default Channel]
    C --> I{Check Version Constraints}
    E --> I
    G --> I
    H --> I
    I -->|Compatible| J[Deliver Update]
    I -->|Incompatible| K[Skip Update]

Strategi 1: Rute Versi Berdasarkan Saluran

Ini adalah metode yang disarankan untuk mengelola perubahan yang memecah dan pembaruan versi utama. Ini mirip dengan model pengiriman AppFlow.

Skenario Contoh

• Aplikasi v1.x (100.000 pengguna) → production saluran
• Aplikasi v2.x (50.000 pengguna dengan perubahan besar) → v2 saluran
• Aplikasi v3.x (10.000 pengguna beta) → v3 saluran

Pengimplementasian

Langkah 1: Konfigurasi Saluran untuk Setiap Versi Utama

// capacitor.config.ts for version 1.x builds
import { CapacitorConfig } from '@capacitor/cli';

const config: CapacitorConfig = {
  appId: 'com.example.app',
  appName: 'Example App',
  plugins: {
    CapacitorUpdater: {
      autoUpdate: 'atBackground',
      defaultChannel: 'production', // or omit for default
    }
  }
};

export default config;

// capacitor.config.ts for version 2.x builds
const config: CapacitorConfig = {
  appId: 'com.example.app',
  appName: 'Example App',
  plugins: {
    CapacitorUpdater: {
      autoUpdate: 'atBackground',
      defaultChannel: 'v2', // Routes v2 users automatically
    }
  }
};

// capacitor.config.ts for version 3.x builds
const config: CapacitorConfig = {
  appId: 'com.example.app',
  appName: 'Example App',
  plugins: {
    CapacitorUpdater: {
      autoUpdate: 'atBackground',
      defaultChannel: 'v3', // Routes v3 users automatically
    }
  }
};

Langkah 2: Buat Saluran

# Create channels for each major version
npx @capgo/cli channel create production
npx @capgo/cli channel create v2
npx @capgo/cli channel create v3

# Enable self-assignment so apps can switch channels
npx @capgo/cli channel set production --self-assign
npx @capgo/cli channel set v2 --self-assign
npx @capgo/cli channel set v3 --self-assign

Langkah 3: Unggah Paket Versi-Spesifik

# For v1.x users (from v1-maintenance branch)
git checkout v1-maintenance
npm run build
npx @capgo/cli bundle upload --channel production

# For v2.x users (from v2-maintenance or main branch)
git checkout main
npm run build
npx @capgo/cli bundle upload --channel v2

# For v3.x users (from beta/v3 branch)
git checkout beta
npm run build
npx @capgo/cli bundle upload --channel v3

Pengalihan Otomatis

When pengguna membuka aplikasi, mereka secara otomatis terhubung ke saluran yang ditentukan berdasarkan defaultChannel in their installed app bundle. No JavaScript code changes required!

Manfaat

• Zero code changes Tidak perlu mengubah kode apa pun
• - Routing saluran terjadi secara otomatis Penyisihan yang jelas
• - Setiap versi memiliki jalur pembaruan sendiri Pengaturan yang fleksibel
• - Kirim pembaruan ke kelompok versi tertentu Rollout yang aman (aman) dan terkendali (terkontrol) (terkontrol) (terkontrol) (terkontrol) (terkontrol) (terkontrol) (terkontrol) (terkontrol) (terkontrol) (terkontrol) (terkontrol) (terkontrol) (terkontrol) (terkontrol) (terkontrol) (terkontrol) (terkontrol) (terkontrol) (terkontrol) (terkontrol) (terkontrol) (terkontrol) (terkontrol) (terkontrol) (terkontrol) (terkontrol) (terkontrol) (terkontrol) (terkontrol) (terkontrol) (terkontrol) (terkontrol) (terkontrol) (terkontrol) (terkontrol) (terkontrol) (terkontrol) (terkontrol) (terkontrol) (terkontrol) (terkontrol) (terkontrol) (terkontrol) (terkontrol) (terkontrol) (terkontrol) (terkontrol) (terkontrol) (terkontrol) (terkontrol) (terkontrol) (terkontrol) (terkontrol) (terkontrol) (terkontrol) (terkontrol) (terkontrol) (terkontrol) (terkontrol) (terkontrol) (terkontrol) (terkontrol) (terkontrol) (terkontrol) (terkontrol) (terkontrol) (terkontrol) (terkontrol) (terkontrol) (terkontrol) (terkontrol) (terkontrol) (terkontrol) (terkontrol) (terkontrol) (terkontrol) (terkontrol) (terkontrol) (terkontrol) (terkontrol) (terkontrol) (terkontrol) (terkontrol) (terkontrol) (terkontrol) (terkontrol) (terkontrol) (terkontrol) (terkontrol) (terkontrol) (terkontrol) (terkontrol) (terkontrol) (terkontrol) (terkontrol) (terkontrol) (terkontrol) (terkontrol) (terkontrol) (terkontrol) (terkontrol) (terkontrol) (terkontrol) (terkontrol) (terkontrol) (terkontrol) (terkontrol) (terkontrol) (terkontrol) (terkontrol) (terkontrol) (terkontrol) (terkontrol) (terkontrol) (terkontrol) (terkontrol) (terkontrol) (terkontrol) (terkontrol) (terkontrol) (terkontrol) (terkontrol) (terkontrol) (terkontrol) (terkontrol) (terkontrol) (terkontrol) (terkontrol) (terkontrol) (terkontrol) (terkontrol) (terkontrol) (terkontrol) (terkontrol) (terkontrol) (terkontrol) (terkontrol) (terkontrol) (terkontrol) (terkontrol) (terkontrol) (terkontrol) (terkontrol) (terkontrol) (terkontrol) (terkontrol) (terkontrol) (terkontrol) (terkontrol) (terkontrol) (terkontrol) (terkontrol) (terkontrol) (terkontrol) (terkontrol) (terkontrol) (terkontrol) (terkontrol) (terkontrol) (terkontrol) (terkontrol) (terkontrol) (terkontrol) (terkontrol) (terkontrol) (terkontrol) (terkontrol) (terkontol)

Strategi 2: Pengendalian Versi Semantik

Pakai Capgo’s built-in pengendalian versi semantik untuk mencegah pembaruan di batas-batas versi.

Mencegah Pembaruan Otomatis di Versi Utama

# Create a channel that blocks major version updates
npx @capgo/cli channel create stable --disable-auto-update major

Konfigurasi ini berarti:

• Pengguna aplikasi versi 1.2.3 akan menerima pembaruan hingga 1.9.9
• Pengguna akan TIDAK menerima versi 2.0.0 otomatis
• Mencegah perubahan yang mengganggu mencapai native code
• Perbandingan menggunakan basis native yang dikirimkan sebagai version_build

Pilihan Kontrol yang Rinci

# Block target bundles outside the native major.minor line (1.2.x won't get 1.3.0)
npx @capgo/cli channel set stable --disable-auto-update minor

# Block target bundles outside the exact native MAJOR.MINOR.PATCH core (1.2.3 won't get 1.2.4)
npx @capgo/cli channel set stable --disable-auto-update patch

# Allow all updates
npx @capgo/cli channel set stable --disable-auto-update none

Diperlukan Versi Semantik

Strategi ini hanya berfungsi jika Anda mengikuti semver (versi semantik) untuk versi aplikasi Anda. Pastikan nomor versi Anda mengikuti MAJOR.MINOR.PATCH format.

Strategi 3: Konstrain Versi Nama Domain

Spesifikasikan versi aplikasi native minimum (“)min_update_versionpada setiap paket sehingga Capgo hanya mengirimkannya ke perangkat yang memiliki biner native yang cukup baru.

Ini menggunakan strategi metadata saluran (“) plus plus--disable-auto-update metadataplus --min-update-version atau --auto-min-update-version __CAPGO_KEEP_0__ --native-version CLI flag.

Judul bagian: Aktifkan pengaturan target metadata pada saluran

# one-time: require min_update_version metadata on uploads to this channel
npx @capgo/cli@latest channel set production --disable-auto-update metadata

Judul bagian: Setel versi native minimum pada saat mengunggah

Jendela terminal

# This bundle requires native version 2.0.0 or higher
npx @capgo/cli@latest bundle upload \
  --channel production \
  --min-update-version "2.0.0"

Atau biarkan Capgo menetapkan lantai dari kompatibilitas paket native:

npx @capgo/cli@latest bundle upload \
  --channel production \
  --auto-min-update-version

Bagaimana Cara Kerjanya

Dengan strategi metadata, perangkat yang memiliki dasar native ('version_buildskip update. Hanya perangkat pada versi tersebut atau lebih tinggi yang menerima update. Lihat min_update_version Kompatibilitas untuk detail. --auto-min-update-version Penggunaan Kasus

Penggunaan Kasus

1. Plugin Asli Baru Diperlukan

   # Bundle needs Camera plugin added in v2.0.0
   npx @capgo/cli@latest bundle upload \
     --channel production \
     --min-update-version "2.0.0"

2. Pembaharuan Asli API yang Mengubah

   # Bundle uses new Capacitor 6 APIs
   npx @capgo/cli@latest bundle upload \
     --channel production \
     --min-update-version "3.0.0"

3. Migrasi Gradual

   # one-time: enable metadata gating on beta
   npx @capgo/cli@latest channel set beta --disable-auto-update metadata
   
   # Test bundle only on latest native version
   npx @capgo/cli@latest bundle upload \
     --channel beta \
     --min-update-version "2.5.0"

Strategi 4: Pencegahan Penurunan Otomatis

Mencegah pengguna menerima bundle yang lebih tua dari versi native mereka saat ini.

Mengaktifkan di Pengaturan Saluran

Pada dashboard Capgo:

1. Pergi ke Saluran context
2. Pilih saluran Anda Mengaktifkan
3. “Nonaktifkan penurunan otomatis di native”

Or via CLI:

npx @capgo/cli@latest channel set production --no-downgrade

Contoh

• Perangkat pengguna: Versi asli 1.2.5
• Salinan kanal: Versi 1.2.3
• Hasil: Perbaruan diblokir (akan menjadi penurunan versi)

Hal ini berguna ketika:

• Pengguna secara manual menginstal versi yang lebih baru dari toko aplikasi
• Anda perlu memastikan pengguna selalu memiliki patch keamanan terbaru
• Anda ingin mencegah bug regresi

Strategi 5: Targeting Tingkat Perangkat

Override pengaturan saluran untuk perangkat tertentu atau kelompok pengguna.

Force Versi Spesifik untuk Pengujian

import { CapacitorUpdater } from '@capgo/capacitor-updater'

// Force beta testers to use v3 channel
async function assignBetaTesters() {
  const deviceId = await CapacitorUpdater.getDeviceId()

  // Check if user is beta tester
  if (isBetaTester(userId)) {
    await CapacitorUpdater.setChannel({ channel: 'v3' })
  }
}

Dashboard Pengaturan Perangkat

Pada Capgo dashboard:

1. Pergi ke Perangkat → Cari perangkat
2. Klik Set Saluran atau Bagaimana cara memilih antara saluran yang berbeda?
3. Set Versi
4. Override dengan versi saluran atau paket tertentu

Pengujian Update

Pengujian Update

Gunakan pengaturan perangkat untuk menguji update pada perangkat Anda sendiri sebelum mengimplementasikannya untuk semua pengguna.

Bagian berjudul “Alur Kerja Lengkap AppFlow-Style”

Berikut adalah contoh lengkap yang menggabungkan semua strategi tersebut:

# Create production channel, then enable metadata min-version gating
npx @capgo/cli@latest channel add production
npx @capgo/cli@latest channel set production \
  --disable-auto-update metadata \
  --no-downgrade

capacitor.config.ts

const config: CapacitorConfig = {
  plugins: {
    CapacitorUpdater: {
      autoUpdate: 'atBackground',
      defaultChannel: 'production',
    }
  }
};

2. Perubahan Penerbitan (Aplikasi v2.0.0)

# Create v2 channel for new version
npx @capgo/cli@latest channel add v2
npx @capgo/cli@latest channel set v2 \
  --disable-auto-update metadata \
  --no-downgrade \
  --self-assign

# Create git branch for v1 maintenance
git checkout -b v1-maintenance
git push origin v1-maintenance

// capacitor.config.ts for v2.0.0
const config: CapacitorConfig = {
  plugins: {
    CapacitorUpdater: {
      autoUpdate: 'atBackground',
      defaultChannel: 'v2', // New users get v2 channel
    }
  }
};

3. Kirim Perbarui ke Versi Berdua

# Update v1.x users (bug fix)
git checkout v1-maintenance
# Make changes
npx @capgo/cli@latest bundle upload \
  --channel production \
  --min-update-version "1.0.0"

# Update v2.x users (new feature)
git checkout main
# Make changes
npx @capgo/cli@latest bundle upload \
  --channel v2 \
  --min-update-version "2.0.0"

4. Pantau Distribusi Versi

Pakai dashboard Capgo untuk melacak:

• Banyaknya pengguna pada v1 vs v2
• Rasio penggunaan paket per versi
• Kerusakan atau kegagalan per versi

5. Deprecate Versi Lama

Setelah penggunaan v1 turun di bawah ambang batas:

# Stop uploading to production channel
# Optional: Delete v1 maintenance branch
git branch -d v1-maintenance

# Move all remaining users to default
# (They'll need to update via app store)

Prioritas Saluran

Ketika ada beberapa konfigurasi saluran, Capgo menggunakan urutan prioritas ini:

1. Override Perangkat (Dashboard atau API) - Prioritas tertinggi dan terlihat di UI Override Perangkat
2. Saluran Plugin Lokal via setChannel() - Tersimpan di perangkat hanya dan tidak ditampilkan di UI Override Perangkat
3. defaultChannel dalam capacitor.config.ts
4. Saluran Default (Pengaturan Cloud) - Prioritas Terendah

Contoh Precedence

Jika aplikasi pengguna memiliki defaultChannel: 'v2' tetapi Anda menggantinya dengan perangkat ke 'beta' di dashboard, mereka akan menerima pembaruan dari 'beta' saluran.

The Device Override UI hanya menampilkan penggantian yang ditetapkan dari dashboard atau Publik API. Menggunakan setChannel() mengvalidasi saluran dengan backend, kemudian menyimpannya secara lokal di perangkat.

Praktik Terbaik

1. Selalu Tetapkan defaultChannel untuk Versi Utama

// ✅ Good: Each major version has explicit channel
// v1.x → production
// v2.x → v2
// v3.x → v3

// ❌ Bad: Relying on dynamic channel switching
// All versions → production, switch manually

2. Gunakan Versi Semantik

# ✅ Good
1.0.0 → 1.0.1 → 1.1.0 → 2.0.0

# ❌ Bad
1.0 → 1.1 → 2 → 2.5

3. Jaga Cabang Terpisah

# ✅ Good: Separate branches per major version
main (v3.x)
v2-maintenance (v2.x)
v1-maintenance (v1.x)

# ❌ Bad: Single branch for all versions

4. Uji Sebelum Diluncurkan

# one-time: create beta and enable metadata gating
# (production is set up in the complete workflow above)
npx @capgo/cli@latest channel add beta
npx @capgo/cli@latest channel set beta --disable-auto-update metadata

# Test on beta channel first
npx @capgo/cli@latest bundle upload \
  --channel beta \
  --auto-min-update-version

# Monitor for issues, then promote to production
npx @capgo/cli@latest bundle upload \
  --channel production \
  --auto-min-update-version

5. Pantau Distribusi Versi

Periksa dashboard Anda secara teratur:

• Apakah pengguna mengupgrade ke versi native yang lebih baru?
• Apakah versi lama masih mendapatkan lalu lintas yang tinggi?
• Apakah Anda harus menghentikan penggunaan kanal-kanal lama?

Pembandingan dengan Ionic AppFlow

Untuk tim yang beralih dari Ionic AppFlowdi sini adalah bagaimana Capgo membandingkan target versi:

Fitur	AppFlow Aplikasi Ioni	Capgo
Rute Berdasarkan Versi	Rute Otomatis Berdasarkan Versi Asli	Rute Otomatis Melalui defaultChannel + Strategi Banyak
Pengaturan Versi Semantik	Pengaturan Dasar	Pengaturan Lanjutan dengan --disable-auto-update (versi mayor/minor/patch)
Pengikat Versi Asli	Konfigurasi Manual di Dashboard AppFlow	Bawaan --min-update-version / --auto-min-update-version Dengan Saluran Metadata
Pengelolaan Saluran	Web UI + CLI	Web UI + CLI + API
Antarmuka Web + __CAPGO_KEEP_0__ + __CAPGO_KEEP_1__	Pengaturan Perangkat	Full control via Dashboard/API
Pengaturan Lengkap melalui Dashboard/__CAPGO_KEEP_0__	Pencegahan Penurunan Otomatis	Ya melalui --no-downgrade
Pemeliharaan multi-versi	Pengelolaan cabang/tujuan manual	Dengan otomatisasi dan keutamaan saluran
Penghosan sendiri	Tidak	Ya (pengendalian penuh)
Analisis versi	Sederhana	Metrik per-versi yang rinci

Keseragaman AppFlow dan Lebih Lanjut

Capgo provides Semua kemampuan target versi Dengan fitur yang ditawarkan oleh AppFlow, ditambahkan mekanisme kontrol tambahan. Jika Anda bergantung pada pencocokan versi otomatis dari AppFlow, Anda akan merasa aman dan memiliki fleksibilitas yang lebih besar dengan Capgo.

Pengaturan Masalah

Pengguna Tidak Menerima Perbarui

Periksa hal-hal berikut:

1. Penugasan SaluranVerifikasi perangkat berada di saluran yang benar

   const channel = await CapacitorUpdater.getChannel()
   console.log('Current channel:', channel)

2. Keterbatasan Versi: Periksa apakah bundle memiliki persyaratan versi native

   • Dashboard → Paket → Periksa kolom "Versi Native"

3. Pengaturan Semver: Pastikan saluran memiliki disable-auto-update Pengaturan

   npx @capgo/cli channel list

4. Override Perangkat: Periksa apakah perangkat memiliki override manual

   • Dashboard → Perangkat → Cari perangkat → Periksa saluran/versi

Paket Dikirim ke Versi Salah

1. Ulasan channel default: Pastikan channel yang benar di capacitor.config.ts
2. Periksa Unggah Paket: Pastikan paket telah diunggah ke channel yang dimaksudkan
3. Periksa Versi Update Minimum: Konfirmasi --min-update-version (atau --auto-min-update-version) telah ditetapkan dan channel menggunakan --disable-auto-update metadata

Pembaharuan Mendasar yang Mempengaruhi Versi Lama

1. Pemulihan Langsung: Atur ulang perangkat yang terpengaruh ke paket aman
   • Dashboard → Perangkat → Pilih Massal → Atur Versi
2. Pembaruan Jangka Panjang: Buat saluran dengan versi dan jaga cabang terpisah
3. Pencegahan: Selalu tes pembaruan pada perangkat wakil sebelum peluncuran

Pemindahan dari Ionic AppFlow

Jika Anda sedang memindahkan dari Ionic AppFlow, target versi bekerja sangat mirip di Capgo, dengan fleksibilitas yang lebih baik:

Peta Konsep

Konsep AppFlow	Capgo Sama dengan	Catatan
Jalur Deploy	Capgo Jalur	Konsep yang sama, lebih kuat
Pemutus Versi Asli	--min-update-version / --auto-min-update-version	Kontrol yang lebih halus
Prioritas Jalur	Precedensi Jalur (override → awan → default)	Precedensi yang lebih transparan
Target Deploy	Saluran + semver mengontrol	Strategi yang tersedia secara berbagai
Saluran Produksi	production saluran (atau nama apa pun)	Nama yang fleksibel
Penyaluran berbasis Git	CLI unggah bundle dari cabang	Alur kerja yang sama
Matching versi otomatis	defaultChannel + batasan versi	Diperkuat dengan strategi yang beragam

Perbedaan Utama bagi Pengguna AppFlow

1. Kontrol Lebih Banyak: Capgo memberikan Anda strategi-strategi yang berbeda (saluran, semver, versi native) yang dapat digabungkan
2. Keterlihatan Lebih Baik: Dashboard menampilkan distribusi versi dan masalah kompatibilitas
3. API Akses: Kontrol penuh programatis atas target versi
4. Penggunaan Sendiri: Opsi untuk menjalankan server pembaruan sendiri dengan logika versi yang sama

Langkah Migrasi

1. Peta Saluran AppFlow Anda ke Capgo saluran (biasanya 1:1)
2. Set defaultChannel di capacitor.config.ts untuk setiap versi utama
3. Konfigurasi aturan semver jika Anda ingin pemblokiran otomatis di batas versi
4. Upload bundle spesifik versi menggunakan --min-update-version (saluran harus menggunakan strategi metadata)
5. Pantau distribusi versi di Capgo dashboard

Petunjuk Penuh Migrasi

Untuk instruksi migrasi lengkap termasuk penggantian SDK dan API mapping, lihat Petunjuk Migrasi dari AppFlow ke Capgo.

Polanya Lanjutan

Rollout Berangsur-angsur oleh Versi

// Gradually migrate v1 users to v2
async function migrateUsers() {
  const deviceId = await CapacitorUpdater.getDeviceId()
  const rolloutPercentage = 10 // Start with 10%

  // Hash device ID to get deterministic percentage
  const hash = hashCode(deviceId) % 100

  if (hash < rolloutPercentage) {
    // User is in rollout group - migrate to v2
    await CapacitorUpdater.setChannel({ channel: 'v2' })
  }
}

Bendera Fitur oleh Versi

// Enable features based on native version
async function checkFeatureAvailability() {
  const info = await CapacitorUpdater.getDeviceId()
  const nativeVersion = info.nativeVersion

  if (compareVersions(nativeVersion, '2.0.0') >= 0) {
    // Enable features requiring v2.0.0+
    enableNewCameraFeature()
  }
}

Pengujian A/B di Antara Versi

// Run A/B tests within same native version
async function assignABTest() {
  const nativeVersion = await getNativeVersion()

  if (nativeVersion.startsWith('2.')) {
    // Only A/B test on v2 users
    const variant = Math.random() < 0.5 ? 'v2-test-a' : 'v2-test-b'
    await CapacitorUpdater.setChannel({ channel: variant })
  }
}

Ringkasan

Capgo menyediakan beberapa strategi untuk pengiriman pembaruan versi tertentu:

1. Routing Berdasarkan Saluran: Pemisahan otomatis versi melalui defaultChannel
2. Pengujian Versi Semantik: Mencegah pembaruan di batas major/minor/patch
3. Keterbatasan Versi Nativ: Membatasi versi minimum untuk bundle
4. Pencegahan Turun Versi Otomatis: Tidak pernah mengirimkan bundle yang lebih tua ke versi native yang lebih baru
5. Penyesuaian Perangkat: Kontrol manual untuk pengujian dan targeting

Oleh karena itu, Anda dapat mencapai pengiriman update otomatis AppFlow dengan fleksibilitas dan kontrol yang lebih banyak. Pilih strategi yang paling sesuai dengan alur versi dan pengiriman aplikasi Anda.

Untuk informasi lebih lanjut tentang fitur-fitur tertentu:

• Pedoman Perubahan Besar - Strategi penargetan versi channel yang rinci
• Pengelolaan Channel - Referensi lengkap konfigurasi channel
• Perilaku Update - Penundaan dan kondisi versi native

Teruskan dari Targeting Versi

Jika Anda menggunakan Targeting Versi untuk merencanakan routing saluran dan peluncuran tahap demi tahap, hubungkannya dengan Saluran untuk detail implementasi di Saluran, Saluran untuk detail implementasi di Saluran, Saluran untuk detail implementasi di Saluran, Solusi Uji Beta untuk alur kerja produk di Solusi Uji Beta, dan Solusi Target Versi untuk alur kerja produk di Solusi Target Versi.