Migrate from Capawesome Cloud to Capgo

⚡️ Capgo 채널, 번들 정리, 롤백, 분석 및 CLI 업로드를 자동화합니다. 이 가이드를 사용하여 마이그레이션을 수행하고 옵션적으로 사용자 지정 동작을 다시 만들 필요가 있는 경우에만 최소한의 단계를 수행하세요.

개요

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

Capgo를 사용하기 위해 Capgo 에서 Capgo로 업그레이드하는 방법 CapacitorUpdater.notifyAppReady() Capgo를 사용하기 위해 CLI 에서 Capgo로 업그레이드하는 방법

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.config Capgo은 프로젝트를 자동으로 인식하므로 최소 구성은 다음과 같습니다.

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, autoDeleteBundles, 보존 정책 등)로 나열하는 모든 것은 Capgo 대시보드 또는 API에서 관리됩니다. Capgo의 기본값과 다른 동작을 원한다면 이 키를 오버라이드해야 합니다.

구성 빠른 참조

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

Step 3 – __CAPGO_KEEP_0__ 호출 notifyAppReady() (필수적인 유일한 hook)

__CAPGO_KEEP_0__의 이전 워크플로에서 사용자 정의 리스너 (checkForUpdates(), retryDownload(), 스플래시 화면을 숨기기 등)를 숨겼습니다. Capgo은 이 작업들을 내부적으로 수행합니다. API을 호출해야 하는 유일한 것은:

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

CapacitorUpdater.notifyAppReady()

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

그것이 다입니다. 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()	자체 다운로드 워크플로우를 implement하는 경우에만
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_KEEP_0__

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_KEEP_0__

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을 구성하고 다운로드를 수동으로 예약합니다.
• Capgo: 기본적으로 활성화됩니다.autoUpdate: true. No additional code required.

최신 버전

• 이전 워크플로우: add an App.resume 리스너를 추가하고 download, 그리고 set.
• Capgo: 백그라운드 자동 업데이트 already performs the check after resume. You only need the manual listener if you want a custom interval.

선택 사항: 수동 재개 확인

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.
• Capgo: Capgo로 PR 제출하는 중입니다. majorAvailable : 마크다운을 "필수"로 표시하고, notifyAppReady()이벤트 (

)를 듣고 사용자가 앱 내에서 업그레이드하도록 요구합니다.

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.

업그레이드 일정

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

Page/area: Capgo Builder / native cloud build product page. Role: Short UI label or navigation item. Message key `native_build_builder_credit_first` (Native Build Builder Credit First).

: 10분 Capgo __CAPGO_KEEP_1__ 또는 CI 통합.

• __CAPGO_KEEP_0__ 지원__CAPGO_KEEP_0__ 지원 섹션 book.capgo.app/demo.
• : __CAPGO_KEEP_0__를 위한 세션을 예약하세요. : Capgo에 가입하세요. Capgo 디스코드.
• 이슈 추적기: github.com/Cap-go/capacitor-업데이터터/issues.

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

Keep going from Migrate from Capawesome Cloud to Capgo

Capgo로의 Capawesome Cloud에서 계속하세요 Migrate from Capawesome Cloud to Capgo Capgo로의 Capawesome Cloud에서 계속하세요 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 액션 통합 GitHub 액션 통합