델타 업데이트

설치 단계와 이 플러그인의 전체 마크다운 가이드를 포함한 설정 명령어를 복사하세요.

Capgo의 Live Update 시스템은 변경된 파일만 보내어 업데이트를 더 빠르고 효율적으로 전달할 수 있습니다. 전체 JS 번들보다는.

이것은 느린 또는 메트릭 네트워크 연결을 사용하는 사용자에게 특히 유용합니다. 다운로드해야 하는 데이터 양을 최소화하기 때문입니다.

두 번째 이점은 앱이 자주 변경되지 않는 큰 자산을 가지고 있을 때, 이미지나 비디오와 같은 경우, 압축된 JS 파일과 비교하여 다운로드가 한 번만 이루어집니다.

Live Update의 델타 업데이트 방법

Capgo의 델타 업데이트는 Capgo 플러그인이 설치된 앱에서 처리됩니다. 새로운 버전의 앱을 업로드할 때 Capgo 플래그를 사용하면 Capgo가 다음을 수행합니다. --delta Capgo은 다음과 같은 작업을 수행합니다.

각 델타 파일에 대한 체크섬이 생성됩니다.
델타 파일 목록, 경로 및 체크섬이 __CAPGO_KEEP_0__ 데이터베이스에 저장됩니다.
Capgo 플러그인이 새로운 버전의 배포본에 대한 델타 파일 목록을 받으면, 플러그인은 체크섬과 파일 경로를 비교하여 이미 가지고 있는 파일과 변경된 파일을 식별합니다.

When a device running your app checks for an update, the Capgo plugin receives the list of delta files for the new bundle. It compares it to the files it already has, identifying which files have changed based on the checksums and file paths.

델타 파일 캐시

어떤 기기에서 델타를 받고 어떤 기기에서 풀 제이피를 받는가

업로드된 번들에 --delta 는 풀 제이피와 델타 파일을 모두 포함합니다. 기본 Zip + delta 델타 지원 버전의 플러그인 버전에 있는 기기(

또는5.10.0+, 6.25.0+, 7.0.35+, or 8+델타 지원 버전이 없는 더 오래된 플러그인 버전의 기기는 풀 제이피를 다운로드합니다.
업로드된 번들에
는 델타 파일이 없기 때문에 모든 기기는 풀 제이피를 다운로드합니다. --delta Zip + delta

Live Update

Cloudflare Capacitor GitHub

Capgo

Delta updates also lower your Capgo bandwidth usage. Bandwidth only counts the files a device actually downloads, so with Delta only the changed files count, not the whole bundle. Files or full zips already cached at the edge do not count, and interrupted downloads resume where they stopped without counting the downloaded part twice. See SDK.

CLI

Live Update를 사용하여 Capgo 앱에 Delta 업데이트를 활성화하려면 단순히 --delta 새 버전 업로드 시 표시할 때

npx @capgo/cli@latest bundle upload --delta

만약 autoUpdate Live Update 모드 ("atInstall", "onLaunch"또는 "always") capacitor.configCapgo에서 CLI이 설정된 경우, directUpdate 비 인터랙티브 환경에서는 Delta 업데이트를 자동으로 전송하고, 인터랙티브 환경에서는 업로드를 확인하기 전에提示합니다. --no-delta Legacy

config는 여전히 감지됩니다.

Delta 업데이트의 제한 사항 CLI 로그 Ignoring empty file... 및 0 바이트 파일을 제외한 델타 파일에서 제외합니다. 업로드를 실패하지 않으므로 빈 파일을 추가하여 결과 배포를 중단하지 않고 배포를 변경할 수 있습니다. 델타 배포 경로에 0 바이트 파일을 포함하지 마십시오.
경로에 공백이 있는 경우: 델타 업로드는 배포 경로에 공백이 있는 경우 업로드를 실패합니다. 델타 업데이트를 업로드하기 전에 파일 또는 디렉토리 이름을 공백이 없는 이름으로 변경하십시오.

델타 업데이트를 강제로 사용하는 방법

모든 업로드가 델타 업데이트로만 이루어지고, 의도치 않은 전체 배포 업로드를 방지하려면 다음 플래그를 사용할 수 있습니다. --delta-only 터미널 창

npx @capgo/cli@latest bundle upload --delta-only

사용할 수 있는 경우 --delta-only Capgo는 델타 파일만 업로드하고 전체 zip을 업로드하지 않습니다. 델타 지원이 없는 플러그인 버전의 모든 장치가 업데이트를 다운로드할 수 없습니다.

__CAPGO_KEEP_0__는 델타 파일만 업로드하고 전체 zip을 업로드하지 않습니다. 델타 지원이 없는 플러그인 버전의 모든 장치가 업데이트를 다운로드할 수 없습니다. --delta-only if:

Delta 업데이트만 사용하고 전체 패키지 업로드를 허용하지 않습니다.
CI/CD pipeline을 설정하고 모든 자동 업로드가 Delta 업데이트를 사용하도록 보장하고 싶습니다.
앱이 크고 대역폭이 제한되어 있으므로 업로드/다운로드 크기를 최소화해야 합니다.

전체 패키지 업로드가 필요하다면 --delta-only 가 설정되어 있는 경우에만 --delta-only를 실행하여 전체 패키지 업로드를 수행할 수 있습니다. 이 설정은 단일 업로드에만 적용되며, 필요할 때 전체 패키지를 푸시할 수 있습니다.

문제 해결

Delta 업데이트가 작동하지 않는 것처럼 보인다면 (즉, 작은 변경 사항에도 항상 전체 JS 패키지를 다운로드하는 경우), 다음을 확인하세요:

항상 --delta flag를 사용하여 새로운 버전을 업로드할 때마다
사용 중인 경우 --delta-only omitted 된 --delta flag
Delta 지원을 포함한 플러그인 버전을 실행 중인 기기5.10.0+, 6.25.0+, 7.0.35+, 또는 8+)
전체 zip만 다운로드하는 채널 형식이 전체 zip만 다운로드하는
안정적인 네트워크 연결을 가지고 있으며 Capgo 서버에 접근할 수 있는 기기

또한 Capgo 웹앱을 사용하여 마지막 업로드의 세부 정보를 확인할 수 있습니다:

웹앱으로 이동 웹앱
앱 클릭
업데이트 통계 바의 번들 수를 클릭하세요.
마지막 번들을 선택하세요.
체크합니다. Delta files 행입니다. 그것은 델타 파일이 없습니다. 만약 번들이 풀 ZIP으로 업로드 된 경우에만 표시됩니다.

문제가 계속되면 Capgo 지원팀으로 연락하여 추가 도움을 받으세요. 그들은 서버 로그를 확인하여 델타 업로드가 올바르게 처리되고 장치가 델타 파일을 받고 있는지 확인할 수 있습니다.

그것이 다입니다! --delta 플래그는 Capgo에 델타 업데이트를 위해 필요한 개별 델타 파일을 업로드하도록 지시합니다.

주의하십시오. --delta 매번 새로운 버전을 업로드할 때마다 델타 업데이트로 전달하고 싶다면 이 플래그를 사용해야 합니다. 플래그를 생략하면 Capgo은 전체 JS 번들을 단일 파일로 업로드하고 장치는 변경된 부분이 적더라도 전체 번들을 다운로드합니다.

Delta 업데이트에서 계속

Delta 업데이트를 사용하고 있다면 Delta 업데이트 Live Update를 계획하기 위해 live update 배포를 연결하세요. 계획 Capgo 배포를 위해, Capgo Live Updates와 연결하세요. Capgo Live Updates Overview __CAPGO_KEEP_0__ Live Updates에서 제품 워크플로우를 위해 개요 개요에 대한 구현 세부 정보를 위해 기능들에 대한 구현 세부 정보를 위해 업데이트 동작의 구현 세부 사항에 대해, 그리고 업데이트 유형 업데이트 유형의 구현 세부 사항에 대해.