@capgo/capacitor-updater를 통한 Ionic 및 Capacitor Live Update
@capgo/capacitor-updater는 Ionic 및 Capacitor 앱의 Capgo Live Update를 구동하는 오픈소스 updater 플러그인입니다. 승인된 웹 번들을 다운로드해 네이티브 롤백 보호와 함께 적용하고, 바이너리만 바뀌는 사항은 기존 App Store 및 Play 스토어 심사 경로를 그대로 따르게 합니다.
네이티브 셸이 이미 승인된 뒤 HTML, CSS, JavaScript, 에셋 등 웹 레이어 변경 사항을 OTA로 업데이트해야 할 때 사용하세요.
설치
npm install @capgo/capacitor-updater
npx cap sync
적용 위치
Ionic 팀에게 Live Update는 보통 같은 워크플로우를 뜻합니다. 모든 사용자에게 전체 스토어 출시를 강요하지 않고 새 웹 번들을 배포하는 것이죠. Capgo는 채널, 호환성 검사, 롤아웃 제어, 디바이스 로그, 롤백으로 Capacitor 앱에서 이 워크플로우를 처리합니다.
네이티브 플러그인, entitlements, Android manifest 변경, iOS plist 변경, 바이너리 SDK 업데이트는 여전히 일반 앱 스토어 출시가 필요합니다. 이런 변경은 네이티브 build 파이프라인에 두고, 승인된 웹 레이어에는 Live Update를 사용하세요.
플러그인 주요 기능
notifyAppReady- JavaScript가 성공적으로 초기화되었음을 native layer에 알립니다.setUpdateUrl- 런타임에 앱의 update URL을 동적으로 설정합니다.setStatsUrl- 런타임에 앱의 statistics URL을 동적으로 설정합니다.setChannelUrl- 런타임에 앱의 channel URL을 동적으로 설정합니다.
사용 예시
notifyAppReady
JavaScript가 성공적으로 초기화되었음을 native layer에 알립니다.
import { CapacitorUpdater } from '@capgo/capacitor-updater';
const result = await CapacitorUpdater.notifyAppReady();
console.log(result);
setUpdateUrl
런타임에 앱의 update URL을 동적으로 설정합니다.
import { CapacitorUpdater } from '@capgo/capacitor-updater';
await CapacitorUpdater.setUpdateUrl({ url: 'https://example.com' });
setStatsUrl
런타임에 앱의 statistics URL을 동적으로 설정합니다.
import { CapacitorUpdater } from '@capgo/capacitor-updater';
await CapacitorUpdater.setStatsUrl({ url: 'https://example.com' });
setChannelUrl
런타임에 앱의 channel URL을 동적으로 설정합니다.
import { CapacitorUpdater } from '@capgo/capacitor-updater';
await CapacitorUpdater.setChannelUrl({ url: 'https://example.com' });
전체 레퍼런스
- GitHub: https://github.com/Cap-go/capacitor-updater/
- 문서: /docs/plugins/updater/
- Live update 제품: /live-update/
@capgo/capacitor-updater에서 계속하기
사용 중인 경우 @capgo/capacitor-updater Live Update 플랜을 짜려면, 다음을 연결하세요: Live Update 제품 워크플로우 확인: @capgo/capacitor-updater 구현 상세 정보: 시작하기, 채널, 그리고 롤백.