Migrate from AppFlow to Capgo

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

🚦 Ionic은 AppFlow의 상업 제품, Live Updates 포함, 종료를 발표했습니다. 기존 프로젝트는 31 December 2027까지 작동할 수 있지만, 새로운 고객은 수락되지 않고 새로운 기능은 계획되지 않습니다. 이 가이드는 __CAPGO_KEEP_0__으로의 마이그레이션을 안내하며, native 자동화의 이점을 강조합니다. 마이그레이션 개요, 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와 유사합니다.

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

App ID , 채널, 및 서명 키를 기록하세요.원하는 배포 기록을 백업하세요.
AppFlow의
이미 GitHub 액션 또는 다른 CI 제공자를 사용 중이라면, 그 PIPELINES를 그대로 두세요. 그들은 Capgo과 함께 계속 작동할 것입니다.

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

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

그것만으로도 충분합니다. Capgo은 iOS와 Android 모두에 native code을 패키징합니다. 추가적인 JavaScript 도우미가 필요하지 않습니다.

2단계 – 최소한의 설정 (수동 field가 필요하지 않습니다)

기존의 설정 블록은 매우 광범위합니다. Capgo은 프로젝트와 채널을 자동으로 감지하므로 최소한의 설정은 다음과 같습니다:

import { CapacitorConfig } from '@capacitor/cli'

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

export default config

설정 빠른 참조

Ionic AppFlow 설정	Capgo 동등 항목	설정해야 하나요?
`appId`	Capgo 대시보드에서 관리	프로젝트를 생성할 때 자동으로 제공
`channel` / `defaultChannel`	채널 규칙 대시보드/API	선택적 오버라이드; 서버에서 기본값이 적용됩니다. 자세히 보기 버전 목표 설정 다중 버전 전략을 위한
`autoUpdateMethod`	`autoUpdate: true`	기본적으로 활성화
`maxVersions`	보존 정책	중앙에서 구성 (기본 1 개월, 최대 24 개월)
`enabled`	필수 없음	Capgo 채널별로 사용 가능 여부를 설정합니다.

3 단계 - 호출 `notifyAppReady()` (필수적인 유일한 hook)

, 그리고 sync, download, 그리고 스플래시 화면을 수동으로 숨기세요. __CAPGO_KEEP_0__은 이 작업들을 네이티브로 수행합니다. 앱이 준비되었는지 확인만 하면 됩니다. reload, then hide the splash screen manually. Capgo performs those actions natively. You only need to confirm the app is ready:

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: 활성화되어 있습니다. JavaScript가 필요하지 않습니다.

Always latest

AppFlow: 추가하여 App.addListener('resume') handler가 다운로드하고 다시 로드합니다.
CapgoCapgo에 PR 제출하기

: 자동 업데이트이 재개되기 전에 이미 실행됩니다. 사용자 지정 타이밍 창을 추가하려면 핸들러만 추가하세요.

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

클립보드 복사

앱플로우: 사용자에게提示并调用 reload().
Capgo: 대시보드에서 번들을 "필수"로 표시하고, majorAvailable 이벤트 (Capgo에서 notifyAppReady())를 듣기 시작하여 앱 내부의 사용자에게提示 또는 강제로 사용하십시오.

Step 5 – Mapping API calls

앱플로우 메서드	Capgo 동등한	필요합니까?
`LiveUpdates.sync()`	자동으로 처리됩니다.	Capgo의 네이티브 자동 업데이트은 수동 동기화 호출 없이 작동합니다.
`LiveUpdates.download()`	`CapacitorUpdater.download()`	사용자 정의 흐름에 대한 선택 사항
`LiveUpdates.reload()`	`CapacitorUpdater.set()`	선택 사항; 대시보드 토글은 강제 업데이트 처리
`LiveUpdates.getVersion()`	`CapacitorUpdater.current()`	선택 사항: 진단

Step 6 – Deploy using the Capgo CLI or API

Capgo로 마이그레이션을 완료하려면 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
# Channel must use metadata strategy: --disable-auto-update metadata
capgo bundle upload \
  --path dist \
  --channel production \
  --min-update-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

See the 버전 목표 지침서 전반적인 전략을 위한

Capgo 자동으로:

__CAPGO_KEEP_0__는 장치 수준의 설치 로그를 모두 유지합니다.
__CAPGO_KEEP_0__는 계획 한계에 접근할 때 적극적으로 이메일을 보냅니다.
__CAPGO_KEEP_0__는 릴리스 중간에 차단되지 않도록 버스트 크레딧을 제공합니다.
18 개의 글로벌 지역에서 latency 지표를 제공합니다. status.capgo.app/history.

아이오닉 엔터프라이즈 플러그인

Ionic 스택이 기업 플러그인을 사용하는 경우, 아래의 대상화된 마이그레이션 문서를 따르세요. 각 가이드는 Capgo 대체 및 다음 단계를 추천합니다.

자주 묻는 질문

AppFlow가 실시간 업데이트 종료하는 이유는 무엇인가요?

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

이주가 얼마나 걸리는지?

대부분의 팀은 하루 이내에 이주를 완료합니다. 채널, 배포, 및 릴리즈 규칙과 같은 개념은 직접 매핑되고, 우리 팀은 문서화 및 실습 지원을 제공합니다. 많은 경우에 단순히 플러그인을 설치하고, notifyAppReady(), 및 첫 번째 번들을 업로드합니다.

돈을 절약할 수 있을까요?

네. AppFlow live updates는 $499/월에서 시작되며, Capgo은 $14/월 사용량에 따라 가격이 떨어지며, 대략 $0.001/MAU. Capgo를 사용하면 암호화, 자동 롤백 및 전 세계 지연 감시도 가능합니다.

이제 언제 이주해야 하나요?

AppFlow는 현재 유지보수 모드에 있기 때문에 sooner에 이주하면 Capgo의 지속적인 혁신에 접근할 수 있습니다. 릴리스 일정에 맞춰서 Switch하는 것을 추천합니다. 우리의 엔지니어 팀은 CI/CD 및 배포를 계속 작동하도록 변경을 계획해 드릴 것입니다.

추가 리소스

버전 목표 지침 - AppFlow-style 버전 일치 전략에 대한 깊은 이해
파괴적인 변경 사항 - 채널을 사용하여 주요 버전 업데이트를 관리하는 방법
채널 관리 - 채널 구성 참조

도움이 필요하세요?

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

Capgo는 기업용으로 설계된 엔터프라이즈 플랫폼으로, 원본 델타 업데이트, 암호화된 패키지, 지속적인 혁신을 제공합니다. 마이그레이션 후 AppFlow의 중간 계층 code을 삭제하고 원본 자동화에 의존하여 중단 없이 계속 배포할 수 있습니다.

Keep going from Migrate from AppFlow to Capgo

업그레이드 세션을 예약하세요: book.app/demo 앱플로우에서 Capgo으로 마이그레이션하십시오. __CAPGO_KEEP_0__ Enterprise와 연결하여 마이그레이션 및 기업 운영을 계획하고 관리하십시오. Capgo Enterprise for the product workflow in Capgo Enterprise, 앱플로우 대체 솔루션: 이오닉 엔터프라이즈 플러그인 대체, __CAPGO_KEEP_0__ 대체 솔루션 앱플로우 대체 솔루션: Capgo 대체 솔루션, Capgo 컨설팅 앱플로우 대체 솔루션: Capgo 컨설팅, Capgo 프리미엄 지원 앱플로우 대체 솔루션: Capgo 프리미엄 지원. Capgo 프리미엄 지원.