Capgo으로부터 AppFlow를 마이그레이션하세요
설치 단계와 이 플러그인의 전체 마크다운 가이드를 포함한 설정 지시를 복사하세요.
🚦 AppFlow의 상업 제품, Live Updates 포함, Ionic이 종료 중입니다. 2027년 12월 31일까지 기존 프로젝트는 작동할 수 있지만새 고객은 수락되지 않고 새로운 기능은 계획되지 않습니다. 이 안내서에서는 Capgo로의 마이그레이션을 진행하는 데 필요한 작업을 안내하며, Capgo에서 얻을 수 있는 네이티브 자동화에 대해 설명합니다.
마이그레이션 개요
마이그레이션 개요Capgo는 채널, 번들 보존, 롤백, 분석, 및 CLI 업로드를 자동화합니다. 마이그레이션은 플러그인을 설치하고 __CAPGO_KEEP_2__를 호출하는 것으로 간단합니다. 필요하면 옵션의 수동 제어를 구성할 수도 있습니다. 아래의 섹션에서는 각 작업을 직접 안내합니다. CapacitorUpdater.notifyAppReady()Migration overview
Step 0 – AppFlow 설정을 캡처하세요
Step 0 – 현재 AppFlow 설정을 캡처 (Section titled “Step 0 – Capture your current AppFlow setup”)- AppFlow의 앱 ID기존 채널 및 서명 키를 기록해 둡니다.
- 원하는 배포 기록을 백업하세요.
- GitHub 액션 또는 다른 CI 제공업체를 사용 중이라면, 그 PIPELINES을 유지하세요. 그들은 Capgo와 함께 계속 작동할 것입니다.
Step 1 – Replace the AppFlow SDK with Capgo
앱플로우를 Capgo로 교체하는 단계 1 – 앱플로우 SDK를 Capgo Capgo로 교체하십시오npm uninstall @capacitor/live-updatesnpm install @capgo/capacitor-updaternpx cap sync이것은 끝입니다. Capgo은 iOS와 Android 모두에서 네이티브 code을 패키징합니다; 추가적인 자바스크립트 헬퍼가 필요하지 않습니다.
Step 2 – 최소한의 구성 (수동 field가 없음)
Step 2 – 최소한의 구성 (수동 field가 없음)Capgo는 기존 구성 블록이 광범위합니다. 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 채널별 가용성 설정 |
Step 3 – Capgo로 호출하기 notifyAppReady() 역할: UI 레이블. 본문: Capgo 페이지에 대해. 본문 키 `about_how_step_label` (About How Step Label).
(단 한 개의 필수 훅)Step 3 – Call notifyAppReady() (단 한 개의 필수 훅) sync, downloadIonic의 가이드에서 reloadCapgo은 앱이 준비되었는지 확인하는 것만 필요합니다.
import { CapacitorUpdater } from '@capgo/capacitor-updater'
CapacitorUpdater.notifyAppReady()If the confirmation never arrives, Capgo automatically reverts the bundle.
이것은 끝입니다—Capgo은 배경 검사, 스플래시 표시, 롤백을 자동으로 처리합니다.
확인이 절대 도착하지 않으면 __CAPGO_KEEP_0__은 자동으로 번들을 롤백합니다.
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단계 - 업데이트 전략 번역
4단계 - 업데이트 전략 번역AppFlow는 세 가지 전략을 문서화합니다. Capgo은 다음과 같이 매핑됩니다.
배경 (기본)
AppFlow- : 설정, 호출
autoUpdateMethod = background수동으로.sync()manually. - CapgoCapgo Live Update가 기본적으로 활성화되어 있습니다. 자바스크립트가 필요하지 않습니다.
최신 항상
항상 최신- AppFlow: Capgo로 업그레이드
App.addListener('resume'): 자동 업데이트 다시 시작 - 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(). - CapgoCapgo로 PR 제출
majorAvailableCapgonotifyAppReady()앱 내 사용자에게 알람을 표시하거나 강제로 앱 내에서 사용자에게 알람을 표시합니다.
Step 5 – Capgo로 API 호출 매핑
Step 5 – API 호출 매핑| 5단계 - __CAPGO_KEEP_0__ 호출 매핑 | 5단계 - Capgo 호출 매핑 | AppFlow 메서드 |
|---|---|---|
LiveUpdates.sync() | Capgo의 __CAPGO_KEEP_0__ 동등 항목 | Capgo의 원시 자동 업데이트은 수동 동기화 호출 없이 작동합니다. |
LiveUpdates.download() | CapacitorUpdater.download() | 선택 사항: 사용자 정의 흐름 |
LiveUpdates.reload() | CapacitorUpdater.set() | 선택 사항: 대시보드 토글은 강제 업데이트를 처리합니다. |
LiveUpdates.getVersion() | CapacitorUpdater.current() | 선택 사항: 진단 |
6단계 – Capgo CLI 또는 API를 사용하여 배포
페이지 제목: 6단계 – Capgo CLI 또는 API를 사용하여 배포6단계 – Capgo CLI 또는 API를 사용하여 배포
capgo login # authenticate oncecapgo 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 metadatacapgo bundle upload \ --path dist \ --channel production \ --min-update-version "2.0.0"
# Use channels for different major versionscapgo bundle upload --channel v2 # for app version 2.xcapgo bundle upload --channel v3 # for app version 3.x자세한 전략을 위한 버전 목표 지침 __CAPGO_KEEP_0__ 자동으로:
Capgo은 장치 수준의 설치 로그를 유지합니다.
- __CAPGO_KEEP_0__은 계획 한계에 접근할 때 적극적인 이메일을 보내줍니다.
- __CAPGO_KEEP_0__은 릴리스 중에 차단되지 않도록 버스트 크레딧을 제공합니다.
- __CAPGO_KEEP_0__은 18 개의 글로벌 지역에서 지연 시간 지표를 게시합니다.
- Ionic 기업 플러그인 Capgo status.capgo.app/이력.
Ionic enterprise 플러그인
Ionic enterprise 플러그인Ionic 스택이 기업 플러그인을 사용한다면, 아래에 나열된 대상화된 마이그레이션 문서를 따르세요. 각 가이드는 Capgo 대체 및 다음 단계를 추천합니다.
자주 묻는 질문
자주 묻는 질문AppFlow가 실시간 업데이트 기능을 중단하는 이유는 무엇인가요?
AppFlow가 실시간 업데이트 기능을 중단하는 이유는 무엇인가요?Ionic은 AppFlow와 같은 상업 제품을 중단하여 오픈 소스 프레임워크에 집중하고 있습니다. 기존 고객은 2027년 12월 31일까지 실시간 업데이트 기능을 계속 사용할 수 있지만 2027년 12월 31일하지만 새로운 기능이나 고객은 받지 않습니다. Capgo은 Native OTA 플랫폼을 제공하여 이 boş간을 채웁니다.
마이그레이션은 얼마나 오래 걸리나요?
이주 시간은 얼마나 걸리나요?대부분의 팀은 이 과정을 하루 이내에 완료합니다. 채널, 배포, 릴리스 규칙과 같은 개념은 직접 매핑되며, 우리 팀은 문서화와 함께 직접적인 지원을 제공합니다. 많은 경우에 단순히 플러그인을 설치하고 notifyAppReady()를 호출하고
를 업로드하면 됩니다.
Will we save money?Section titled “Will we save money?” $499/월Capgo 시작은 $14/월 $14/mo 에서 시작되며 사용량에 따라 $0.001 per MAU
어떤 시점에 업그레이드해야 하나요?
Section titled “어떤 시점에 업그레이드해야 하나요?”AppFlow는 현재 유지보수 모드에 있습니다. 따라서 sooner에 업그레이드하면 Capgo의 지속적인 혁신에 접근할 수 있습니다. 우리는 릴리즈 일정에 맞춰 업그레이드하는 것을 추천합니다. 우리의 엔지니어 팀은 CI/CD 및 배포를 계속할 수 있도록 변경을 계획해 드릴 것입니다.
추가 리소스
Section titled “추가 리소스”- 버전 대상 매뉴얼 - AppFlow-style 버전 매칭 전략에 대한 깊은 이해
- 파괴적인 변경 사항 - 채널을 사용하여 주요 버전 업데이트를 관리하는 방법
- 채널 관리 - 채널 구성 참조
도움이 필요합니다.
Section titled “도움이 필요합니까?”- 이주 세션 예약: book.capgo.app/demo
- 커뮤니티에 가입하세요: Capgo 디스코드
- 이슈 추적 / 기능 요청: github.com/Cap-go/capacitor-업데이터
Capgo은 기업이 원하는 네이티브 델타 업데이트, 암호화된 번들, 지속적인 혁신을 위해 설계되었습니다. 이주를 마치면 AppFlow의 접착제 code를 삭제하고 네이티브 자동화에 의존하여 중단 없이 계속 배포할 수 있습니다.
앱플로우에서 Capgo으로 이주하세요
Section titled “앱플로우에서 Capgo으로 이주하세요”앱플로우를 사용 중이라면 앱플로우에서 Capgo으로 이주하세요 업그레이드와 enterprise 운영을 계획하고 연결하세요. Capgo 기업 Capgo 제품 워크플로우에서 Capgo Enterprise. Capgo Enterprise Ionic Enterprise Plugin 대체 Capgo 대안 Capgo 대체 Capgo 대체 Capgo 컨설팅 Capgo 컨설팅 Capgo 프리미엄 지원