델타 업데이트

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

Capgo’s Live Update system can deliver updates faster and more efficiently by only sending the changed files, rather than the entire JS bundle.

Live Update 시스템은 변경된 파일만 전송하여 JS 번들을 전부 다운받지 않아 업데이트를 더 빠르고 효율적으로 제공할 수 있습니다.

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

How Delta (Manifest) Updates Work

Delta (manifest) 업데이트는 Capgo에서 Capgo에 의해 처리됩니다. Capgo 플러그인이 설치된 앱에서, 새로운 앱 버전을 업로드할 때 Capgo 플러그인이 다음을 수행합니다. --delta flag, Capgo does the following:

체크섬이 각 파일에 생성됩니다.
새로운 JSON 매니페스트가 생성되며, 모든 파일과 체크섬이 포함됩니다.
이 매니페스트는 Capgo 데이터베이스에 업로드됩니다.
장치가 앱을 실행하는 경우, Capgo 플러그인이 새로운 매니페스트를 서버에서 받고, 현재 가지고 있는 매니페스트와 비교합니다. 체크섬과 파일 경로를 기반으로 변경된 파일을 식별합니다.

When a device running your app checks for an update, the Capgo plugin receives the new manifest from the server. It compares this manifest to the one it currently has, identifying which files have changed based on the checksums and file paths.

매니페스트

델타 (Manifest) 업데이트를 활성화하는 방법

Capgo 앱에 대한 델타 (manifest) 업데이트를 활성화하려면 단순히 새로운 버전을 업로드할 때 다음 플래그를 사용하세요: --delta 터미널 창

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

__CAPGO_KEEP_0__이 즉시 적용 모드인 autoUpdate 또는 "atInstall", "onLaunch"에서 설정되어 있다면 "always") in your capacitor.configCLI이 CLI을 감지합니다. 비대면 환경에서는 Delta(매니페스트) 업데이트를 자동으로 보내고, 대화형 환경에서는 업로드하기 전에 확인을 요청합니다. LEGACY directUpdate __CAPGO_KEEP_0__이 여전히 감지됩니다. 사용하여 --no-delta __CAPGO_KEEP_0__을 강제로 전체 번들 업로드를 강제합니다.

Delta 업데이트의 제한 사항

빈 파일: CLI은 로그 Ignoring empty file... Zero-byte 파일을 Delta 매니페스트에서 제외합니다. 업로드를 중단하지 않고 배포를 중단하지 않도록 업데이트 결과를 변경할 수 있습니다. Zero-byte 파일을 Delta 번들 경로에 포함하지 마십시오.
공간이 있는 경로: Delta 업로드는 공간이 있는 번들 경로를 업로드하기 전에 실패합니다. 파일 또는 디렉토리 이름을 변경하여 공간을 제거한 후 Delta 업데이트를 업로드하십시오.

Delta(매니페스트) 업데이트를 강제하는 방법

업로드가 모두 델타(매니페스트) 업데이트일 수 있도록 하며, 오류로 인한 전체 배포 업로드를 방지하려면 --delta-only flag:

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

사용할 때 --delta-only Capgo는 개별 파일만 업로드하고 매니페스트를 생성합니다. 델타(매니페스트) 업데이트 지원하지 않는 장치가 업데이트를 다운로드할 수 없습니다.

다음과 같은 경우에 사용할 수 있습니다: --delta-only if:

항상 델타(매니페스트) 업데이트만 사용하고 전체 배포 업로드를 허용하지 않습니다.
CI/CD PIPELINE을 설정하고 모든 자동 업로드가 델타(매니페스트) 업데이트일 수 있도록 하려면
앱이 크고 대역폭이 제한되어 있으므로 업로드/다운로드 크기를 최소화해야 할 때

전체 배포 업로드를 해야 할 때 --delta-only 업로드 명령어를 실행하세요. --delta-only이것은 단일 업로드에 대한 설정을 덮어쓰므로, 필요한 경우 완전한 번들을 푸시할 수 있습니다.

문제 해결

Delta (매니페스트) 업데이트가 작동하지 않는 것 같다면 (즉, 장치가 항상 작은 변경에도 전체 JS 번들을 다운로드하는 것처럼 보인다면), 확인하세요:

Delta (매니페스트) 업데이트를 사용 중인지 확인하세요. --delta 매니페스트 업데이트를 사용할 때, 매번 새로운 버전을 업로드할 때
매니페스트 업데이트를 사용할 때, 매번 새로운 버전을 업로드할 때 --delta-only__CAPGO_KEEP_0__ 플러그인의 최신 버전을 실행 중인지 확인하세요. --delta __CAPGO_KEEP_0__ 서버에 접속할 수 있는穩定的 네트워크 연결을 가지고 있는지 확인하세요.
Capgo
Capgo

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

다음 단계를 따르세요: 웹앱
앱을 클릭하세요
stat 바의 번들 수를 클릭하세요
마지막 번들을 선택하세요
세부 정보를 확인하세요 Partial 필드

문제가 계속되면 Capgo 지원팀에 연락하여 추가 도움을 받으세요. 그들은 서버 로그를 확인하여 Delta (manifest) 업로드가 올바르게 처리되고 장치가 업데이트된 매니페스트를 받고 있는지 확인할 수 있습니다.

그의 그것! 그旗는 __CAPGO_KEEP_0__가 Delta (manifest) 업데이트를 위해 개별 파일 업로드 및 매니페스트 생성을 수행하도록 지시합니다. --delta Capgo

__CAPGO_KEEP_0__ --delta every time you upload a new version that you want to be delivered as a Delta (manifest) update. If you omit the flag, Capgo will upload the entire JS bundle as a single file, and devices will download the whole bundle even if only a small part has changed.

__CAPGO_KEEP_0__

델타 업데이트에서 계속 델타 업데이트를 사용하고 있다면 델타 업데이트 Capgo Live Updates Capgo Live Updates context: Page/area: Live updates product page. Role: Short UI label or navigation item. Seen in: page live-update.astro. Preserve Capgo product/brand and developer terms exactly. Message key `live_update_hero_badge` (Live Update Hero Badge). __CAPGO_KEEP_0__ Live Updates __CAPGO_KEEP_0__ Live Updates의 제품 워크플로에 대해, Capgo 구현 세부 사항에 대해 Features에서 설명합니다. 업데이트 동작 Capgo 구현 세부 사항에 대해 Update Behavior에 대해 설명하고, 업데이트 유형 Capgo 구현 세부 사항에 대해 Update Types에 대해 설명합니다.