델타 업데이트

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

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

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

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. 새로운 json 매니페스트가 생성되며, 모든 파일과 체크섬이 목록화됩니다.
2. 이 매니페스트는 __CAPGO_KEEP_0__ 데이터베이스에 업로드됩니다.
3. __CAPGO_KEEP_0__ 플러그인이 새로운 매니페스트를 서버에서 받고, 현재 가지고 있는 매니페스트와 비교하여 파일이 변경된 것을 식별합니다. 체크섬과 파일 경로를 기준으로.
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.

__CAPGO_KEEP_0__

Manifest

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

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

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

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

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

Delta 업데이트의 제한 사항

• __CAPGO_KEEP_0__이 로그를 남기고 Delta 매니페스트에서 0바이트 파일을 제외합니다. 업로드를 중단하지 않고 배포를 변경할 수 있는 결과물이 달라질 수 있으므로 Delta 번들 경로에 0바이트 파일을 포함하지 마십시오. The CLI logs Ignoring empty file... Delta 업로드가 파일을 업로드하기 전에 실패합니다. 경로에 공백이 있는 경우 파일이나 디렉터리를 이름을 바꾸어 공백을 제거한 후 Delta 업데이트를 업로드하십시오.
• Delta 업데이트를 강제로 업로드하는 방법 제목: Delta 업데이트를 강제로 업로드하는 방법

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

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

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

사용할 때, __CAPGO_KEEP_0__는 개별 파일만 업로드하고 매니페스트를 생성합니다. 델타(매니페스트) 업데이트 지원하지 않는 장치가 업데이트를 다운로드할 수 없습니다. --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.

if: --delta-only 항상 델타(매니페스트) 업데이트만 사용하고 전체 배포 업로드를 허용하지 않습니다.

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

If you need to do a full bundle upload while --delta-only 업로드 명령어를 실행하면 업데이트가 자동으로 설정됩니다. --delta-only이 설정을 오버라이드하려면 단일 업로드에 대해 업데이트를 실행하세요. 필요한 경우 완전한 번들을 푸시할 수 있습니다.

문제 해결

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

• Delta 업데이트를 사용 중인지 확인하세요. --delta Delta 업데이트를 사용할 때마다 새로운 버전을 업로드할 때
• Delta 업데이트를 사용 중인지 확인하세요. --delta-onlyDelta 업데이트를 사용할 때마다 새로운 버전을 업로드할 때 --delta 최신 버전의 __CAPGO_KEEP_0__ 플러그인을 실행 중인지 확인하세요.
• 최신 버전의 Capgo 서버에 접속할 수 있는穩定的 네트워크 연결을 확인하세요.
• Capgo

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

1. 다음으로 이동하세요: 웹 앱
2. 앱 클릭
3. stat 바의 배포 번호 클릭
4. 마지막 배포 선택
5. 세부 정보 Partial field

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

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

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

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

Delta 업데이트를 사용하고 있습니다. Delta 업데이트 Delta 업데이트를 사용하여 Capgo Live Updates Capgo Live Updates Capgo Live Updates Overview Overview Capgo 기능의 구현 세부 사항에 대해 업데이트 동작 업데이트 동작의 구현 세부 사항에 대해, 그리고 업데이트 유형 업데이트 유형의 구현 세부 사항에 대해.