가이드
업데이터에 대한 튜토리얼
Ionic 및 Capacitor live updates with @capgo/capacitor-updater
@capgo/capacitor-updater는 Ionic 및 Capacitor 앱의 Capgo live updates를 위한 오픈 소스 업데이터 플러그인입니다. 승인된 웹 번들을 다운로드하고 native rollback 보호를 적용하여 binary-only 변경 사항을 normal App Store 및 Play 리뷰 경로에 유지합니다.
__CAPGO_KEEP_0__의 OTA 업데이트를 위해 HTML, CSS, JavaScript, 자산 및 기타 웹-layer 변경이 필요할 때 사용하세요.
Install
npm install @capgo/capacitor-updater
npx cap sync
__CAPGO_KEEP_1__에 적합한 workflow에서 live updates는 일반적으로 Ionic 팀에게 의미합니다: 새로운 웹 번들을 배포하여 모든 사용자가 전체 스토어 릴리스를 강제로 통과하지 않습니다. __CAPGO_KEEP_0__은 __CAPGO_KEEP_1__ 앱에 채널, 호환성 검사, 롤아웃 제어, 장치 로그 및 롤백을 제공하여 그 workflow를 처리합니다.
For Ionic teams, live updates usually mean the same workflow: ship a new web bundle without forcing every user through a full store release. Capgo handles that workflow for Capacitor apps with channels, compatibility checks, rollout control, device logs, and rollback.
Native plugins, entitlements, Android manifest changes, iOS plist changes, and binary SDK updates still require a normal app store release. Keep those changes in your native build pipeline and use live updates for the approved web layer.
- native layer에 JavaScript 초기화가 성공적으로 완료되었음을 알립니다.
notifyAppReady- 앱의 업데이트 URL을 동적으로 런타임에 설정합니다.setUpdateUrl- 앱의 통계 URL을 동적으로 런타임에 설정합니다.setStatsUrl- 앱의 채널 URL을 동적으로 런타임에 설정합니다.setChannelUrlExample Usage
native layer에 JavaScript 초기화가 성공적으로 완료되었음을 알립니다.
notifyAppReady
__CAPGO_KEEP_0__
import { CapacitorUpdater } from '@capgo/capacitor-updater';
await CapacitorUpdater.notifyAppReady();
setUpdateUrl
동적 런타임에서 앱의 업데이트 URL을 설정하세요.
import { CapacitorUpdater } from '@capgo/capacitor-updater';
await CapacitorUpdater.setUpdateUrl({} as UpdateUrl);
setStatsUrl
동적 런타임에서 앱의 통계 URL을 설정하세요.
import { CapacitorUpdater } from '@capgo/capacitor-updater';
await CapacitorUpdater.setStatsUrl({} as StatsUrl);
setChannelUrl
동적 런타임에서 앱의 채널 URL을 설정하세요.
import { CapacitorUpdater } from '@capgo/capacitor-updater';
await CapacitorUpdater.setChannelUrl({} as ChannelUrl);
전체 참조
- GitHub: https://github.com/Cap-go/capacitor-업데이터/
- 문서: /docs/plugins/updater/
- 라이브 업데이트 제품: /live-update/
capgo/capacitor-업데이터에서 계속 진행하세요.
라이브 업데이트 계획을 위해 @__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-업데이터를 사용하는 경우 @capgo/capacitor-업데이터를 연결하세요. 라이브 업데이트 제품: /live-update/ 실시간 업데이트 제품 워크플로우를 위해 @capgo/capacitor-업데이터 implementation details를 위해 Getting Started, 채널, 및 롤백.