Ionic 및 Capacitor 라이브 업데이트를 위한 @capgo/capacitor-updater
@capgo/capacitor-updater는 Ionic 및 Capacitor 앱을 위한 Capgo live updates를 뒷받침하는 오픈소스 updater 플러그인입니다. 승인된 web bundle을 다운로드해 native rollback protection과 함께 적용하고, 바이너리 전용 변경 사항은 일반적인 App Store 및 Play 심사 경로를 그대로 따르게 합니다.
Native shell이 이미 승인된 뒤 HTML, CSS, JavaScript, assets 및 기타 web-layer 변경 사항에 OTA updates가 필요할 때 사용하세요.
설치
npm install @capgo/capacitor-updater
npx cap sync
적합한 활용 사례
Ionic 팀에게는 live updates가 보통 같은 워크플로우를 의미합니다. 모든 사용자가 전체 스토어 릴리스를 거치지 않고 새 web bundle을 배포하는 것입니다. Capgo는 channels, 호환성 검사, rollout 제어, device logs, rollback 기능으로 Capacitor 앱의 이 워크플로우를 처리합니다.
Native plugin, entitlements, Android manifest 변경, iOS plist 변경 및 바이너리 SDK 업데이트는 여전히 일반적인 앱 스토어 릴리스가 필요합니다. 이러한 변경 사항은 native build pipeline에서 관리하고, 승인된 web layer에는 live updates를 사용하세요.
플러그인이 제공하는 기능
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 구현 세부 사항은 다음을 참조하세요: 시작하기, 채널, 그리고 롤백.