Capawesome Cloud에서 Capgo로 이동하세요

⚡️ Capgo 채널, 번들 정리, 롤백, 분석 및 CLI 업로드를 자동화합니다.

Overview

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

Capgo을 사용하면 플러그인을 설치하고 호출하는 것만 필요합니다. 모든 것이—채널, 번들 정리, 롤백, 분석 및 Capgo 자동화—자연스럽게 처리됩니다. 아래 섹션은 각 작업을 직접 안내합니다. CapacitorUpdater.notifyAppReady(). Everything else—channels, bundle cleanup, rollbacks, analytics, and CLI automation—is handled natively. The sections below walk through each task directly.

“시작하기 전에”라는 제목의 섹션

• 프로젝트가 Capacitor 5 이상을 사용 중인지 확인하세요.
• Capgo CLI (npm install -g @capgo/cli)

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.

__CAPGO_KEEP_0__의 내장 __CAPGO_KEEP_1__은 플러그인을 포함하고 있으므로 추가적인 JavaScript 도우미가 필요하지 않습니다.

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가 수동 플래그로 나열하는 모든 것 (retention policies, etc.)은 __CAPGO_KEEP_0__ 대시보드 또는 __CAPGO_KEEP_1__를 통해 관리됩니다. __CAPGO_KEEP_2__의 기본값과 다른 동작을 원한다면만 이 키를 오버라이드해야 합니다.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_0__ 동등 항목	Capgo equivalent	__CAPGO_KEEP_0__ 대시보드에서 프로젝트를 생성한 후 가져옵니다
appId	Taken from the Capgo dashboard once you create a project	__CAPGO_KEEP_0__ 대시보드 또는 대시보드에서 채널 규칙을 관리합니다.
defaultChannel	API 대시보드 또는 대시보드에서 채널 규칙을 관리합니다.	선택 사항; 대부분의 팀은 서버 측에서 설정합니다.
autoDeleteBundles	autoDeletePrevious: true (기본)	이미 활성화됨
publicKey	Capgo 콘솔에서 관리	만약 키를 수동으로 회전한다면
maxVersions / 보관	Bundle 보관 정책	Capgo에서 중앙 관리 (기본 1 개월, 최대 24 개월)

Step 3 – Call notifyAppReady() (필수 hook 중 하나)

기존 워크플로우에서는 사용자 지정 리스너를 소개했습니다.checkForUpdates(), retryDownload()Capgo은 스플래시 화면을 숨기기와 같은 작업을 원시적으로 수행합니다. 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()

4단계 – API 호출을 맵핑하세요 (대부분 선택 사항)

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

Capawesome Cloud	Capgo의 동등한 항목	필요합니까?
LiveUpdate.fetchLatestBundle()	CapacitorUpdater.getLatest()	자체 다운로드 워크플로를 구현할 때만
LiveUpdate.downloadBundle()	CapacitorUpdater.download()	옵션: 네이티브 자동 업데이트 이미 다운로드
LiveUpdate.setNextBundle()	CapacitorUpdater.next()	옵션: 대시보드가 자동으로 패키지를 핀
LiveUpdate.reload()	CapacitorUpdater.reload()	옵션; 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)
  }
}

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_KEEP_0__ 설정

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

Capgo는 업데이트 전략을 어떻게 처리하는지 알아보세요

__CAPGO_KEEP_0__ 업데이트 전략은 Capawesome에서 3가지로 문서화되었습니다. 그들은 어떻게 변환되는지 알아보겠습니다.

배경 업데이트

• 이전 워크플로우code을 code에 구성하고 수동으로 다운로드를 스케줄링합니다.
• Capgo__CAPGO_KEEP_0__은 기본적으로 활성화되어 있습니다 (autoUpdate: true). No additional code required.

Always latest

• 이전 워크플로우: 추가 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_KEEP_0__을 대시보드에서 "필수"로 표시하고, majorAvailable 이벤트 (배포 후에 notifyAppReady())를 듣기 시작하여 앱 내에서 사용자에게 업그레이드하도록 요구합니다.

Step 6 – 배포

이전에는 capawesome live-update deploy, Capgo은 CLI과 유사한 워크플로를 제공하며, 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은 자동으로 배포 패키지의 상태를 추적하기 때문에,

• 장치별 설치 로그를 제공합니다.
• 기본 1개월, 최대 24개월까지 설정 가능한 자동 보존 기간이 있습니다.
• 실시간 지연 지표 status.capgo.app/history.

이동 계획

• 인벤토리 및 설치: 10 분 (npm install, 이전 플러그인을 제거합니다.
• 설정 및 준비: 5 분 (notifyAppReady).
• 정상성 검사: 15 분 (선택적 수동 테스트 또는 리스너).
• 첫 번째 배포: 10 minutes with Capgo CLI or CI 통합.

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

Capgo 지원

• 이동 매니저: __CAPGO_KEEP_0__ 세션을 예약하세요. book.capgo.app/demo.
• 커뮤니티: __CAPGO_KEEP_0__ 디스코드에 가입하세요. Capgo Discord.
• __CAPGO_KEEP_0__.com/Cap-go/__CAPGO_KEEP_1__-업데이터/issues: github.com/Cap-go/capacitor-updater/issues.

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

Capawesome Cloud에서 Capgo으로 계속 진행하세요.

__CAPGO_KEEP_0__을 사용 중이라면 Capawesome Cloud에서 Capgo으로 마이그레이션하세요. CI/CD 자동화 계획을 위해 연결하세요. Capgo CI/CD Capgo CI/CD에서 제품 워크플로우를 위해 Capgo Native Builds Capgo Native Builds에서 제품 워크플로우를 위해 Capgo Integrations Capgo Integrations에서 제품 워크플로우를 위해 CI/CD 통합 CI/CD 통합 구현 세부 사항에 대해, 그리고 GitHub 액션 통합 GitHub 액션 통합 구현 세부 사항에 대해.