Migrate dari AppFlow ke Capgo

🚦 Ioni mengumumkan bahwa produk dagang AppFlow—termasuk Live Updates—sedang berhenti. Projek 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 akan membawa Anda melalui aksi yang diperlukan untuk bermigrasi ke Capgo dan menyoroti otomatisasi asli yang Anda dapatkan.

Ringkasan Migrasi

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

Versi Targeting 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 ditingkatkan. Lihat Versi Targeting Guide untuk strategi rinci mengelola pembaruan di beberapa versi aplikasi.

Langkah 0 – Tangkap konfigurasi AppFlow Anda saat ini

• Catat AppFlow ID Aplikasi, saluran yang ada, dan kunci tanda tangan.
• Eksport sejarah paket yang ingin Anda arsip.
• Jika Anda menggunakan GitHub Actions atau penyedia CI lainnya, jaga aliran pipa mereka—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 code native untuk kedua iOS dan Android; tidak ada bantuan JavaScript tambahan yang diperlukan.

Langkah 2 – Konfigurasi Minimal (tanpa bidang manual)

Block 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

Panduan 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 dashboard/API	Pengaturan override opsional; default berasal dari server. Lihat Target Versi untuk strategi multi-versi
autoUpdateMethod	autoUpdate: true	Dinonaktifkan secara default
maxVersions	Kebijakan Retensi	Dikonfigurasi secara sentral (1 bulan default, 24 bulan maksimum)
enabled	Tidak diperlukan	Capgo mengaktifkan ketersediaan per saluran

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

Pada panduan Ionic Anda menghubungkan sync, download, dan reload, kemudian 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 melakukan rollback bundle secara otomatis.

Itu saja—Capgo menghandle cek latar belakang, visibilitas layar splash, dan rollback 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 – Perbarui strategi terjemahan

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

Latar belakang (default)

• AppFlow: atur 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: pembaruan otomatis 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

• AppFlowMinta pengguna dan panggil reload().
• CapgoMarking bundle sebagai “wajib” di dashboard, kemudian dengarkan event (diterbitkan setelah majorAvailable ) untuk meminta atau memaksa pengguna di dalam aplikasi Anda. notifyAppReady()Langkah 5 – Membuat Peta __CAPGO_KEEP_0__

Judul bagian “Langkah 5 – Membuat Peta API”

__CAPGO_KEEP_0__ setara	Capgo equivalent	Dapat ditangani secara otomatis
LiveUpdates.sync()	__CAPGO_KEEP_0__’s auto-update asli berjalan tanpa panggilan sinkron manual	Capgo
LiveUpdates.download()	CapacitorUpdater.download()	Opsional untuk aliran kustom
LiveUpdates.reload()	CapacitorUpdater.set()	Opsional; pengaturan dashboard mengatur pembaruan paksa
LiveUpdates.getVersion()	CapacitorUpdater.current()	Opsi diagnostik

Langkah 6 – Deploy menggunakan Capgo CLI atau API

Selesaikan migrasi dengan mengunggah bundle dengan Capgo CLI atau API. Alur kerja mengikuti apa yang mungkin Anda tuliskan sebelumnya, tetapi sekarang termasuk keamanan asli:

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

Deploy versi tertentu (seperti AppFlow)

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

# 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

Lihat Petunjuk Target Versi untuk strategi menyeluruh.

Capgo secara otomatis:

• 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 latensi untuk 18 wilayah global di status.capgo.app/history.

Plugin perusahaan Ionic

If stack Anda Ionic juga menggunakan plugin bisnis, ikuti dokumen migrasi yang ditargetkan di bawah ini. Setiap panduan merekomendasikan penggantian Capgo dan langkah-langkah berikutnya.

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

Pertanyaan yang sering diajukan

Mengapa AppFlow menutup pembaruan hidup?

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

Berapa lama waktu migrasi?

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

Apakah kami akan menghemat uang?

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

Kapan kita harus memigrasikan?

Karena AppFlow saat ini dalam mode perawatan, memigrasikan lebih cepat memberikan akses ke inovasi Capgo yang berlangsung. Kami merekomendasikan mengganti saat 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 Target Versi - Menggali dalam strategi pencocokan versi AppFlow-style
• Perubahan Mendasar - Mengelola pembaruan versi utama dengan saluran
• Pengelolaan Saluran - Referensi lengkap konfigurasi saluran

Bantuan diperlukan?

• Booking Sesi Migrasi: book.capgo.app/demo
• Join Komunitas: Capgo Discord
• Track Masalah / Minta Fitur: github.com/Cap-go/capacitor-updater

Capgo dirancang untuk perusahaan yang memerlukan 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.

Teruskan dari Migrate dari AppFlow ke Capgo

Jika Anda menggunakan Migrate dari AppFlow ke Capgo untuk merencanakan migrasi dan operasi bisnis, hubungkannya dengan Capgo Bisnis untuk alur kerja produk di Capgo Bisnis, Alternatif Plugin Bisnis Ionic untuk alur kerja produk di Alternatif Plugin Bisnis Ionic, Capgo Alternatif untuk alur kerja produk di Capgo Alternatif, Capgo Konsultasi untuk alur kerja produk di Capgo Konsultasi, dan Capgo Layanan Premium untuk alur kerja produk di Capgo Layanan Premium.