V3에서 V4로

이 플러그인의 설치 단계와 전체 마크다운 가이드가 포함된 설정 프롬프트를 복사하세요.

업그레이드 이유

디스코드 커뮤니티에서 여러분과 많은 대화를 나눈 결과, 수동 모드가 너무 수동적이고 안전하지 않다는 것을 발견했습니다. 예를 들어 자동 롤백이 불가능했기 때문에 수동 업데이트가 실패하면 사용자가 앱을 삭제하고 다시 설치해야 했으며, 이는 매우 나쁜 UX였습니다.

이 기회를 통해 여러분에게 더 많은 자유를 주고, 제가 만든 모든 나쁜 code을 제거했습니다.

설치

npm i @capgo/capacitor-updater@4

자동 업데이트 클라우드

앱에서 기본 예제를 사용 중이라면 새 버전으로 안전하게 마이그레이션할 수 있습니다. 즐기세요!

셀프 호스팅 자동 업데이트

여러분에게는 여전히 간단합니다. 변경 사항은 다음과 같습니다:

설정 이름이 ~에서 autoUpdateUrl 에서 updateUrl
Endpoint 메서드가 다음에서 변경되었습니다 GET POST로

수동 사용자

여러분에게는 가장 큰 변화지만, 좋은 쪽으로요! 수많은 개선 사항이 있으니 꼼꼼히 읽어 보세요.

변경 사항

autoUpdateUrl 로 변경됩니다 updateUrl 이 설정은 이제 수동 모드에서도 사용할 수 있으므로
삭제 cancelDelay 및 delayUpdate 대신 setDelay
더 이상 versionName set에
변경 사항 version 대부분의 함수에서 객체로 반환되던 key BundleInfo

interface BundleInfo {
  id: string;
  version: string;
  downloaded: string;
  status: 'success' | 'error' | 'pending' | 'downloading'
}

오해의 소리가 있던 이름들을 이제 명확하게 변경했습니다 (설명만으로는 이해가 어려울 수 있지만, 사용 시에는 새 이름이 훨씬 직관적입니다):
- 이전에는 version 이제는 bundle
- id 기존의 version 10자 랜덤 문자열이었던 이 값은 id bundle에 접근할 수 있는 유일하고 신뢰할 수 있는 방법입니다. 예: 7Dfcd2RedN.
- version 지금부터 versionName 번들에서 선택하는 값, 예시 1.0.0
updateUrl 에서 get 대상 post로 변경되었습니다. 커스텀 헤더가 일부 사용자에게 문제가 되었고 POST가 더 논리적이라, 기존 헤더는 모두 body로 이동하고 접두사 cap_ 가 사라집니다.
versionName 메서드는 삭제되고, 대신 getId
list는 이제 BundleInfo
이름 변경 getId 에서 getDeviceId
autoUpdate 기본값이 true가 됩니다. Manual 모드를 사용하는 경우 false로 설정하세요.

뉴스

메서드 getLatest, 이 메서드를 사용하면 서버에서 설정된 updateUrl 가용한 최신 버전을 가져올 수 있습니다.
메서드 setDelay 다음 값을 {종류: “background” | “kill” | “nativeVersion” | “date”, value? : string} 인수로 전달하여 다양한 모드에 대한 지연 시간을 설정합니다.
메서드 next, 다음 백그라운딩 시 버전을 설정하며, 이는 set 즉시 실행하는 것과 반대입니다.
메서드 isAutoUpdateEnabled, 자동 업데이트 컨텍스트인지 알려주기 위해
이벤트 downloadComplete 다운로드가 100%에 도달하면
필수 필드 추가 version 다운로드 메서드에서
notifyAppReady 수동 모드에서도 필수로 변경되었습니다. 10초 후 호출하지 않으면 앱이 이전 버전으로 되돌아갑니다.

기여자

@lincolnthree 이 작업을 시작해 주셔서 정말 감사합니다. 없이는 이 업데이트를 작동시킬 수 없었습니다.

V3에서 V4로 계속 진행하기

사용 중이라면 V3에서 V4로 live update 배포를 계획하려면, 다음과 연결하세요 Capgo Live Updates Capgo Live Updates의 제품 워크플로우를 보려면, 개요 Overview의 구현 상세를 보려면, 기능 Features의 구현 상세를 보려면, 업데이트 동작 Update Behavior의 구현 세부 사항은 다음과 같고, 업데이트 유형 Update Types의 구현 세부 사항은 다음과 같습니다.