Migrasi dari AppFlow ke Capgo

🚦 Ionic mengumumkan bahwa produk komersial AppFlow—termasuk Live Update—akan dihentikan. Proyek yang sudah ada dapat berjalan hingga 31 Desember 2027, tetapi tidak ada pelanggan baru yang diterima dan tidak ada fitur baru yang direncanakan. Panduan ini memandu Anda melalui langkah-langkah yang diperlukan untuk bermigrasi ke Capgo dan menyoroti otomasi native yang Anda dapatkan.

Ringkasan migrasi

Capgo menangani channel, retensi bundle, rollback, analitik, dan upload CLI untuk Anda. Migrasi cukup dengan menginstal plugin, memanggil CapacitorUpdater.notifyAppReady(), dan—jika diinginkan—mengonfigurasi kontrol manual opsional. Bagian di bawah ini membahas setiap tugas secara langsung.

Targeting Versi Seperti AppFlow

Jika Anda mengandalkan pencocokan versi otomatis AppFlow (menyampaikan pembaruan yang kompatibel berdasarkan versi native), Capgo menyediakan kemampuan yang sama dengan kontrol yang lebih baik. Lihat Panduan penargetan versi untuk strategi detail dalam mengelola update di berbagai versi aplikasi.

Langkah 0 – Catat setup AppFlow Anda saat ini

• Catat AppFlow Anda ID Aplikasi, channel yang ada, dan kunci tanda tangan.
• Ekspor riwayat bundle apa pun yang ingin Anda arsipkan.
• Jika Anda menggunakan GitHub Actions atau penyedia CI lain, pertahankan pipeline tersebut—mereka akan tetap berfungsi dengan Capgo.

Langkah 1 – Ganti SDK AppFlow dengan Capgo

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

Selesai. Capgo membundel code native untuk iOS dan Android; tidak perlu helper JavaScript tambahan.

Langkah 2 – Konfigurasi minimal (tanpa field manual)

Blok konfigurasi yang ada sangat panjang. Capgo mendeteksi proyek dan channel Anda secara otomatis, jadi konfigurasi minimalnya 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	Padanan Capgo	Apakah perlu diatur?
appId	Dikelola di dashboard Capgo	Disediakan otomatis saat Anda membuat proyek
channel / defaultChannel	Aturan channel di dashboard/API	Override opsional; default dari server. Lihat Targeting Versi untuk strategi multi-versi
autoUpdateMethod	autoUpdate: true	Aktif secara default
maxVersions	Kebijakan retensi	Dikonfigurasi terpusat (default 1 bulan, maks 24 bulan)
enabled	Tidak diwajibkan	Capgo mengatur ketersediaan per channel

Langkah 3 – Panggil notifyAppReady() (satu-satunya hook yang wajib)

Di panduan Ionic, Anda mengatur sync, download, dan reload, lalu menyembunyikan splash screen secara manual. Capgo melakukan tindakan tersebut secara native. Anda hanya perlu mengonfirmasi bahwa aplikasi siap:

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

CapacitorUpdater.notifyAppReady()

Jika konfirmasi tidak pernah diterima, Capgo akan melakukan rollback bundle secara otomatis.

Selesai—Capgo menangani pemeriksaan latar belakang, visibilitas splash, dan rollback untuk Anda.

Opsional: jalankan logika sebelum splash screen 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 – Strategi update yang dipetakan

AppFlow mendokumentasikan tiga strategi. Berikut cara pemetaannya ke Capgo:

Latar Belakang (default)

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

Selalu versi terbaru

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

Opsional: pemeriksaan 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 })
  }
})

Paksa update

• AppFlow: tampilkan prompt ke pengguna dan panggil reload().
• Capgo: tandai bundle sebagai “mandatory” di dashboard, lalu dengarkan untuk majorAvailable event (dipancarkan setelah notifyAppReady()) untuk memaksa atau meminta pengguna di dalam aplikasi Anda.

Langkah 5 – Mapping pemanggilan API

Metode AppFlow	Padanan Capgo	Apakah Anda membutuhkannya?
LiveUpdates.sync()	Ditangani secara otomatis	Auto-update native Capgo berjalan tanpa panggilan sinkronisasi manual
LiveUpdates.download()	CapacitorUpdater.download()	Opsional untuk alur kustom
LiveUpdates.reload()	CapacitorUpdater.set()	Opsional; toggle di dashboard menangani pembaruan paksa
LiveUpdates.getVersion()	CapacitorUpdater.current()	Diagnostik opsional

Langkah 6 – Deploy menggunakan Capgo CLI atau API

Selesaikan migrasi dengan mengunggah bundle menggunakan Capgo CLI atau API. Alur kerjanya mirip dengan yang mungkin pernah Anda buat lewat skrip, tetapi kini dilengkapi pengaman native:

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

Deployment khusus versi (seperti AppFlow)

Jika Anda perlu menargetkan versi native tertentu (mirip dengan native version locking di AppFlow):

# Only deliver to devices on native version 2.0.0 or higher
# Channel must use metadata strategy: --disable-auto-update metadata
capgo bundle upload \
  --path dist \
  --channel production \
  --min-update-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

Lihat Panduan penargetan versi untuk strategi komprehensif.

Capgo secara otomatis:

• Menyimpan log audit tingkat perangkat untuk setiap instalasi.
• Mengirim email proaktif saat Anda mendekati batas paket.
• Menyediakan kredit burst agar Anda tidak pernah terhambat di tengah rilis.
• Menerbitkan metrik latensi untuk 18 wilayah global di status.capgo.app/riwayat.

Plugin Ionic Enterprise

Jika stack Ionic Anda juga menggunakan plugin enterprise, ikuti dokumen migrasi yang ditargetkan di bawah. Setiap panduan merekomendasikan pengganti Capgo dan langkah selanjutnya.

• Migrasi dari Ionic Secure Storage
• Migrasi dari Ionic Auth Connect
• Migrasi dari Ionic Identity Vault

Pertanyaan yang sering diajukan

Mengapa AppFlow menghentikan live updates?

Ionic menghentikan produk komersial, termasuk AppFlow, untuk fokus pada framework open-source mereka. Pelanggan yang sudah ada dapat terus menggunakan live updates hingga 31 Desember 2027, tetapi tidak ada fitur baru atau pelanggan baru yang diterima. Capgo mengisi kekosongan tersebut dengan platform OTA native yang khusus.

Berapa lama waktu migrasinya?

Sebagian besar tim menyelesaikan perpindahan dalam waktu kurang dari satu hari. Konsep seperti channels, deployments, dan release rules dipetakan secara langsung, dan tim kami menyediakan dokumentasi serta dukungan langsung. Dalam banyak kasus, Anda cukup menginstal plugin, memanggil notifyAppReady(), dan mengunggah bundle pertama Anda.

Apakah bisa lebih hemat?

Ya. AppFlow live updates mulai dari $499/bulan. Capgo mulai dari $14/bulan dengan harga berbasis penggunaan yang turun hingga sekitar $0,001 per MAU. Anda juga mendapatkan enkripsi, rollback otomatis, dan monitoring latency global.

Kapan sebaiknya kami migrasi?

Karena AppFlow sekarang dalam mode maintenance, migrasi lebih awal memberi Anda akses ke inovasi Capgo yang berkelanjutan. Kami menyarankan beralih saat cocok dengan jadwal rilis Anda. Tim engineering kami akan membantu merencanakan transisi agar CI/CD dan deployment Anda tetap berjalan.

Sumber daya tambahan

• Panduan penargetan versi - Mendalami strategi pencocokan versi bergaya AppFlow
• Perubahan Penting - Mengelola pembaruan versi mayor dengan channel
• Manajemen Channel - Referensi konfigurasi channel lengkap

Butuh bantuan?

• Jadwalkan sesi migrasi: buku.capgo.app/demo
• Gabung komunitas: Discord Capgo
• Lacak issue / ajukan fitur: github.com/Cap-go/capacitor-updater

Capgo dirancang untuk enterprise yang butuh native delta updates, encrypted bundles, dan inovasi berkelanjutan. Setelah migrasi, Anda bisa menghapus glue AppFlow code, mengandalkan otomatisasi native, dan terus merilis tanpa gangguan.

Lanjutkan: Migrasi dari AppFlow ke Capgo

Jika Anda menggunakan Migrasi dari AppFlow ke Capgo untuk merencanakan migrasi dan operasional enterprise, hubungkan dengan Capgo Enterprise untuk workflow produk di Capgo Enterprise, Alternatif Plugin Ionic Enterprise untuk workflow produk di Alternatif Plugin Ionic Enterprise, Alternatif Capgo untuk alur kerja produk di Alternatif Capgo, Konsultasi Capgo untuk alur kerja produk di Capgo Consulting, dan Dukungan Premium Capgo untuk alur kerja produk di Capgo Premium Support.