Migrasi dari Cloud Capawesome ke Capgo

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

⚡️ Capgo otomatisasi saluran, penghapusan bundle, rollbacks, analisis, dan CLI unggah natively. Gunakan panduan ini untuk melakukan langkah-langkah minimal yang diperlukan untuk migrasi dan secara optional menciptakan perilaku kustom yang masih dibutuhkan.

Ringkasan

Kumpulkan konfigurasi Capawesome Cloud yang sudah ada (ID Aplikasi, saluran, kunci tanda tangan, CLI token) sehingga Anda dapat mengarsip atau memantau kemudian.
Instal plugin Capgo, hapus Capawesome SDK, dan panggil CapacitorUpdater.notifyAppReady().
Konfigurasi perilaku optional (download manual, pin bundle, reload) jika Anda bergantung pada aliran tersebut saat ini.

Dengan Capgo Anda hanya perlu menginstal plugin kami dan panggil CapacitorUpdater.notifyAppReady()Semua yang lain—saluran, penghapusan bundle, rollbacks, analisis, dan CLI otomatisasi—ditangani secara native. Bagian-bagian di bawah ini 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

Swap yang hanya wajib adalah itu. Capgo’s native code sudah termasuk dalam plugin; tidak ada bantuan JavaScript tambahan yang diperlukan.

Langkah 2 – Konfigurasi minimal

Konfigurasi 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 flag manual yang disebutkan oleh Capawesome (defaultChannel, autoDeleteBundles, kebijakan penyimpanan, dll.) diatur melalui dashboard Capgo atau API. Anda hanya perlu mengganti kunci-kunci ini jika Anda ingin perilaku yang berbeda dari default Capgo.

Referensi cepat konfigurasi

Opsi Capawesome	Capgo yang setara	Apakah Anda perlu mengatur itu?
`appId`	Diperoleh dari dashboard Capgo setelah Anda membuat proyek	Hanya jika Anda menggunakan beberapa proyek dalam satu biner
`defaultChannel`	Aturan saluran yang diatur di dashboard/API	Opsional; kebanyakan tim mengatur ini di sisi server
`autoDeleteBundles`	`autoDeletePrevious: true` (default)	Sudah diaktifkan
`publicKey`	Dikelola di konsol Capgo	Hanya jika Anda memutar kunci secara manual
`maxVersions` / penyimpanan	Pengaturan penyimpanan bundle	Dikonfigurasi secara sentral di Capgo (1 bulan default, 24 bulan maksimal)

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

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

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

CapacitorUpdater.notifyAppReady()

Perlu diingat bahwa aplikasi telah berhasil dijalankan. Jika konfirmasi tidak pernah tiba, Capgo secara otomatis akan mengembalikan bundle—tidak perlu tambahan JavaScript.

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 API (paling tidak opsional)

Dalam Capgo Anda biasanya membiarkan auto-updater berjalan; API manual tetap tersedia jika Anda ingin memiliki kontrol penuh.

Cloud Capawesome	Capgo setara	Apakah Anda membutuhkannya?
`LiveUpdate.fetchLatestBundle()`	`CapacitorUpdater.getLatest()`	Hanya ketika menerapkan 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 dapat menghapus Capawesome JavaScript 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 berikutnya

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 secara langsung

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 mengelola mereka

Capawesome mendokumentasikan tiga strategi. Berikut ini cara mereka diinterpretasikan:

Pembaruan latar belakang

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

Semua versi terbaru

Alur kerja sebelumnya: tambahkan App.resume listener, panggil download, lalu set.
Capgo: pembaruan otomatis di latar belakang sudah melakukan periksa setelah resume. Anda hanya perlu listener manual jika ingin interval kustom.

Pilihan: 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: hubungkan logika prompt dan laksanakan reload.
Capgo: tandai bundle sebagai “wajib” di dashboard, kemudian dengarkan event (diterbitkan setelah majorAvailable Step 6 – Mengirimkan bundle notifyAppReady()Jika Anda sebelumnya bergantung pada

, __CAPGO_KEEP_0 menawarkan alur kerja CAPGO_KEEP_1 yang sama, dan Anda juga dapat mengautomatisasi pengiriman secara keseluruhan melalui CAPGO_KEEP_2__.

Salin ke clipboard 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:

Step 6 – Mengirimkan bundle
Section titled “Step 6 – Mengirimkan bundle”
Metrik ketidaktelanjaran 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 (uji coba manual opsional atau pemantauan).
Deployan pertama: 10 menit dengan Capgo CLI atau integrasi CI.

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

Capgo support

Migrasi concierge: buatlah sesi di buku.capgo.app/demo.
Komunitas: bergabunglah dengan Capgo Discord.
Peta masalah: github.com/Cap-go/capacitor-updater/issues.

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

Teruskan dari Migrasi dari Capawesome Cloud ke Capgo

Jika Anda menggunakan Migrasi dari Capawesome Cloud ke Capgo untuk merencanakan otomatisasi CI/CD, hubungkannya dengan Capgo CI/CD untuk alur kerja produk di Capgo CI/CD, Capgo Pembangunan Asli untuk alur kerja produk di Capgo Pembangunan Asli, Capgo Integrasi untuk alur kerja produk di Capgo Integrasi, Integrasi CI/CD untuk detail implementasi dalam Integrasi CI/CD, dan GitHub Integrasi Aksi untuk detail implementasi dalam GitHub Integrasi Aksi.