Delta 업데이트

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

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

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

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

델타(매니페스트) 업데이트 방법

Delta (manifest) updates in Capgo are handled by the Capgo plugin installed in your app. When you upload a new version of your app using the --delta flag, Capgo does the following:

델타(매니페스트) 업데이트 방법
델타(매니페스트) 업데이트 방법
A new json manifest is created, listing all files and their checksums
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 (Manifest) 업데이트를 활성화하는 방법

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

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

만약 autoUpdate 즉시 적용 모드 ("atInstall", "onLaunch", 또는 "always")로 설정되어 있다면 capacitor.configCLI는 이를 감지합니다. 비 인터랙티브 환경에서는 Delta (manifest) 업데이트를 자동으로 보내고, 인터랙티브 환경에서는 업로드하기 전에 확인을 요청합니다. LEGACY directUpdate config는 여전히 감지됩니다. --no-delta 를 사용하여 전체 번들 업로드를 강제로 할 수 있습니다.

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

델타 (매니페스트) 업데이트를 모든 업로드에 적용하고 의도치 않은 전체 번들 업로드를 방지하려면 --delta-only flag:

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

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

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

Delta (매니페스트) 업데이트를 항상 사용하고 전체 패키지 업로드를 허용하지 않으려면
CI/CD PIPELINE을 설정하고 모든 자동 업로드가 Delta (매니페스트) 업데이트로 이루어지도록 보장하고 싶다면
앱이 크고 대역폭이 제한되어 있으므로 업로드/다운로드 크기를 최소화해야 한다면

if __CAPGO_KEEP_0__이 설정되어 있다면, 단순히 업로드 명령어를 실행하여 __CAPGO_KEEP_0__을 무시하고 전체 패키지를 업로드할 수 있습니다. 이로 인해 필요한 경우에만 전체 패키지를 업로드할 수 있습니다. --delta-only __CAPGO_KEEP_0__이 설정되어 있다면, 단순히 업로드 명령어를 실행하여 __CAPGO_KEEP_0__을 무시하고 전체 패키지를 업로드할 수 있습니다. 이로 인해 필요한 경우에만 전체 패키지를 업로드할 수 있습니다. --delta-only__CAPGO_KEEP_0__이 설정되어 있다면, 단순히 업로드 명령어를 실행하여 __CAPGO_KEEP_0__을 무시하고 전체 패키지를 업로드할 수 있습니다. 이로 인해 필요한 경우에만 전체 패키지를 업로드할 수 있습니다.

[Troubleshooting]

Delta (manifest) 업데이트가 제대로 작동하지 않는 것 같다면 (즉, 장치가 항상 작은 변경 사항에도 전체 JS 번들을 다운로드하는 경우), 다음을 확인하세요.

Delta (manifest) 업데이트가 제대로 작동하지 않는 것 같다면 (즉, 장치가 항상 작은 변경 사항에도 전체 JS 번들을 다운로드하는 경우), 다음을 확인하세요. --delta __CAPGO_KEEP_0__ 플러그인을 업로드할 때마다
__CAPGO_KEEP_0__ 플러그인을 업로드할 때마다 --delta-only__CAPGO_KEEP_0__ 플러그인을 사용하는 경우 --delta __CAPGO_KEEP_0__ 플러그인을 사용하는 경우
Capgo 플러그인이 최신 버전인지 확인하세요.
Capgo 서버에 접근할 수 있는穩定的 네트워크 연결을 가지고 있는지 확인하세요.

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

__CAPGO_KEEP_0__ 웹앱을 방문하세요. webapp
앱을 클릭하세요
stat 바의 번들 수를 클릭하세요.
마지막 번들을 선택하세요
확인 Partial field

문제가 계속되면 Capgo 지원팀으로 연락해 주시기 바랍니다. 그들은 서버 로그를 확인하여 Delta (manifest) 업로드가 정상적으로 처리되고, 장치가 업데이트된 매니페스트를 받고 있는지 확인할 수 있습니다.

그것이 다입니다! __CAPGO_KEEP_0__가 Delta (manifest) 업데이트를 위해 필요한 개별 파일 업로드 및 매니페스트 생성을 수행하도록 지시하는 플래그입니다. --delta Capgo를 사용할 때마다 새로운 버전을 업로드할 때 Delta (manifest) 업데이트로 전달하고 싶다면 매번 이 플래그를 사용해야 합니다. 플래그를 생략하면 Capgo는 전체 JS 번들을 단일 파일로 업로드하고, 장치는 변경된 부분이 적더라도 전체 번들을 다운로드합니다.

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

__CAPGO_KEEP_0__ Live Updates

Delta 업데이트를 사용 중이라면 Delta 업데이트 Delta 업데이트와 연결하세요 Capgo Live Updates for the product workflow in Capgo Live Updates, 구현 세부 정보 구현 세부 정보 업데이트 동작 업데이트 동작 업데이트 동작 업데이트 유형에 대한 구현 세부 정보, 및 업데이트 유형 업데이트 유형에 대한 구현 세부 정보.