Migrate from Capawesome Cloud to Capgo

⚡️ Capgo 채널, 번들 정리, 롤백, 분석 및 CLI natively 업로드를 자동화합니다. 이 가이드를 사용하여 마이그레이션을 수행하고 옵션적으로 재생성해야 하는 모든 사용자 지정 동작을 다시 만들 수 있습니다.

개요

1. 이전 Capawesome Cloud 구성 (App ID, 채널, 서명 키, CLI 토큰)을 모아 아카이브하거나 감사할 수 있도록 하세요.
2. Capgo 플러그인을 설치하고 Capawesome SDK을 제거한 다음 CapacitorUpdater.notifyAppReady().
3. 선택적 동작을 구성 (수동 다운로드, 번들 핀, 리로드)หาก 오늘날의 흐름에 의존합니다.

Capgo를 사용하기 위해서는 Capgo 에서 Capgo로 업그레이드하는 것만 하면 됩니다. CapacitorUpdater.notifyAppReady() Capgo를 사용하기 위해서는 CLI 에서 Capgo로 업그레이드하는 것만 하면 됩니다. Capgo는 Capawesome의 모든 기능을 지원합니다.

Capgo를 사용하기 위해서는 __CAPGO_KEEP_0__ 에서 Capgo로 업그레이드하는 것만 하면 됩니다.

• Capgo를 사용하기 위해서는 Capacitor 에서 Capgo로 업그레이드하는 것만 하면 됩니다.
• Install the Capgo CLI (npm install -g @capgo/cli Capgo를 사용하기 위해서는 __CAPGO_KEEP_0__ 에서 Capgo로 업그레이드하는 것만 하면 됩니다.

Step 1 – Install Capgo and remove the Capawesome SDK

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

That is the only mandatory swap. Capgo’s native code ships with the plugin; no extra JavaScript helpers are required.

2단계 – 최소 구성

이전 설정에서는 수십 개의 옵션을 매핑해야했습니다. capacitor.configCapgo은 프로젝트를 자동으로 인식하므로 최소 구성은 다음과 같습니다.

capacitor.config.ts

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

Capawesome이 수동 플래그 (defaultChannel, autoDeleteBundlesretention 정책 등)로 나열하는 모든 것은 Capgo 대시보드 또는 API에서 관리됩니다. 이 키를 오버라이드해야만 Capgo의 기본값과 다른 동작을 원할 경우입니다.

구성 빠른 참조

Capawesome 옵션	Capgo 동등 항목	이러한 기능을 사용하려면 설정을 해야 하나요?
appId	Capgo 프로젝트를 생성한 후에 가져옵니다.	하나의 바이너리에 여러 프로젝트를 사용하는 경우에만
defaultChannel	API 대시보드에서 채널 규칙을 관리합니다.	대부분의 팀은 서버 측에서 이 옵션을 설정합니다.
autoDeleteBundles	autoDeletePrevious: true (기본값)	이미 활성화되어 있습니다.
publicKey	Capgo 콘솔에서 관리합니다.	키를 수동으로 회전하는 경우에만
maxVersions /retention	Bundle 보존 정책	기본값은 1개월이며, 최대 24개월로 Capgo에서 중앙에서 관리합니다.

Step 3 – 앱 준비 콜백 함수 호출 notifyAppReady() (필수적인 hook)

기존 워크플로우는 사용자 정의 리스너 (checkForUpdates(), retryDownload(), 스플래시 화면 숨기기 등)를 숨겼습니다. Capgo은 이 작업들을 내장된 기능으로 처리합니다. API을 호출해야 하는 유일한 단계는:

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

CapacitorUpdater.notifyAppReady()

이것은 앱이 성공적으로 부팅되었음을 확인합니다. 확인이 절대 오지 않으면 Capgo은 자동으로 번들 롤백—추가 JavaScript가 필요하지 않습니다.

그것이 다입니다—Capgo은 배경 검사, 스플래시 화면 표시, 롤백을 내장된 기능으로 처리합니다.

선택 사항: 스플래시 화면이 숨기기 전에 사용자 정의 로직 실행

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

Step 4 – API 콜백 함수 매핑 (대부분 선택 사항)

일반적으로 Capgo에서 자동 업데이터를 실행합니다. 만약 전체 제어를 원한다면 수동 API가 여전히 사용 가능합니다.

Capawesome Cloud	Capgo 동등한 항목	필요한가요?
LiveUpdate.fetchLatestBundle()	CapacitorUpdater.getLatest()	자체 다운로드 워크플로우를 구현할 때만
LiveUpdate.downloadBundle()	CapacitorUpdater.download()	선택 사항: 네이티브 자동 업데이트가 이미 다운로드를 진행합니다.
LiveUpdate.setNextBundle()	CapacitorUpdater.next()	선택 사항: 대시보드가 자동으로 패키지를 핀합니다.
LiveUpdate.reload()	CapacitorUpdater.reload()	선택 사항; Capgo은 필수 패키지를 Capgo이 강제합니다. notifyAppReady()
LiveUpdate.getCurrentBundle()	CapacitorUpdater.current()	선택 사항: 진단

네이티브 자동 업데이트를 유지하고 싶다면 Capawesome JavaScript를 완전히 삭제할 수 있습니다.

수동 제어 예시

최신 버전의 패키지를 다운로드하세요.

Capgo

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

다음 버전의 패키지를 설정하세요.

Capgo

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

다운로드한 패키지를 즉시 적용하세요.

Capgo

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

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

Capawesome Cloud

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

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

Capgo 업데이트 전략: Capgo이 어떻게 처리하는지

Capawesome은 3가지 전략을 문서화했습니다. 그들은 어떻게 변환되는지 알아보겠습니다.

배경 업데이트

• 이전 워크플로code을 code에 구성하고 다운로드를 수동으로 스케줄링합니다.
• Capgo: 기본적으로 활성화됩니다.autoUpdate: true. No additional code required.

최근 버전

• 이전 워크플로우: add an App.resume 리스너를 추가하고 download: set.
• Capgocontext

이전 워크플로우

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

선택 사항: 수동 재개 실행 확인

• 이전 워크플로우: wire prompt logic and enforce reload.
• CapgoCapgo로 PR 제출 majorAvailable : Capgo 대시보드에서 패키지를 "필수"로 표시하고, notifyAppReady()이벤트 ( Capgo에서 패키지 업그레이드 후에 발생하는 이벤트)를 듣습니다.

업그레이드 이벤트

Section titled “Step 6 – 배포 패키지” 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

Capgo는 Capgo이 자동으로 패키지 상태를 모니터링하기 때문에 다음도 제공됩니다.

• 장치 수준의 설치 로그
• 기본 1달의 자동 보존(24달까지 설정 가능)
• 실시간 지연 시간 지표 status.capgo.app/history.

Capgo 마이그레이션 타임라인

• 10분 (기존 플러그인 제거)설정 및 준비npm install__CAPGO_KEEP_0__의 상태.app/history
• status.__CAPGO_KEEP_0__.app/history 분 (notifyAppReady).
• 정상 체크15 분 (선택적 수동 테스트 또는 리스너).
• 첫 번째 배포: 10 minutes with Capgo CLI or CI integration.

10 분 __CAPGO_KEEP_0__ __CAPGO_KEEP_1__ 또는 CI 통합.

Capgo support

• __CAPGO_KEEP_0__ 지원 섹션이주 콘시어지 book.capgo.app/demo.
• book.__CAPGO_KEEP_0__.app/demo에서 세션을 예약하세요. : 분 (: Capgo에 가입하세요. Capgo Discord.
• 이슈 추적기: github.com/Cap-go/capacitor-updater/issues.

Capgo은 장기적인 신뢰성을 위해 설계되었습니다: 원본 델타 업데이트, 암호화된 패키지, 자동 롤백, 그리고 사용자 정의 JavaScript가 필요하지 않은 분석입니다. Capawesome에서 마이그레이션한 후에는 유지보수가 많이 필요한 접착제를 삭제하고 플랫폼이 자동으로 업데이트되도록 하세요.

Keep going from Migrate from Capawesome Cloud to Capgo

Capawesome Cloud에서 Capgo로 마이그레이션하기 Migrate from Capawesome Cloud to Capgo Capawesome Cloud에서 Capgo로 마이그레이션하기 Capgo CI/CD for the product workflow in Capgo CI/CD, Capgo Native Builds Capgo 제품 워크플로우에 대한 Capgo Native Builds Capgo 통합 Capgo 제품 워크플로우에 대한 Capgo 통합 CI/CD 통합 CI/CD 통합에 대한 구현 세부 정보 GitHub 액션 통합 for the implementation detail in GitHub Actions Integration.