델타 업데이트

이 플러그인의 설치 단계와 전체 마크다운 가이드를 포함하는 설치 설정 지시문을 복사할 수 있습니다.

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

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

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

How Delta (Manifest) Updates Work

Capgo에서 Delta (manifest) 업데이트는 Capgo에서 Capgo 플러그인이 설치된 앱에서 처리됩니다. 새로운 앱 버전을 업로드할 때 Capgo 플래그를 사용하면 Capgo는 다음과 같은 작업을 수행합니다. --delta flag, Capgo does the following:

체크섬이 각 파일에 생성됩니다.
새로운 json 매니페스트가 생성되며, 모든 파일과 체크섬이 목록화됩니다.
이 매니페스트는 __CAPGO_KEEP_0__ 데이터베이스에 업로드됩니다.
장치에서 앱이 업데이트를 확인할 때, 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.

매니페스트

델타(마니페스트) 업데이트를 활성화하는 방법

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

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

__CAPGO_KEEP_0__이 즉시 적용 모드인 경우 ( autoUpdate 또는 "atInstall", "onLaunch" ) "always"이 capacitor.configCLI이 CLI을 감지합니다. 비대면 환경에서는 Delta(매니페스트) 업데이트를 자동으로 보내고, 대화형 환경에서는 업로드하기 전에 확인을 요청합니다. LEGACY directUpdate __CAPGO_KEEP_0__이 아직 감지됩니다. __CAPGO_KEEP_1__을 사용하여 __CAPGO_KEEP_2__ 업로드를 강제로 진행하세요. --no-delta __CAPGO_KEEP_1__을 사용하여 __CAPGO_KEEP_2__ 업로드를 강제로 진행하세요.

Delta 업데이트의 제한 사항

__CAPGO_KEEP_0__은 로그를 남기고 Delta 매니페스트에서 zero-byte 파일을 제외합니다. 업로드를 중단하지 않고 배포 결과를 변경할 수 있는 empty 파일을 추가하지 마세요. Delta 배ंडल 경로에 zero-byte 파일을 포함하지 마세요. The CLI logs Ignoring empty file... Delta 업로드는 경로에 공백이 있는 경우 업로드하기 전에 파일을 업로드합니다. 파일 또는 디렉토리 이름을 공백이 없는 이름으로 변경하세요.
Delta(매니페스트) 업데이트를 강제로 진행하기 제목: Delta(매니페스트) 업데이트를 강제로 진행하기

__CAPGO_KEEP_0은 CAPGO_KEEP_0__을 감지합니다. 비대면 환경에서는 Delta(매니페스트) 업데이트를 자동으로 보내고, 대화형 환경에서는 업로드하기 전에 확인을 요청합니다. LEGACY

If you want to ensure that all uploads are Delta (manifest) updates and prevent any accidental full bundle uploads, you can use the --delta-only flag:

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

When --delta-only is used, Capgo will only upload individual files and generate a manifest. Any device that does not support Delta (manifest) updates will not be able to download the update.

You might want to use --delta-only if:

You always want to use Delta (manifest) updates and never want to allow full bundle uploads
You’re setting up a CI/CD pipeline and want to ensure all automated uploads are Delta (manifest)
Your app is large and bandwidth is constrained, so you need to minimize upload/download sizes

If you need to do a full bundle upload while --delta-only 업로드 명령어를 실행하세요. --delta-only이것은 단일 업로드에 대한 설정을 덮어씁니다. 필요한 경우 완전한 번들을 푸시할 수 있습니다.

문제 해결

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

Capacitor 플러그인을 사용 중이라면 --delta flag를 업로드할 때마다 사용하세요.
Capacitor 플러그인을 사용 중이라면 --delta-onlyflag를 사용하지 마세요. --delta __CAPGO_KEEP_0__ 플러그인의 최신 버전을 실행 중인 장치입니다.
Capgo 서버에 접근할 수 있는 안정적인 네트워크 연결을 가지고 있는 장치입니다.
Capgo는 Capgo의 플러그인입니다.

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

다음으로 이동하세요: 웹앱
앱 클릭
stat 바의 번들 수를 클릭합니다.
마지막 번들을 선택하세요.
세부 정보를 확인하세요. Partial 필드

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

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

__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.

Delta 업데이트로 계속 진행하세요

Delta 업데이트를 사용하여 Delta 업데이트 역할: Enterprise 제품/가격 페이지 내의 짧은 UI 레이블 또는 네비게이션 아이템. 위치: enterprise.astro 페이지. 메시지 키 `enterprise_delta_updates` (기업 Delta 업데이트). Capgo Live Updates for the product workflow in Capgo Live Updates, __CAPGO_KEEP_0__ Live Updates __CAPGO_KEEP_0__ Live Updates __CAPGO_KEEP_0__ Live Updates 업데이트 동작 implementation detail in Features implementation detail in Update Behavior implementation detail in Update Types Edit 페이지