Migrasi dari Capawesome Cloud ke Capgo

Copas prompt pengaturan dengan langkah instalasi dan panduan markdown lengkap untuk plugin ini.

⚡️ Capgo mengotomatisasi saluran, pembersihan paket, rollbacks, analisis, dan CLI unggah natively. Gunakan petunjuk ini untuk melakukan langkah-langkah minimal yang diperlukan untuk migrasi dan secara opsional mereproduksi perilaku kustom yang masih dibutuhkan.

Ringkasan

Kumpulkan konfigurasi Capawesome Cloud yang sudah ada (ID Aplikasi, saluran, kunci tanda tangan, CLI token) agar Anda dapat mengarsip atau memeriksa keabsahan konfigurasi tersebut kemudian.
Instal plugin Capgo, hapus Capawesome SDK, dan panggil CapacitorUpdater.notifyAppReady().
Konfigurasi perilaku opsional (download manual, pinning paket, reloads) jika Anda bergantung pada aliran tersebut saat ini.

Dengan Capgo Anda hanya perlu menginstal plugin kami dan panggil CapacitorUpdater.notifyAppReady()Semua yang lain—saluran, pembersihan paket, rollbacks, analisis, dan CLI otomatisasi—ditangani secara native. Bagian-bagian di bawah menjelaskan setiap tugas secara langsung.

Sebelum Anda memulai

Pastikan proyek Anda sudah menggunakan Capacitor 5 atau lebih baru.
Instal Capgo CLI (npm install -g @capgo/cli) jika Anda berencana untuk mengirim bundle dari CI/CD.

Langkah 1 – Instal Capgo dan hapus SDK Capawesome

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

Itu adalah satu-satunya penggantian wajib. Capgo’s native code sudah termasuk dalam plugin; tidak ada bantuan JavaScript tambahan yang diperlukan.

Langkah 2 – Konfigurasi minimal

Pengaturan sebelumnya memerlukan pemetaan puluhan pilihan dalam capacitor.config Capgo mengenali proyek Anda secara otomatis, sehingga konfigurasi minimal terlihat seperti ini:

import { CapacitorConfig } from '@capacitor/cli'

const config: CapacitorConfig = {
  plugins: {
    CapacitorUpdater: {
      autoUpdate: true,
      autoDeletePrevious: true,
      periodCheckDelay: 10 * 60 * 1000, // optional: check every 10 minutes
    },
  },
}

export default config

Semua opsi Capawesome yang disebutkan sebagai flag manual (defaultChannel, autoDeleteBundles, kebijakan penyimpanan, dll.) diatur melalui dashboard Capgo atau API. Anda hanya perlu mengganti kunci ini jika Anda ingin perilaku yang berbeda dari default Capgo.

Referensi cepat konfigurasi

Opsi Capawesome	Capgo setara	Apakah Anda perlu mengaturnya?
`appId`	Diperoleh dari dashboard Capgo setelah Anda membuat proyek	Hanya jika Anda menggunakan beberapa proyek dalam satu biner
`defaultChannel`	Aturan saluran diatur di dashboard/API	Dapat diatur; sebagian besar tim mengatur ini secara server-side
`autoDeleteBundles`	`autoDeletePrevious: true` (default)	Sudah diaktifkan
`publicKey`	Dipantau di Capgo console	Hanya jika Anda memutar kunci secara manual
`maxVersions` / penyimpanan	Kebijakan penyimpanan bundle	Dipasang secara sentral di Capgo (1 bulan default, 24 bulan maksimal)

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

Alur lama memperkenalkan pendengar (checkForUpdates(), retryDownload(), menyembunyikan layar splash, dll.). Capgo melakukan langkah-langkah tersebut secara native. Langkah API yang harus Anda panggil adalah:

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

CapacitorUpdater.notifyAppReady()

Langkah ini mengkonfirmasi bahwa aplikasi telah berjalan dengan sukses. Jika konfirmasi tidak pernah tiba, Capgo secara otomatis akan mengembalikan bundle—tidak perlu JavaScript tambahan.

Itu saja—Capgo mengelola pengecekan latar belakang, visibilitas layar splash, dan pengembalian secara native.

Opsional: jalankan logika kustom sebelum layar splash disembunyikan

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

CapacitorUpdater.addListener('appReady', () => {
  // Run diagnostics or logging if you need to
  SplashScreen.hide()
})

CapacitorUpdater.notifyAppReady()

Langkah 4 – Peta panggilan API (banyaknya opsional)

Pada Capgo Anda biasanya membiarkan auto-updater berjalan; API manual tetap tersedia jika Anda ingin mengontrol sepenuhnya.

Capawesome Cloud	Capgo equivalent	Apakah Anda membutuhkannya?
`LiveUpdate.fetchLatestBundle()`	`CapacitorUpdater.getLatest()`	Hanya ketika mengimplementasikan alur download sendiri
`LiveUpdate.downloadBundle()`	`CapacitorUpdater.download()`	Opsional: auto-update asli sudah mengunduh
`LiveUpdate.setNextBundle()`	`CapacitorUpdater.next()`	Opsional: dashboard menempel bundle secara otomatis
`LiveUpdate.reload()`	`CapacitorUpdater.reload()`	Opsional; Capgo memaksa bundle wajib setelah `notifyAppReady()`
`LiveUpdate.getCurrentBundle()`	`CapacitorUpdater.current()`	Diagnostics opsional

Jika Anda tetap dengan perilaku auto-update asli, Anda bisa menghapus JavaScript Capawesome secara keseluruhan.

Contoh kontrol manual

Unduh bundle terbaru

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

const downloadUpdate = async () => {
  const latest = await CapacitorUpdater.getLatest()
  if (latest?.url) {
    const bundle = await CapacitorUpdater.download({
      url: latest.url,
      version: latest.version,
    })
    console.log('Bundle downloaded', bundle?.id)
  }
}

import { LiveUpdate } from '@capawesome/capacitor-live-update'

const downloadUpdate = async () => {
  const result = await LiveUpdate.fetchLatestBundle()
  if (result.downloadUrl) {
    await LiveUpdate.downloadBundle({
      bundleId: result.bundleId,
      url: result.downloadUrl,
    })
    console.log('Bundle downloaded')
  }
}

Atur bundle selanjutnya

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

const setNextBundle = async () => {
  await CapacitorUpdater.next({ id: 'bundle-id-123' })
}

import { LiveUpdate } from '@capawesome/capacitor-live-update'

const setNextBundle = async () => {
  await LiveUpdate.setNextBundle({ bundleId: 'bundle-id-123' })
}

Terapkan bundle yang diunduh segera

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

const applyUpdate = async () => {
  await CapacitorUpdater.reload()
}

import { LiveUpdate } from '@capawesome/capacitor-live-update'

const applyUpdate = async () => {
  await LiveUpdate.reload()
}

Langkah 5 – Strategi pembaruan: bagaimana Capgo mengaturnya

Capawesome mendokumentasikan tiga strategi. Berikut ini adalah bagaimana mereka diinterpretasikan:

Pembaruan latar belakang

Alur kerja sebelumnya: atur di code dan jadwalkan download secara manual.
Capgo: diaktifkan secara default (autoUpdate: true). Tidak perlu code tambahan.

Situs web terbaru

Alur kerja sebelumnya: tambahkan App.resume pengendali, panggil download, kemudian set.
CapgoSitus web otomatis latar belakang telah melakukan periksa setelah resume. Anda hanya perlu pengendali manual jika Anda ingin interval kustom.

Opsional: periksa resume manual

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

App.addListener('resume', async () => {
  const latest = await CapacitorUpdater.getLatest()
  if (latest?.url) {
    const downloaded = await CapacitorUpdater.download({
      url: latest.url,
      version: latest.version,
    })
    if (downloaded) {
      await CapacitorUpdater.next({ id: downloaded.id })
    }
  }
})

Perbarui paksa

Alur kerja sebelumnya: logika prompt kabel dan memaksa reload.
Capgo: tandai bundle sebagai “wajib” di dashboard, lalu dengarkan event (diterbitkan setelah majorAvailable ) untuk meminta pengguna untuk mengupgrade di dalam aplikasi. notifyAppReady()Langkah 6 – Mengembangkan bundle

Judul bagian “Langkah 6 – Mengembangkan bundle”

, __CAPGO_KEEP_0__ menawarkan alur kerja __CAPGO_KEEP_1__ yang sama, dan Anda juga dapat mengautomasi pengembangan secara keseluruhan melalui __CAPGO_KEEP_2__. capawesome live-update deploy, Capgo offers a similar CLI workflow, and you can also automate deployments entirely via API.

# Authenticate once (stores a token in your CI environment)
capgo login

# Upload a new bundle (auto-detects platform/version)
capgo bundle upload --path dist --channel production

Because Capgo tracks bundle health automatically, you also get:

Log audit perangkat untuk setiap instalasi.
Penyimpanan otomatis (satu bulan secara default) dengan batasan yang dapat disesuaikan hingga 24 bulan.
Metrik latency waktu nyata di status.capgo.app/history.

Jadwal migrasi

Daftar inventori & instalasi: 10 menit (npm install), hapus plugin lama.
Konfigurasi & kesiapan: 5 menit (notifyAppReady).
Pemeriksaan kesadaran: 15 menit (opsional tes manual atau pengguna)
Pengembangan Pertama: 10 menit dengan Capgo CLI atau integrasi CI.

Dalam praktek tim selesai dalam kurun waktu kurang dari satu jam. Jika Anda menyediakan detail proyek Capawesome, kami bahkan dapat mengimport saluran dan daftar perangkat untuk Anda.

Capgo support

Migrasi Koncierge: buatlah janji pada cal.com/team/capgo/demo.
Komunitas: bergabunglah dengan Capgo Discord.
Laporan masalah: github.com/Cap-go/capacitor-updater/issues.

Capgo dirancang untuk keandalan jangka panjang: pembaruan delta asli, paket yang dienkripsi, pengembalian otomatis, dan analitis yang tidak memerlukan JavaScript khusus. Setelah Anda melakukan migrasi, Anda dapat menghapus perangkat lunak yang berat untuk perawatan dan biarkan platform melakukan pembaruan secara otomatis.