델타 업데이트

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

특히 느린 또는 요금제 네트워크 연결을 사용하는 사용자에게는 데이터 다운로드량을 최소화하여 특히 유용합니다.

A second benefit is when the app has large assets that change rarely, like images or videos, compared to zipped JS files, it will be downloaded only once.

How Delta (Manifest) Updates Work

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:

1. Checksums are generated for each file
2. A new JSON manifest is created, listing all files and their checksums
3. This manifest is uploaded to the Capgo database
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.

Differential (manifest)

Manifest

델타(매니페스트) 업데이트의 경우, 기기에서 다운로드한 모든 파일을 공통 캐시에 저장합니다. Capgo은 이를 정리하지 않지만 OS는 언제든지 정리할 수 있습니다.

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

Capgo 앱에 대해 델타(매니페스트) 업데이트를 활성화하려면 간단히 다음 플래그를 사용하세요: --delta 터미널 창

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

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

Delta 업데이트의 제한 사항

• 빈 파일: CLI은 Delta 매니페스트에서 빈 파일을 로그하고 제외합니다. 업로드를 중단하지 않고 배포를 변경할 수 있는 빈 파일을 업로드하는 것을 피하세요. Delta 번들의 경로에 빈 파일을 포함하지 마세요. Ignoring empty file... 공간이 있는 경로:
• Delta 업로드는 공간이 있는 번들의 경로를 감지하기 전에 파일을 업로드합니다. 업로드하기 전에 공간이 있는 파일이나 디렉토리를 이름을 변경하세요. Delta(매니페스트) 업데이트를 강제하는 방법

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

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 번들 다운로드를 계속한다면), 다음을 확인하세요:

• Delta (매니페스트) 업데이트를 사용 중인지 확인하세요. --delta 매니페스트 업데이트를 사용할 때마다
• 매니페스트 업데이트를 사용 중인지 확인하세요. --delta-only매니페스트 업데이트를 사용할 때 --delta 매니페스트 업데이트를 사용할 때
• Capgo 플러그인의 최신 버전을 실행하는 장치
• Capgo 서버에 접근할 수 있는 안정적인 네트워크 연결을 가진 장치

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

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

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

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

Delta 업데이트를 사용하려면 --delta 업데이트할 때마다 Delta (매니페스트) 업데이트로 전송하고 싶다면 매번 이 플래그를 사용해야 합니다. 플래그를 생략하면 Capgo이 전체 JS 번들을 단일 파일로 업로드하고, 장치에서는 변경된 부분이 작더라도 전체 번들을 다운로드합니다.

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

Delta 업데이트를 사용하고 있다면 Delta 업데이트 Delta 업데이트를 사용하여 라이브 업데이트를 계획하려면 __CAPGO_KEEP_0__ Live Updates와 연결하세요. Capgo Live Updates Capgo Live Updates에서 제품 워크플로우를 연결하세요. 개요 개요 기능 업데이트 동작 implementation detail in Features implementation detail in Update Behavior 업데이트 유형 implementation detail in Update Types