Praktik Terbaik Lingkungan Capgo: Staging dengan Satu ID Aplikasi Mobile

Tim biasanya memilih salah satu dari tiga pendekatan untuk lingkungan mobile:

1. Dua ID aplikasi (produksi + pra-produksi)
2. Satu ID aplikasi + switching lingkungan runtime dinamis
3. Satu ID aplikasi + Capgo saluran

Pendekatan pertama dua dapat berfungsi, tetapi mereka menciptakan gesekan jangka panjang. Di tim nyata, model saluran Capgo biasanya adalah yang paling bersih.

Mengapa ID aplikasi duplikat menjadi bising

Menggunakan com.myapp dan com.myapp.beta context: Halaman/area: Situs web pemasaran Capgo. Peran: Label UI singkat atau item navigasi. Dilihat di: halaman trust.astro. Kunci pesan `dan` (Dan).

• seem sederhana, tetapi Anda cepat mendapatkan duplikat:
• Dua alur rilis
• Dua set ID push, tautan dalam, dan pemetaan hak akses
• Diferensiasi konfigurasi dan perilaku tidak konsisten antara lingkungan

Kamu akhirnya harus mengelola dua produk di konsol toko, tim, dan instruksi QA internal.

Mengapa pengaturan waktu eksekusi sering kali berantakan

Gaya pola “ID aplikasi + switch runtime” biasanya berarti aplikasi membaca variabel lingkungan atau flag pada startup dan mengarahkan API, kunci, dan perilaku pembaruan secara dinamis.

Ini berfungsi sampai:

• QA mulai menghindari alur yang dimaksud karena kondisi konfigurasi sudah ketinggalan zaman.
• Seseorang menggunakan endpoint yang salah di produksi.
• Drift lingkungan menyebabkan bug sulit untuk direproduksi.
• Kamu perlu debug “versi konfigurasi mana yang digunakan oleh binary ini?” di perangkat pengguna.

Kompleksitas ini tumbuh dengan setiap rilis dan di mana tim kehilangan kecepatan.

Cara Capgo : satu ID aplikasi, banyak saluran

Capgo membuat kendali lingkungan eksplisit melalui saluran:

• Simpan satu ID aplikasi produksi di App Store / Play.
• Kirim satu biner native untuk “shell” (sampai perubahan native memerlukan rebuild yang benar).
• Rute perilaku melalui saluran, bukan melalui identitas aplikasi yang diulang.

Ini berarti secara praktis:

• production: semua pengguna
• staging: QA internal dan kandidat rilis
• beta: tester yang diundang
• hotfix: jalur pembaruan darurat

Aplikasi pengujian internal Anda di TestFlight/Play dapat tetap selamanya. staging Anda dapat melakukan pembaruan JS/CSS/asset di sana secara berulang melalui Capgo tanpa mempublikasikan aplikasi native baru.

Struktur yang disarankan secara praktis

1) Basis rilis native

Binari native terakhir Anda tetap sama untuk banyak iterasi JS:

bun run build
bunx cap sync
# generate Xcode/Android Studio archives as usual

Anda hanya membangun kembali binari native ketika Anda benar-benar mengubah area permukaan native.

2) Gunakan saluran dedikasi untuk lingkungan

Publikasikan update dengan saluran:

bun run build
bunx @capgo/cli deploy --channel staging

Jalankan tes di QA, perbaiki masalah, lalu promosikan:

bunx @capgo/cli promote vX.Y.Z --channel production

Jika Anda lebih suka versi eksplisit:

bunx @capgo/cli deploy vX.Y.Z --channel staging
bunx @capgo/cli promote vX.Y.Z --channel production

3) Simpan TestFlight 'selalu pre-prod'

Dalam alur kerja iOS, hal ini berarti build TestFlight Anda dapat tetap terkait dengan update pre-produksi:

• Tidak ada pengiriman native yang sering untuk setiap perubahan JS.
• QA selalu memvalidasi dekat-produksi code melalui saluran staging.
• Pengguna produksi hanya menerima saluran bundle produksi yang dipromosikan.

4) Gunakan penggantian saluran hanya untuk alur kerja yang dikendalikan

Untuk tim lanjut, tunjukkan switch kanal yang dikendalikan untuk pengguna QA/admin:

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

await CapacitorUpdater.setChannel({
  channel: 'staging',
  triggerAutoUpdate: true
});

Ini optional. Banyak tim menggunakan pengaturan kanal dari dashboard dan hanya mengganti kanal untuk pengguna internal, bukan semua pelanggan.

Daftar Pemeriksaan Operasional

• Hanya satu ID aplikasi (tidak ada duplikat ID produksi/staging)
• Hanya satu pipeline pembangunan native dasar
• Peta kanal yang terdokumentasi (staging, beta, production, hotfix)
• Jalur promosi yang dikecualikan dalam CI/CD
• Hanya membangun ulang native ketika ada perubahan native yang sebenarnya
• Rollback diuji secara teratur

Manfaat Praktis

Metode ini menghilangkan pergeseran lingkungan, mengurangi perubahan pembangunan, dan mempercepat perbaikan:

• QA mendapatkan biner yang realistis (tidak ada identitas
• Jalur TestFlight Anda tetap stabil,
• Tim Anda menghindari "utang ID aplikasi dua,"
• anda dapat memasukkan banyak perbaikan JavaScript hanya melalui Capgo dengan cepat.

Hasil akhirnya adalah pemerintahan yang lebih sederhana: lebih sedikit artefak, telemetri yang lebih bersih, dan lebih sedikit kejutan dalam operasi rilis.

Teruslah dari Capgo Praktik Terbaik Lingkungan: Staging dengan Satu ID Aplikasi Mobile

Jika Anda menggunakan Capgo Praktik Terbaik Lingkungan: Staging dengan Satu ID Aplikasi Mobile untuk merencanakan routing saluran dan peluncuran yang dipersiapkan, hubungkannya dengan Saluran context untuk detail implementasi di Saluran, Saluran Saluran untuk detail implementasi di Saluran, Pengujian Beta Solusi untuk alur produk di Pengujian Beta Solusi, dan Sasaran Versi Solusi untuk alur produk di Sasaran Versi Solusi.