Migrate from Capawesome Cloud to Capgo

이 플러그인의 설치 단계와 전체 마크다운 가이드를 포함한 설정 명령어를 복사하세요.

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

개요

Capawesome Cloud 설정을 아카이브하거나 감사하기 위해 App ID, 채널, 서명 키, CLI 토큰을 모아보세요.
Capawesome SDK을 제거하고 Capgo 플러그인을 설치하세요. CapacitorUpdater.notifyAppReady().
만약 현재 그 흐름에 의존한다면, 수동 다운로드, 패키지 핀, 리로드와 같은 옵션 설정을 구성하세요.

Capgo로 업그레이드하는 경우에 Capgo를 사용하면 플러그인을 설치하고 호출하는 것만으로 충분합니다. CapacitorUpdater.notifyAppReady()모든 다른 작업—채널, 패키지 정리, 롤백, 분석, 그리고 CLI 자동화—are natively 처리됩니다. 아래 섹션은 각 작업을 직접 안내합니다.

페이지/영역: Capgo 솔루션 마케팅 페이지. 역할: UI 레이블. 표시되는 곳: page solutions/webapp-to-mobile.astro. 메시지 키 `solutions_webapp_to_mobile_source_label` (Solutions Webapp To Mobile Source Label).

프로젝트가 이미 Capacitor 5 이상 버전을 사용하고 있는지 확인하세요.
CI/CD에서 패키지를 푸시할 계획이라면 Capgo CLI (npm install -g @capgo/cliCI/CD에서 패키지를 푸시할 계획이라면.

Step 1 – Install Capgo and remove the Capawesome SDK

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

이것이 유일한 필수적인 교체입니다. Capawesome의 Capgo는 Capgo의 code와 함께 플러그인과 함께 제공되며, 추가 JavaScript 도우미가 필요하지 않습니다.

Step 2 – 최소한의 구성

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

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의 Capgo 대시보드 또는 API를 통해 관리됩니다. 이러한 키를 오버라이드하려면 Capgo의 기본값과 다른 동작을 원할 때만 필요합니다.

설정 빠른 참조

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

Step 3 – Capgo로 호출하기 `notifyAppReady()` 역할: UI 레이블. 페이지: Capgo에 대한 페이지. seen in: about.astro에 대한 페이지.

Step 3 – Call notifyAppReady() (필수 hook 중 하나)checkForUpdates(), retryDownload(), 스플래시 화면을 숨기고 등등을 수행합니다. Capgo은 해당 단계를 원시적으로 수행합니다. API을 호출해야 하는 유일한 API은

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

CapacitorUpdater.notifyAppReady()

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

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

선택 사항: 스플래시 화면이 사라지기 전에 사용자 정의 로직을 실행합니다.

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()`	선택적 진단

native 자동 업데이트 동작을 유지하면 Capawesome JavaScript를 완전히 삭제할 수 있습니다.

수동 제어 예시

최신 배포본 다운로드

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

다음 배포본 설정

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

다운로드한 패키지를 즉시 적용합니다

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

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

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

배경 업데이트

이전 워크플로우: code에서 구성하고 다운로드를 수동으로 예약합니다.
Capgo컨트리뷰팅autoUpdate: true: 기본적으로 활성화되며 (code가 필요하지 않습니다.)

최근 버전

이전 워크플로우업그레이드 App.resume : __CAPGO_KEEP_0__가 필요하지 않습니다. download, then 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 : Capgo에 PR 제출하는 notifyAppReady(): Capgo에 PR 제출하는

: Capgo에 PR 제출하는

이전에는 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_KEEP_0__.app/history) Capgo status.capgo.app/ history.

이동 계획

설치 및 관리: 10 분 (npm install),旧 플러그인 제거.
설정 및 준비: 5 분 (notifyAppReady).
정상성 검사: 15 분 (선택적 수동 테스트 또는 리스너).
첫 번째 배포: 10 분 Capgo CLI 또는 CI 통합과 함께.

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

Capgo 지원

업그레이드 도우미: book.capgo.app/demo.
Community: Capgo 디스코드.
이슈 트래커: github.com/Cap-go/capacitor-updater/issues.

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

Keep going from Migrate from Capawesome Cloud to Capgo

Capawesome Cloud Migrate from Capawesome Cloud to Capgo Capgo로 CI/CD 자동화 계획을 세우고 연결하세요. Capgo CI/CD Capgo 제품 워크플로우에서 Capgo CI/CD에 대해 Capgo 원시 빌드 Capgo 제품 워크플로우에서 Capgo 네이티브 빌드 Capgo 통합 서비스 Capgo 제품 워크플로우에서 Capgo 통합을 위해 CI/CD 통합 Capgo Actions Integration GitHub 액션 통합 for the implementation detail in GitHub Actions Integration.