컨텐츠로 바로가기

@capgo/capacitor-updater

Live update for capacitor apps.

코르도바 및 일렉트론과 함께도 사용할 수 있습니다.

코르도바 업데이터

Capgo live updates are not limited to Capacitor. Use the same backend and CLI with sibling client plugins:

capacitor 앱의 실시간 업데이트

  • notifyAppReady - 자바스크립트 초기화가 성공적으로 완료되었음을 native layer에 알립니다.
  • setUpdateUrl - 앱의 업데이트 URL을 런타임에 동적으로 설정합니다.
  • setStatsUrl - 앱의 통계 URL을 런타임에 동적으로 설정합니다.
  • setChannelUrl - 앱의 채널 URL을 런타임에 동적으로 설정합니다.

공개 API

공개 API
메서드설명
notifyAppReady자바스크립트 초기화가 성공적으로 완료되었음을 native layer에 알립니다.
setUpdateUrl앱의 업데이트 URL을 런타임에 동적으로 설정합니다.
setStatsUrl앱의 통계 URL을 런타임에 동적으로 설정합니다.
setChannelUrl앱의 채널 URL을 런타임에 동적으로 설정합니다.
download지정된 URL에서 새로운 배포본을 다운로드하여 나중에 설치합니다.
next앱이 배경화면 또는 재시작할 때 활성화될 다음 배포본을 설정합니다.
set현재 배포본을 설정하고 앱을 즉시 다시 로드합니다.
delete로컬 스토리지에서 배포본을 삭제하여 디스크 공간을 확보합니다.
setBundleError수동 업데이트 모드에서 배포본을 실패/오류로 표시합니다.
list__CAPGO_KEEP_0__
reset앱에 저장된 모든 로컬 다운로드 버전을 가져옵니다.
current앱을 알려진 좋은 버전으로 초기화합니다.
reload현재 활성화된 버전에 대한 정보를 가져옵니다.
setMultiDelay수정을 적용하기 위해 대기 중인 업데이트 다시 로드합니다.
cancelDelay수정을 적용하기 전에 대기 중인 업데이트 조건을 설정합니다.
getLatest대기 중인 업데이트 조건을 모두 취소하고 즉시 수정을 적용합니다.
setChannelSet a local runtime update channel for this device. It does not create a dashboard/API device override.
unsetChannel이 기기의 로컬 런타임 업데이트 채널을 설정합니다. 이 메서드는 대시보드 기기 오버라이드를 생성하지 않습니다.
getChannel기기의 채널 할당을 제거하고 기본 채널로 돌아갑니다.
listChannels이 기기의 현재 채널을 가져옵니다.
setCustomId이 기기에 할당할 수 있는 모든 채널 목록을 가져옵니다.
getBuiltinVersion기본 빌드 버전을 가져옵니다 (원래 앱에 포함된 버전).
getDeviceId이 장치의 고유하고 개인 정보 보호를 위한 식별자를 가져옵니다.
getPluginVersionCapacitor 업데이터 플러그인에 설치된 앱의 버전을 가져옵니다.
isAutoUpdateEnabled자동 업데이트가 현재 활성화되어 있는지 확인합니다.
removeAllListeners이 플러그인에 등록된 모든 이벤트 리스너를 제거합니다.
addListener앱에서 배포 다운로드 이벤트를 듣습니다. 다운로드가 시작되면, 다운로드 중에, 다운로드가 완료되면 발생합니다. 다운로드 중에 다운로드 퍼센트를 반환합니다.
addListener업데이트가 필요하지 않음을 듣습니다. 매번 앱이 시작될 때 강제로 업데이트를 확인하고 싶을 때 유용합니다.
addListener업데이트가 가능함을 듣습니다. 매번 앱이 시작될 때 강제로 업데이트를 확인하고 싶을 때 유용합니다.
addListener다운로드 완료 이벤트를 듣습니다.
addListener백엔드에서 업데이트를 현재 앱과 호환되지 않는 것으로 표시할 때 깨지는 업데이트를 듣습니다. LEGACY 리스너와 동일한 페이로드를.emit합니다. majorAvailable 대규모 업데이트를 듣습니다. disableAutoUpdateBreaking을 설정하여 대규모 업데이트가 차단되면 알려줍니다.
addListener업데이트가 필요하지 않음을 듣습니다. 매번 앱이 시작될 때 강제로 업데이트를 확인하고 싶을 때 유용합니다.
addListener앱에서 업데이트 실패 이벤트를 듣고, 다음 앱 시작 시 업데이트 설치가 실패한 경우 알려줍니다.
addListener앱에서 세팅 이벤트를 듣고, 성공적으로 적용된 번들을 알려줍니다. 이 이벤트는 자바스크립트가 소비하기 전까지 원래대로 유지되므로, 앱이 리로드되기 전에 리스너가 연결되지 않은 경우 마지막 대기 중인 이벤트가 리스너가 연결되면 전달됩니다. set 앱에서 세팅 다음 이벤트를 듣고, 다음으로 설치될 번들을 알려줍니다.
addListener앱에서 다운로드 실패 이벤트를 듣고, 다운로드가 실패한 번들을 알려줍니다.
addListener앱에서 리로드 이벤트를 듣고, 리로드가 발생한 경우 알려줍니다.
addListener앱에서 앱 준비 이벤트를 듣고, 앱이 사용할 준비가 되었을 때 알려줍니다. 이 이벤트는 자바스크립트가 소비하기 전까지 원래대로 유지되므로, 리로드가 발생해도 리스너가 연결된 후에도 이벤트가 전달될 수 있습니다.
addListener채널 개인 이벤트를 듣고, 장치 자체 할당이 허용되지 않는 채널을 설정할 때 발생합니다.
addListener안드로이드에서 유연한 업데이트 상태 변경을 듣습니다.
addListener자동 업데이트 기능이 사용 가능한지 확인합니다. (사용자 지정 서버 구성으로 비활성화되지 않았습니다).
isAutoUpdateAvailable다음 리로드 시 활성화될 번들의 정보를 가져옵니다.
getNextBundle최근에 로드 실패한 번들의 정보를 가져옵니다.
getFailedUpdate__CAPGO_KEEP_0__
setShakeMenuDebugging 및 테스트를 위해 Shake 동작 메뉴를 활성화하거나 비활성화합니다.
isShakeMenuEnabled현재 Shake 동작 디버그 메뉴가 활성화되어 있는지 확인합니다.
setShakeChannelSelector런타임에서 Shake 채널 선택기를 활성화하거나 비활성화합니다.
isShakeChannelSelectorEnabled현재 Shake 채널 선택기가 활성화되어 있는지 확인합니다.
getAppId업데이트 서버와의 통신을 위해 사용하는 현재 구성된 App ID를 가져옵니다.
setAppId업데이트 서버와의 통신을 위해 사용하는 App ID를 동적으로 변경합니다.
getAppUpdateInfo앱의 App Store 또는 Play Store에서 사용 가능 여부에 대한 정보를 가져옵니다.
openAppStore앱의 App Store 또는 Play Store 페이지를 열어줍니다.
performImmediateUpdateAndroid에서 즉시 인앱 업데이트를 수행합니다.
startFlexibleUpdateAndroid에서 유연한 인앱 업데이트를 시작합니다.
completeFlexibleUpdateAndroid에서 유연한 인앱 업데이트를 완료합니다.

Source Of Truth

Source Of Truth

이 참조는 다음에서 동기화됩니다. src/definitions.ts in capacitor-업데이터.

Capgo의 소스 코드를 참조하세요. @capgo/capacitor-updater Capgo의 소스 코드를 참조하세요. Using @capgo/capacitor-updater for the native capability in Using @capgo/capacitor-updater, Capgo 플러그인 디렉토리 Capgo 제품 워크플로우에 대한 Capacitor 플러그인 Capgo Capacitor 플러그인 Capgo 구현 세부 사항에 대한 플러그인 추가 또는 업데이트 플러그인 추가 또는 업데이트 구현 세부 사항에 대한, 및 아이오닉 엔터프라이즈 플러그인 대체 __CAPGO_KEEP_0__ 제품 워크플로우에 대한 아이오닉 엔터프라이즈 플러그인 대체