Migrate dari AppFlow ke Capgo

🚦 Ionik mengumumkan bahwa produk komersial AppFlow—termasuk Live Updates—sedang berakhir. 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 membantu Anda melalui aksi yang diperlukan untuk migrasi ke Capgo dan menyoroti otomatisasi native yang Anda dapatkan.

Panduan Migrasi

Capgo mengelola saluran, penyimpanan bundle, pengembalian ke versi sebelumnya, analitis, dan CLI upload untuk Anda. Migrasi dapat diartikan sebagai instalasi plugin, memanggil CapacitorUpdater.notifyAppReady(), dan—jika diinginkan—mengonfigurasi kontrol manual opsional. Bagian-bagian di bawah ini akan menjelaskan setiap tugas secara langsung.

Pengaturan 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 Pengaturan Versi Bagian berjudul ‘Pengaturan Versi Seperti AppFlow’ Untuk strategi rinci mengelola pembaruan di berbagai versi aplikasi.

Langkah 0 – Tangkap konfigurasi AppFlow saat ini

• Catat AppFlow ID Aplikasi, saluran yang ada, dan kunci tanda tangan.
• Export riwayat bundle yang ingin Anda arsipkan.
• 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 native code untuk 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:

Konfigurasi capacitor.config.ts

import { CapacitorConfig } from '@capacitor/cli'

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

export default config

Referensi Konfigurasi Cepat

Pengaturan Ionic AppFlow	Capgo setara	Apakah Anda perlu mengatur itu?
appId	Dikelola di dashboard Capgo	Diatur secara otomatis ketika Anda membuat proyek
channel / defaultChannel	Aturan saluran di dashboard/API	Override opsional; default datang dari server. Lihat Target Versi strategi multi-versi
autoUpdateMethod	autoUpdate: true	untuk strategi multi-versi
maxVersions	Diaktifkan secara default	Ditentukan secara pusat (1 bulan default, maksimal 24 bulan)
enabled	Tidak diperlukan	Capgo mengaktifkan atau menonaktifkan saluran

__CAPGO_KEEP_0__ mengatur ketersediaan per saluran notifyAppReady() Langkah 3 – Panggilan (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 akan mengembalikan bundle secara otomatis.

Selesai—Capgo menghandle periksa latar belakang, visibilitas layar splash, dan pengembalian 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 – Strategi pembaruan yang diterjemahkan

Document AppFlow menjelaskan tiga strategi. Berikut adalah bagaimana mereka menerjemahkan ke Capgo:

Latar Belakang (default)

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

Selalu Terbaru

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

Pemeriksaan Resume Manual (opsional)

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 })
  }
})

Salin ke clipboard

• AppFlowTanya pengguna dan panggil reload().
• CapgoMaka tandai bundle tersebut sebagai “wajib” di dashboard, kemudian dengarkan untuk majorAvailable event (diterbitkan setelah) notifyAppReady()Untuk meminta atau memaksa pengguna di dalam aplikasi Anda.

Langkah 5 – Membuat Peta API

Metode AppFlow	Sama dengan Capgo	Apakah Anda membutuhkannya?
LiveUpdates.sync()	Dapat diatasi secara otomatis	Capgo’s auto-update asli berjalan tanpa panggilan sinkron manual
LiveUpdates.download()	CapacitorUpdater.download()	Opsional untuk aliran kustom
LiveUpdates.reload()	CapacitorUpdater.set()	Opsional; pengaturan dashboard menghandle pembaruan paksa
LiveUpdates.getVersion()	CapacitorUpdater.current()	Opsional diagnostik

Langkah 6 – Menggunakan Capgo CLI atau API

Selesaikan migrasi dengan mengunggah bundle menggunakan Capgo CLI atau API. Alur kerja ini meniru apa yang Anda skrip sebelumnya, tetapi sekarang termasuk keamanan asli:

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

Penyebaran versi tertentu (seperti AppFlow)

Jika Anda perlu menargetkan versi native tertentu (mirip dengan penguncian versi native 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 Petunjuk Target Versi untuk strategi yang komprehensif.

Capgo secara otomatis:

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

Plugin Ionic Enterprise

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

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

Frequently asked questions

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 khusus.

Berapa lama waktu migrasi?

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

Apa yang kami dapat dari segi biaya?

Ya. Pembaruan hidup AppFlow dimulai dari $499/bulan. Capgo dimulai dari $14/bulan 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 kami harus memigrasikan?

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

Sumber Daya Tambahan

• Panduan Target Versi - Mencari Lebih dalam Strategi Matching Versi AppFlow
• Pembaharuan Versi - Mengelola Perbaruan Versi Besar dengan Saluran
• Pengelolaan Saluran - Referensi Konfigurasi Saluran Lengkap

Butuh Bantuan?

• Judul Bagian “Memerlukan Bantuan?” Buku.capgo.app/demo
• Bergabunglah dengan komunitas: Capgo Discord
• Pantau 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 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 perusahaan, hubungkannya dengan Capgo Enterprise untuk alur kerja produk di Capgo Enterprise, Alternatif Plugin Ionic Enterprise untuk alur kerja produk di Alternatif Ionic Enterprise Plugin, Alternatif Capgo untuk alur kerja produk di Alternatif Capgo, Capgo Konsultasi untuk alur kerja produk di Capgo Konsultasi, dan Capgo Layanan Premium untuk alur kerja produk di Capgo Layanan Premium.