메뉴로 건너뛰기
Capgo - Live Updates for Capacitor Apps Capgo

델타 업데이트

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

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

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

델타(매니페스트) 업데이트는 어떻게 작동하는가

Section titled “How Delta (Manifest) Updates Work”

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

  1. 체크섬이 각 파일에 생성됩니다.
  2. 새로운 JSON 매니페스트가 생성됩니다. 파일 목록과 체크섬이 포함됩니다.
  3. __CAPGO_KEEP_1__
  4. This manifest is uploaded to the Capgo database

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.

The plugin then downloads only the changed files, rather than the entire JS bundle. It reconstructs the new version of the app by combining these downloaded files with the unchanged files it already has.

Delta (스키트) 업데이트를 사용하도록 설정

Delta (스키트) 업데이트를 사용하도록 설정

To enable Delta (manifest) updates for your Capgo app, simply use the --delta 터미널 창

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

만약에 directUpdate 이것이 활성화되어 있는 경우 capacitor.config, CLI은 그것을 감지합니다. 비인터랙티브 환경에서 Delta (manifest) 업데이트를 자동으로 보내고, 인터랙티브 환경에서는 업로드하기 전에 확인을 요청합니다. --no-delta 를 사용하여 전체 번들 업로드를 강제로 합니다.

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

‘델타 (매니페스트) 업데이트를 강제하는 방법’

전체 업로드가 모두 델타 (매니페스트) 업데이트로 되고, 의도치 않은 전체 번들 업로드가 발생하지 않도록 하려면 --delta-only flag:

터미널 창
npx @capgo/cli@latest bundle upload --delta-only

만약에 --delta-only 사용될 때, Capgo은 개별 파일만 업로드하고 매니페스트를 생성합니다. 델타 (매니페스트) 업데이트를 지원하지 않는 모든 기기는 업데이트를 다운로드할 수 없습니다.

사용할 수 있는지 궁금하실가요 --delta-only __CAPGO_KEEP_0__

  • Delta (manifest) 업데이트만 사용하고 전체 배포 업로드를 허용하지 않기를 원합니다.
  • CI/CD pipeline을 설정하고 모든 자동 업로드가 Delta (manifest) 업데이트로만 이루어지길 원합니다.
  • 앱이 크고 대역폭이 제한되어 있으므로 업로드/다운로드 크기를 최소화해야 합니다.

__CAPGO_KEEP_0__ --delta-only 만약 전체 배포 업로드가 필요하다면 --delta-only__CAPGO_KEEP_0__

Troubleshooting

Troubleshooting

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

  • Capacitor --delta __CAPGO_KEEP_0__ 버전 업로드할 때마다 표시합니다.
  • 사용 중인 경우 --delta-only omitted 하지 않았는지 확인하세요. --delta __CAPGO_KEEP_0__ 플러그인
  • Capgo 서버에 접속할 수 있는穩定的 네트워크 연결을 가지고 있습니다.
  • Capgo 웹앱을 사용하여 마지막 업로드의 세부 정보를 확인할 수 있습니다.

You can also use the Capgo webapp to check the details of your last upload:

  1. 앱 클릭 stat 바의 번들 수를 클릭합니다.
  2. 마지막 번들을 선택하세요.
  3. __CAPGO_KEEP_0__
  4. __CAPGO_KEEP_0__
  5. 체크하세요. Partial 필드 번들 유형

더욱 도움이 필요하시면 Capgo 지원팀에 문의해 주십시오. 그들은 서버 로그를 확인하여 Delta (매니페스트) 업로드가 정상적으로 처리되고, 장치가 업데이트된 매니페스트를 받고 있는지 확인할 수 있습니다.

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

주의하십시오. --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.