Capgo으로부터 AppFlow로의 이주

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

🚦 Ionic이 AppFlow의 상업 제품, Live Updates를 포함하여 종료 중이라고 발표했습니다. 기존 프로젝트는 2027년 12월 31일까지 실행할 수 있지만, 새로운 고객은 받지 않으며 새로운 기능은 계획하지 않습니다. 이 안내서에서는 __CAPGO_KEEP_0__로의 이주를 위한 필요한 작업을 안내하며, 원본 자동화에 대한 정보를 제공합니다. 이주 개요, but no new customers are accepted and no new features are planned. This guide walks you through the actions required to migrate to Capgo and highlights the native automation you gain.

__CAPGO_KEEP_0은 채널, 패키지 보존, 롤백, 분석, CAPGO_KEEP_1__ 업로드를 자동화합니다. 이주를 위한 작업은 플러그인 설치, 호출, 그리고 원하는 경우에만 옵션의 수동 제어를 구성하는 것입니다. 아래의 섹션에서는 각 작업을 직접 안내합니다.

Capgo handles channels, bundle retention, rollbacks, analytics, and CLI uploads for you. Migration boils down to installing the plugin, calling CapacitorUpdater.notifyAppReady()AppFlow의 자동 버전 매칭에 의존했다면, __CAPGO_KEEP_0__은 더 나은 제어가 제공되는 동일한 기능을 제공합니다. 버전 목표에 대한 자세한 전략은 버전 목표 안내서에서 확인할 수 있습니다.

Step 0 – 현재 AppFlow 설정을 캡처하세요.

AppFlow를 기록하세요. App ID, 기존 채널 및 서명 키.
archive할 bundle 기록을 모두 내보세요.
GitHub Actions 또는 다른 CI 제공자와 함께 사용 중이라면, Capgo와 함께 작동하는 pipeline을 유지하세요.

Step 1 – AppFlow SDK을 Capgo으로 대체하세요.

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

그의 그것. Capgo은 iOS와 Android 모두에 native code을 패키징합니다; 추가 JavaScript helper가 필요하지 않습니다.

Step 2 – 최소 구성 (수동 field 없음)

기존 구성 블록이 광범위합니다. Capgo은 프로젝트와 채널을 자동으로 감지하므로 최소 구성은:

import { CapacitorConfig } from '@capacitor/cli'

const config: CapacitorConfig = {
  plugins: {
    CapacitorUpdater: {
      autoUpdate: true,
      autoDeletePrevious: true,
    },
  },
}

export default config

구성 빠른 참조

아이오닉 AppFlow 설정	Capgo 동등	설정할 필요가 있나요?
`appId`	관리 Capgo 대시보드에서	프로젝트를 생성할 때 자동으로 제공됩니다
`channel` / `defaultChannel`	채널 규칙 (대시보드/API)	선택적 오버라이드; 기본값은 서버에서 가져옵니다. 버전 대상 설정 다중 버전 전략을 위한
`autoUpdateMethod`	`autoUpdate: true`	기본적으로 활성화됨
`maxVersions`	보관 정책	중앙에서 구성 (기본 1 개월, 최대 24 개월)
`enabled`	필수 없음	Capgo 채널별 가용성 설정

Step 3 – Call (필수 hook) `notifyAppReady()` Step 3 – Call notifyAppReady() (필수 hook)

In Ionic의 가이드에서 __CAPGO_KEEP_0__을 사용하여 sync, download, 그리고 reload, 그 다음 스플래시 화면을 수동으로 숨기세요. Capgo은 이 작업들을 네이티브로 수행합니다. 앱이 준비되었는지 확인하는 것만 필요합니다.

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', () => {
  // Log diagnostics or run custom code if needed
  SplashScreen.hide()
})

CapacitorUpdater.notifyAppReady()

4단계 - 전략 업데이트

AppFlow는 세 가지 전략을 문서화했습니다. Capgo에서 어떻게 매핑되는지 알아보세요.

배경 (기본값)

AppFlow: 설정 autoUpdateMethod = background, 호출 sync() 수동으로.
Capgo: 기본적으로 활성화되어 있습니다. 자바스크립트가 필요하지 않습니다.

항상 최신

AppFlow: 추가 App.addListener('resume') handler가 다운로드하고 다시 로드합니다.
Capgo: 자동 업데이트 재개 시 이미 작동합니다. 사용자 지정 시간 창을 원할 경우 핸들러만 추가하세요.

선택: 수동 재개 확인

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

App.addListener('resume', async () => {
  const bundle = await CapacitorUpdater.download()
  if (bundle) {
    await CapacitorUpdater.set({ id: bundle.id })
  }
})

강제 업데이트

AppFlow: 사용자에게 알리고 호출 reload().
Capgo: 대시보드에서 "필수"로 표시한 번들을 마크하고, 이벤트 (이벤트가 발생한 후 majorAvailable )를 기다리며 사용자에게 알리거나 강제로 사용자에게 알립니다. notifyAppReady(): 사용자에게 알리고 호출

5단계 – API 호출 매핑

AppFlow 메서드	Capgo 동등 항목	필요합니까?
`LiveUpdates.sync()`	자동 처리	Capgo의 원시 자동 업데이트은 수동 동기화 호출 없이 실행됩니다.
`LiveUpdates.download()`	`CapacitorUpdater.download()`	사용자 지정 흐름에 대해 선택 사항
`LiveUpdates.reload()`	`CapacitorUpdater.set()`	강제 업데이트 처리를 위한 대시보드 토글이 선택 사항입니다.
`LiveUpdates.getVersion()`	`CapacitorUpdater.current()`	선택적 진단

6단계 – Capgo CLI 또는 API를 사용하여 배포

이러한 마이그레이션을 완료하려면 Capgo CLI 또는 API와 함께 번들을 업로드해야 합니다. 이 워크플로는 이전에 스크립트 한 것과 비슷하지만, 이제는 네이티브 보안을 포함합니다.:

capgo login                # authenticate once
capgo bundle upload \
  --path dist \
  --channel production     # automatically tags platform/version

버전별 배포 (AppFlow와 같은)

특정 네이티브 버전을 대상으로 하려면 (AppFlow의 네이티브 버전 잠금과 유사하게):

# Only deliver to devices on native version 2.0.0 or higher
capgo bundle upload \
  --path dist \
  --channel production \
  --native-version "2.0.0"

# Use channels for different major versions
capgo bundle upload --channel v2  # for app version 2.x
capgo bundle upload --channel v3  # for app version 3.x

전체적인 전략을 알아보려면 버전 대상 매뉴얼 을 참조하세요.

Capgo 자동으로:

__CAPGO_KEEP_0__를 위한 기기 수준 감사 로그를 저장합니다.
__CAPGO_KEEP_0__에 접근할 때 계획 한계에 도달할 때 적극적으로 이메일을 보냅니다.
burst 크레딧을 제공하여 릴리스 중에 막히지 않도록합니다.
18 개의 전 세계 지역에서 latency 지표를 발행합니다. status.capgo.app/history.

Ionic Enterprise 플러그인

Ionic 스택이 Enterprise 플러그인을 사용하는 경우에도, 아래에 나열된 대상화된 마이그레이션 문서를 따릅니다. 각 가이드는 Capgo 대체 및 다음 단계를 추천합니다.

주로 묻는 질문

AppFlow는 실시간 업데이트를 중단하는 이유는 무엇인가요?

Ionic은 AppFlow와 같은 상업 제품을 중단하고 오픈 소스 프레임워크에 집중하고 있습니다. 기존 고객은 2027년 12월 31일까지 실시간 업데이트를 계속 사용할 수 있지만, 새로운 기능이나 고객은 받지 않습니다. __CAPGO_KEEP_0__은 전용 네이티브 OTA 플랫폼을 제공하여 이 boş간을 채웁니다. migration이 얼마나 오래 걸릴까요?, but no new features or customers are accepted. Capgo fills that gap with a dedicated native OTA platform.

대부분의 팀은 1일 이내에 이 과정을 완료합니다. 채널, 배포, 릴리즈 규칙과 같은 개념은 직접 매핑되며, 우리 팀은 문서와 함께 직접적인 지원을 제공합니다. 많은 경우에 단순히 플러그인을 설치하고

비용을 얼마나 절약할 수 있을까요? notifyAppReady()Section titled “ 비용을 얼마나 절약할 수 있을까요? ”']}

protectedTokens

네. AppFlow 실시간 업데이트 시작은 $499/월. Capgo은 $14/월 사용량에 따라 가격이 떨어지기 때문에 $0.001 per MAU입니다. 또한 암호화, 자동 롤백, 전 세계 지연 감시를 얻습니다.

언제 이관해야 하나요?

AppFlow은 이제 유지 보수 모드에 있기 때문에 이관하는 sooner는 ongoing Capgo 혁신에 접근할 수 있습니다. 우리는 릴리스 일정에 맞춰 switch하는 것을 추천합니다. 우리의 엔지니어 팀은 CI/CD 및 배포를 계속 실행하도록 변경을 계획하는 것을 도와드립니다.

추가 리소스

버전 목표 지침 - 앱 플로우 스타일 버전 일치 전략에 대한 깊은 이해
변경 사항 - 채널을 사용하여 주요 버전 업데이트를 관리하는 방법
채널 관리 - 채널 구성 참조

도움이 필요합니다.

이동 세션 예약: book.capgo.app/demo
커뮤니티에 가입하세요: Capgo Discord
이슈 추적 / 기능 요청: github.com/Cap-go/capacitor-업데이터

Capgo은 기업이 원하는 네이티브 델타 업데이트, 암호화된 패키지, 지속적인 혁신을 필요로 하는 엔터프라이즈용으로 설계되었습니다. 마이그레이션 후에는 AppFlow의 접착제 code를 삭제하고 네이티브 자동화에 의존하고, 중단 없이 계속 배송할 수 있습니다.

Keep going from Migrate from AppFlow to Capgo

AppFlow에서 Capgo로 계속 진행하기 Migrate from AppFlow to Capgo AppFlow에서 Capgo로 마이그레이션하기 Capgo Enterprise for the product workflow in Capgo Enterprise, Capgo Enterprise의 제품 워크플로우 Ionic Enterprise Plugin Alternatives의 제품 워크플로우 Capgo Alternatives Capgo Alternatives를 위한 제품 워크플로우 Capgo Consulting Capgo Consulting을 위한 제품 워크플로우 및 Capgo Premium Support Capgo Premium Support를 위한 제품 워크플로우.