Migrasikan dari AppFlow ke Capgo

🚦 Ioniq mengumumkan bahwa produk komersial AppFlow, termasuk Live Updates, akan berhenti beroperasi. Projek yang sudah ada masih bisa dijalankan hingga 31 Desember 2027, tapi tidak ada pelanggan baru yang diterima dan tidak ada fitur baru yang direncanakan. Panduan ini akan membantu Anda melalui langkah-langkah yang diperlukan untuk bermigrasi ke Capgo dan menunjukkan otomatisasi native yang Anda dapatkan.

Panduan Migrasi

Capgo mengelola saluran, penyimpanan paket, pengembalian ke versi sebelumnya, analitis, dan CLI unggahan untuk Anda. Migrasi hanya berarti menginstal plugin, memanggil CapacitorUpdater.notifyAppReady(), dan jika diinginkan—mengkonfigurasi kontrol manual opsional. Bagian-bagian di bawah ini akan menjelaskan setiap tugas secara langsung.

Target Versi Seperti AppFlow

Jika Anda bergantung pada AppFlow’s automatic version matching (mengirimkan pembaruan yang kompatibel berdasarkan versi native), Capgo menyediakan kemampuan yang sama dengan kontrol yang lebih baik. Lihat panduan Target Versi untuk strategi rinci mengelola pembaruan di beberapa versi aplikasi.

Langkah 0 – Tangkap konfigurasi AppFlow saat ini

• Catat AppFlow ID Aplikasi, saluran yang ada, dan kunci tanda tangan.
• Eksport sejarah bundle yang ingin Anda arsip.
• Jika Anda menggunakan GitHub Aksi atau penyedia CI lainnya, jaga jalur pipa itu—mereka akan terus berfungsi dengan Capgo.

Langkah 1 – Ganti AppFlow SDK dengan Capgo

npm uninstall @capacitor/live-updates
npm install @capgo/capacitor-updater
npx cap sync

Itu saja. Capgo mengemas kode native code untuk kedua iOS dan Android; tidak ada bantuan JavaScript tambahan yang diperlukan.

Langkah 2 – Konfigurasi Minimal (tidak ada bidang manual)

Blokl konfigurasi yang ada sangat luas. Capgo mendeteksi otomatis proyek dan saluran Anda, sehingga konfigurasi minimal adalah:

capacitor.config.ts

import { CapacitorConfig } from '@capacitor/cli'

const config: CapacitorConfig = {
  plugins: {
    CapacitorUpdater: {
      autoUpdate: true,
      autoDeletePrevious: true,
    },
  },
}

export default config

Referensi cepat konfigurasi

Pengaturan Ionic AppFlow	Capgo setara	Apakah Anda perlu mengatur hal ini?
appId	Dikelola di dashboard Capgo	Disediakan secara otomatis ketika Anda membuat proyek
channel / defaultChannel	Aturan saluran di dasbor/API	Pengaturan opsional; default berasal dari server. Lihat Target Versi untuk strategi multi-versi
autoUpdateMethod	autoUpdate: true	Dijalankan secara default
maxVersions	Kebijakan Retensi	Dikonfigurasi secara sentral (1 bulan default, 24 bulan maksimal)
enabled	Tidak diperlukan	Capgo mengaktifkan ketersediaan per saluran

Langkah 3 – Panggil notifyAppReady() (hanya hook yang diperlukan)

Dalam panduan Ionic Anda menghubungkan sync, download, dan reload, lalu sembunyikan layar splash secara manual. Capgo melakukan aksi-aksi tersebut secara native. Anda hanya perlu memastikan aplikasi sudah siap:

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

CapacitorUpdater.notifyAppReady()

Jika konfirmasi tidak pernah datang, Capgo akan mengembalikan bundle secara otomatis.

Itu saja—Capgo mengelola pengecekan latar belakang, visibilitas layar splash, dan pengembalian ke awal untuk Anda.

Opsional: jalankan logika sebelum layar splash disembunyikan

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

CapacitorUpdater.addListener('appReady', () => {
  // Log diagnostics or run custom code if needed
  SplashScreen.hide()
})

CapacitorUpdater.notifyAppReady()

Langkah 4 – Update strategi terjemahan

AppFlow menjelaskan tiga strategi. Berikut adalah bagaimana mereka terhubung dengan Capgo:

Latar belakang (default)

• AppFlow: konfigurasi autoUpdateMethod = background, panggil sync() secara manual.
• Capgo: diaktifkan secara default. Tidak memerlukan JavaScript.

Selalu Terbaru

• AppFlow: tambahkan App.addListener('resume') handler yang mengunduh dan memuat ulang.
• Capgo: update otomatis sudah berjalan saat diresume. Tambahkan handler hanya jika Anda ingin jendela waktu yang dapat disesuaikan.

Opsional: periksa resume manual

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

App.addListener('resume', async () => {
  const bundle = await CapacitorUpdater.download()
  if (bundle) {
    await CapacitorUpdater.set({ id: bundle.id })
  }
})

Perbarui paksa

• AppFlow: tampilkan pesan kepada pengguna dan panggil reload().
• Capgo: tandai paket sebagai “wajib” di dashboard, lalu dengarkan event (diterbitkan setelah majorAvailable ) untuk menampilkan atau memaksa pengguna di dalam aplikasi Anda. notifyAppReady()AppFlow

Langkah 5 – Membuat Peta API

Metode AppFlow	Capgo yang Sama	Apakah Anda Membutuhkannya?
LiveUpdates.sync()	Dapat Ditangani Otomatis	Capgo’s Auto-Update Asli Berjalan Tanpa Panggilan Sinkronisasi Manual
LiveUpdates.download()	CapacitorUpdater.download()	Opsional untuk Aliran Kustom
LiveUpdates.reload()	CapacitorUpdater.set()	Opsional; Pengaturan Dashboard Mengatur Perbarui Paksa
LiveUpdates.getVersion()	CapacitorUpdater.current()	Diagnostics Opsional

Langkah 6 – Menggunakan Capgo CLI atau API

Selesaikan migrasi dengan mengunggah bundle dengan Capgo CLI atau API. Alur kerja ini meniru apa yang Anda mungkin telah script sebelumnya, tetapi sekarang termasuk perlindungan asli:

capgo login                # authenticate once
capgo bundle upload \
  --path dist \
  --channel production     # automatically tags platform/version

Penggunaan versi tertentu (seperti AppFlow)

Jendela terminal

# Only deliver to devices on native version 2.0.0 or higher
capgo bundle upload \
  --path dist \
  --channel production \
  --native-version "2.0.0"

# Use channels for different major versions
capgo bundle upload --channel v2  # for app version 2.x
capgo bundle upload --channel v3  # for app version 3.x

Versi Targeting Guide untuk strategi komprehensif. __CAPGO_KEEP_0__ secara otomatis:

Capgo automatically:

• Mengarsipkan log audit perangkat untuk setiap instalasi.
• Mengirim email proaktif ketika Anda mendekati batas rencana.
• Menghadirkan kredit ledakan sehingga Anda tidak pernah diblokir di tengah-tengah rilis.
• Menerbitkan metrik latency untuk 18 wilayah global di status.capgo.app/history.

Plugin Ionic enterprise

If your Ionic stack also uses enterprise plugins, follow the targeted migration docs below. Each guide recommends the Capgo replacement and the next steps.

• Migrasi dari Ionic Auth Connect
• Migrasi dari Ionic Identity Vault
• Faq yang sering ditanyakan

Pertanyaan yang sering ditanyakan

Mengapa AppFlow menutup pembaruan live?

Ionic menghentikan produk komersial, termasuk AppFlow, untuk fokus pada kerangka kerja open-source mereka. Pelanggan eksis dapat terus menggunakan pembaruan live hingga 31 Desember 2027, tetapi tidak ada fitur baru atau pelanggan yang diterima. Capgo mengisi celah tersebut dengan platform OTA native yang dedikasi.

Berapa lama waktu migrasi?

Banyak tim menyelesaikan perpindahan dalam waktu kurang dari sehari. Konsep seperti saluran, pengiriman, dan aturan rilis dapat menerjemahkan langsung, dan tim kami menyediakan dokumentasi serta dukungan tangan. Dalam banyak kasus, Anda hanya perlu menginstal plugin, memanggil notifyAppReady(), dan mengunggah bundle pertama Anda.

Apakah kami akan menghemat uang?

Ya. AppFlow live updates dimulai dari $499/mo. Capgo mulai dari $14/mo dengan harga berdasarkan penggunaan yang menurun menjadi sekitar $0.001 per pengguna aktif bulanan (MAU). Anda juga mendapatkan enkripsi, pengembalian otomatis, dan pemantauan latensi global.

Kapan kita harus migrasi?

Karena AppFlow saat ini dalam mode perawatan, migrasi lebih cepat memberikan akses ke inovasi Capgo yang berlanjut. Kami merekomendasikan beralih ketika itu sesuai dengan jadwal rilis Anda. Tim ahli kami akan membantu Anda merencanakan perubahan agar CI/CD dan pengiriman tetap berjalan.

Sumber Daya Tambahan

• Petunjuk Panduan Versi - Mencari ke dalam strategi pencocokan versi AppFlow
• Perubahan Mendasar - Mengelola pembaruan versi utama dengan saluran
• Manajemen Saluran - Referensi konfigurasi saluran lengkap

Membutuhkan Bantuan?

• Buat janji migrasi: cal.com/team/capgo/demo
• Bergabunglah dengan komunitas: Capgo Discord
• Lacak masalah / minta fitur: github.com/Cap-go/capacitor-updater

Capgo dirancang untuk perusahaan yang membutuhkan pembaruan delta asli, paket yang dienkripsi, dan inovasi yang terus-menerus. Setelah Anda melakukan migrasi, Anda dapat menghapus glue AppFlow code, bergantung pada otomatisasi asli, dan terus mengirimkan tanpa gangguan.