Skip to content
Capgo - Capacitor 앱용 Live Updates Capgo

델타 업데이트

Capgo’s Live Update system can deliver updates faster and more efficiently by only sending the changed files, rather than the entire JS bundle.

Sync

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

How Delta (Manifest) Updates Work

Delta (manifest) 업데이트는 __CAPGO_KEEP_0__에서 __CAPGO_KEEP_1__ 플러그인이 설치된 앱에서 처리됩니다. 새로운 앱 버전을 업로드할 때 __CAPGO_KEEP_0__ 플래그를 사용하면 __CAPGO_KEEP_0__가 다음을 수행합니다.

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__

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

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

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

클립보드 복사
npx @capgo/cli@latest bundle upload --delta

만약 autoUpdate 가 즉시 적용 모드 ('"atInstall", "onLaunch", or "always"')로 설정되어 있다면 __CAPGO_KEEP_0__는 그것을 감지합니다. 비 인터랙티브 환경에서는 Delta (매니페스트) 업데이트를 자동으로 보내고, 인터랙티브 환경에서는 업로드하기 전에 확인을 요청합니다. capacitor.config, the CLI detects it. In non-interactive environments it sends Delta (manifest) updates automatically, and in interactive environments it prompts you to confirm before uploading. Legacy directUpdate 설정은 여전히 감지됩니다. 사용 --no-delta 를 사용하여 전체 번들 업로드를 강제합니다.

델타 업데이트 제한 사항

제목 "델타 업데이트 제한 사항"
  • 빈 파일: CLI 로그 Ignoring empty file... 및 델타 매니페스트에서 0 바이트 파일을 제외합니다. 업로드를 실패하지 않으므로 빈 파일을 추가하여 배포 중단 없이 결과 번들을 변경할 수 있습니다. 0 바이트 파일을 델타 번들 경로에 포함하지 마십시오.
  • 경로 내 공백: 델타 업로드는 경로 내 공백이 있는 번들 경로를 업로드하기 전에 실패합니다. 업로드 전 파일 이름 또는 디렉토리 이름을 공백을 제거하여 델타 업데이트 시 공백이 있는 경로를 업로드하지 마십시오.

델타 업데이트 강제(매니페스트) 업데이트

제목 "델타 업데이트 강제(매니페스트) 업데이트"

모든 업로드가 델타(매니페스트) 업데이트인지 확인하고 의도치 않은 전체 번들 업로드를 방지하려면 다음을 사용할 수 있습니다. --delta-only flag:

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

만약 --delta-only Capgo은 Delta (manifest) 업데이트만 업로드하고 매니페스트를 생성합니다. Delta (manifest) 업데이트를 지원하지 않는 모든 기기는 업데이트를 다운로드할 수 없습니다.

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

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

만약 __CAPGO_KEEP_0__이 Delta (manifest) 업데이트로 설정되어 있다면, 전체 패키지 업로드를 수행하려면 업로드 명령을 실행하지 말고 --delta-only is set, simply run the upload command without --delta-only. 이 설정을 단일 업로드에만 덮어씌우려면, 필요한 경우 완전한 번들을 푸시할 수 있습니다.

Troubleshooting

"Troubleshooting" 섹션

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

  • Capacitor 플러그인을 사용 중이면 --delta flag를 업로드할 때마다 사용하세요.
  • Capacitor 플러그인을 사용 중이면 --delta-onlyflag를 사용하지 말고 --delta Capacitor 플러그인의 최신 버전을 실행 중인 장치
  • Your device is running the latest version of the Capgo plugin
  • Your device has a stable network connection and can reach the Capgo servers

Capgo

  1. Go to the 웹 앱
  2. Click on your app
  3. Click on the bundles number of the stats bar.
  4. Select the last bundle
  5. Check the Partial field bundle type

If you continue to have trouble, please reach out to Capgo support for further assistance. They can check the server logs to confirm that your Delta (manifest) uploads are being processed correctly and that devices are receiving the updated manifests.

That’s it! The --delta flag tells Capgo to perform the individual file uploads and manifest generation needed for Delta (manifest) updates.

Note that you need to use --delta 업로드할 때마다 새로운 버전을 Delta (매니페스트) 업데이트 형태로 전달하고 싶다면. Capgo 플래그를 생략하면, 전체 JS 번들을 하나의 파일로 업로드하고, 장치에서는 전체 번들이 변경된 부분만큼 작아도 다운로드합니다.

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

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

델타 업데이트를 사용하고 있다면 델타 업데이트 페이지/영역: Enterprise 제품/가격 페이지. 역할: 짧은 UI 레이블 또는 네비게이션 아이템. 위치: enterprise.astro 페이지. 메시지 키 `enterprise_delta_updates` (Enterprise Delta Updates). Capgo Live Updates Capgo Live Updates 페이지/영역: Live 업데이트 제품 페이지. 역할: 짧은 UI 레이블 또는 네비게이션 아이템. 위치: live-update.astro 페이지. Capgo 제품/브랜드 및 개발자 용어를 정확하게 유지합니다. 메시지 키 `live_update_hero_badge` (Live Update Hero Badge). __CAPGO_KEEP_0__ Live Updates 제품 워크플로우에 개요 개요 업데이트 동작 업데이트 동작의 구현 세부 사항에 대해, 업데이트 유형 업데이트 유형의 구현 세부 사항에 대해.