Migrasi dari AppFlow ke Capgo

🚦 Ionic mengumumkan bahwa produk komersial AppFlow—termasuk Live Updates—akan segera dihentikan. Proyek yang sudah ada dapat tetap berjalan hingga 31 Desember 2027, namun tidak ada pelanggan baru yang diterima dan tidak ada fitur baru yang direncanakan. Panduan ini akan memandu Anda melakukan migrasi ke Capgo dan menunjukkan otomatisasi native yang akan Anda dapatkan.

Ringkasan migrasi

Capgo menangani channel, retensi bundle, rollback, analytics, dan upload CLI untuk Anda. Migrasi intinya adalah menginstal plugin, memanggil CapacitorUpdater.notifyAppReady(), dan—jika perlu—mengonfigurasi kontrol manual opsional. Bagian di bawah ini akan memandu setiap tugas secara langsung.

Targeting Versi Seperti AppFlow

Jika Anda mengandalkan pencocokan versi otomatis dari AppFlow (mengirimkan update yang kompatibel berdasarkan versi native), Capgo menyediakan kemampuan yang sama dengan kontrol lebih baik. Lihat Panduan Targeting Versi untuk strategi mendalam dalam mengelola update di berbagai versi aplikasi.

Langkah 0 – Catat setup AppFlow Anda saat ini

• Catat AppFlow Anda, App ID,channel yang ada, dan signing keys.
• Ekspor riwayat bundle apa pun yang ingin Anda arsipkan.
• Jika Anda menggunakan GitHub Actions atau penyedia CI lain, pertahankan pipeline tersebut—semuanya 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 saat ini 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	Konfigurasi terpusat (default 1 bulan, maks 24 bulan)
enabled	Tidak wajib	Capgo mengatur ketersediaan per channel

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

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

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

CapacitorUpdater.notifyAppReady()

Jika konfirmasi tidak kunjung datang, Capgo akan melakukan rollback bundle secara otomatis.

Selesai—Capgo menangani pengecekan background, visibilitas splash screen, 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

AppFlow mendokumentasikan tiga strategi. Berikut adalah pemetaannya ke Capgo:

Latar Belakang (default)

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

Selalu terbaru

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

Opsional: pengecekan 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: beri prompt ke user dan panggil reload().
• Capgo: tandai bundle sebagai “mandatory” di dashboard, lalu pantau majorAvailable event (diterbitkan setelah notifyAppReady()) untuk memberi prompt atau memaksa user 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 perlu panggilan sync manual
LiveUpdates.download()	CapacitorUpdater.download()	Opsional untuk alur kustom
LiveUpdates.reload()	CapacitorUpdater.set()	Opsional; toggle dashboard menangani forced updates
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 skrip yang mungkin sudah Anda buat sebelumnya, namun kini dilengkapi dengan pengamanan native:

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

Deployment spesifik 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 yang komprehensif.

Capgo secara otomatis:

• Menyimpan audit logs tingkat perangkat untuk setiap instalasi.
• Mengirim email proaktif saat Anda mendekati limit paket.
• Menyediakan burst credits agar Anda tidak terhambat saat rilis.
• Menampilkan metrik latensi untuk 18 wilayah global di status.capgo.app/history.

Plugin Ionic Enterprise

Jika stack Ionic Anda juga menggunakan enterprise plugins, ikuti panduan migrasi di bawah ini. 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 layanan live updates?

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

Berapa lama waktu migrasinya?

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

Apakah kami 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 latensi global.

Kapan sebaiknya kami migrasi?

Karena AppFlow kini dalam maintenance mode, 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 peralihan agar CI/CD dan deployment Anda tetap berjalan.

Sumber Daya Tambahan

• Panduan Targeting Versi - Bedah strategi matching versi ala AppFlow
• Perubahan Penting - Kelola update versi mayor dengan channel
• Manajemen Channel - Referensi lengkap konfigurasi channel

Butuh bantuan?

• Jadwalkan sesi migrasi: book.capgo.app/demo
• Gabung komunitas: Capgo Discord
• Laporkan issue / request fitur: github.com/Cap-go/capacitor-updater

Capgo dirancang untuk enterprise yang butuh native delta updates, bundle terenkripsi, dan inovasi berkelanjutan. Setelah migrasi, Anda bisa menghapus AppFlow glue code, mengandalkan native automation, dan terus shipping tanpa gangguan.

Lanjut ke Migrasi dari AppFlow ke Capgo

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