Capawesome Cloud에서 Capgo로 이동

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

개요

1. CLI 토큰, App ID, 채널, 서명 키, CLI 토큰을 모아.archive 또는 audit를 위해 나중에 사용할 수 있도록 하세요.
2. Capgo 플러그인을 설치하고 Capawesome SDK을 제거한 후 CapacitorUpdater.notifyAppReady().
3. 선택적 동작을 구성(수동 다운로드, 번들 핀, 리로드)หาก 오늘날의 흐름에 의존한다면.

Capgo을 사용하면 플러그인을 설치하고 호출하는 것만 필요합니다. 모든 것이—채널, 번들 정리, 롤백, 분석 및 Capgo 자동화—Capgo 플러그인을 설치하고 호출하는 것만 필요합니다. 모든 것이—채널, 번들 정리, 롤백, 분석 및 Capgo 자동화—are natively handled. 아래의 섹션은 각 작업을 직접_walk through합니다. CapacitorUpdater.notifyAppReady()CLI

시작하기 전에

• Capacitor 5 이상이 이미 프로젝트에 사용되어야 합니다.
• Capgo CLI (npm install -g @capgo/cli)을 설치해야 CI/CD에서 번들을 푸시할 계획이면.

Step 1 – Capgo 설치 및 Capawesome SDK 제거

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

Capgo의 내장 code는 플러그인과 함께 제공되며, 추가 JavaScript 도우미가 필요하지 않습니다.

Step 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, retention policies, etc.) is managed through the Capgo dashboard or API. You only need to override these keys if you want behaviour that differs from Capgo’s defaults.

만약 __CAPGO_KEEP_2__의 기본값과 다른 동작을 원한다면, 이 키를 오버라이드해야합니다.

구성 빠른 참조 섹션	Capgo equivalent	__CAPGO_KEEP_0__ 동등 항목
appId	Taken from the Capgo dashboard once you create a project	다중 프로젝트를 하나의 바이너리에 사용하는 경우에만
defaultChannel	API 대시보드에서 채널 규칙 관리	선택적; 대부분의 팀이 서버 측에서 설정
autoDeleteBundles	autoDeletePrevious: true (기본값)	이미 활성화됨
publicKey	Capgo 콘솔에서 관리	키를 수동으로 회전하는 경우에만
maxVersions / 보존	번들 보존 정책	Capgo (기본 1 개월, 최대 24 개월)에서 중앙으로 구성

Step 3 - 호출 notifyAppReady() (단 하나의 필수 훅)

기존 워크플로우는 커스텀 리스너 (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 함수 호출 매핑하기 (선택 사항)

In Capgo you normally let the auto-updater run; manual APIs remain available if you want full control.

Step 4 – __CAPGO_KEEP_0__ 함수 호출 매핑하기 (선택 사항)	Capgo equivalent	__CAPGO_KEEP_0__ 필요합니까?
LiveUpdate.fetchLatestBundle()	CapacitorUpdater.getLatest()	__CAPGO_KEEP_0__만 사용자가 직접 다운로드 워크플로우를 구현할 때
LiveUpdate.downloadBundle()	CapacitorUpdater.download()	__CAPGO_KEEP_0__: 네이티브 자동 업데이트 기능이 이미 다운로드를 처리합니다.
LiveUpdate.setNextBundle()	CapacitorUpdater.next()	__CAPGO_KEEP_0__: 대시보드가 자동으로 패키지를 핀합니다.
LiveUpdate.reload()	CapacitorUpdater.reload()	Capgo: Capgo이 필수 패키지를 강제로 다운로드합니다. notifyAppReady()
LiveUpdate.getCurrentBundle()	CapacitorUpdater.current()	__CAPGO_KEEP_0__

__CAPGO_KEEP_0__를 사용하지 않으면 네이티브 자동 업데이트 기능을 사용할 수 있습니다. 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)
  }
}

Capawesome Cloud

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

Capawesome Cloud

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

5단계 - 업데이트 전략: Capgo이 어떻게 처리하는가

Capawesome은 세 가지 전략을 문서화합니다. 그들은 어떻게 번역되는지 알아보겠습니다.

배경 업데이트

• 이전 워크플로우code을 code에 구성하고 다운로드를 수동으로 예약합니다.
• Capgo__CAPGO_KEEP_0__autoUpdate: truecode이 기본적으로 활성화되어 있습니다 (

항상 최신

• 이전 워크플로우: 추가 App.resume 리스너, 호출 download, 그런 다음 set.
• Capgo: 백그라운드 자동 업데이트 이미 재개 후 확인을 수행합니다. 만약 사용자 정의 간격을 원한다면 수동 리스너가 필요합니다.

선택 사항: 수동 재개 확인

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_KEEP_0__을 마크하고, __CAPGO_KEEP_0__이 발생한 후에 발생하는 이벤트를 듣습니다. majorAvailable Step 6 – 배포 패키지 notifyAppReady()배포 패키지의 6 단계

이전에는 __CAPGO_KEEP_0__에 의존하셨다면, __CAPGO_KEEP_1__과 유사한 __CAPGO_KEEP_0__ 워크플로우를 제공하고, __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:

• 장치 수준의 설치 로그를 위한 감사 로그.
• 자동 보관 (기본 1 개월) 및 24 개월까지의 구성 가능한 제한.
• 실시간 지연성 지표 at status.capgo.app/history.

이동 계획

• 장치 목록 및 설치: 10 분 (npm install: 5 분 (
• 설정 및 준비정상성 검사notifyAppReady).
• 이동 계획: 15 minutes (optional manual tests or listeners).
• 첫 번째 배포: 10 minutes with Capgo CLI or CI 통합.

실제로 팀은 1시간 이내에 완료합니다. Capawesome 프로젝트 세부 정보를 제공하면 채널과 장치 목록을 임포트해 주실 수 있습니다.

Capgo 지원

• 이동 매니저: __CAPGO_KEEP_0__ 데모 세션을 예약하세요. cal.com/team/capgo/demo.
• 커뮤니티: __CAPGO_KEEP_0__ 디스코드에 가입하세요. cal.com/team/Capgo/demo.
• 이슈 추적기: github.com/Cap-go/capacitor-업데이터/issues.

Capgo는 장기적인 신뢰성을 위해 설계되었습니다: 원시 델타 업데이트, 암호화된 번들, 자동 롤백, 그리고 사용자 정의 자바스크립트가 필요하지 않은 분석입니다. 이주 후에는 유지보수-heavy 접착제를 삭제하고 플랫폼이 자동으로 업데이트를 실행할 수 있도록 해주세요.