메뉴로 바로가기
Capgo - Capacitor 앱용 Live Updates Capgo

Delta 업데이트

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

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

두 번째 이점은 앱이 큰 자산을 변경하지 않으면서 자주 변경되지 않는 이미지나 비디오와 같은 자산을 사용할 때입니다. 이 경우 zipped JS 파일과 비교하여 다운로드가 한번만 이루어집니다.

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

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

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

  1. 각 빌드 파일이 개별로 업로드됩니다.
  2. 각 파일에 대한 체크섬이 생성됩니다.
  3. 새로운 json 매니페스트가 생성되며, 모든 파일과 체크섬을 목록화합니다.
  4. 이 매니페스트는 Capgo 데이터베이스에 업로드됩니다.

앱을 실행하는 장치가 업데이트를 확인할 때, Capgo 플러그인은 서버에서 새로운 매니페스트를 받습니다. 플러그인은 현재 가지고 있는 매니페스트와 비교하여, 체크섬과 파일 경로를 기반으로 변경된 파일을 식별합니다.

플러그인은 변경된 파일만 다운로드합니다. 전체 JS 번들을 다운로드하는 대신. 다운로드한 파일을 combination하여, 변경되지 않은 파일과 합쳐 새로운 앱 버전을 재구성합니다.

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

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

To enable Delta (manifest) updates for your Capgo app, simply use the --delta __CAPGO_KEEP_0__를 업로드할 때 새로운 버전의旗를 올립니다.:

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

만약 autoUpdate 즉시 적용 모드 ("atInstall", "onLaunch", 또는 "always")로 설정되어 있는 경우 __CAPGO_KEEP_0__가 이를 감지합니다. 비 인터랙티브 환경에서는 Delta (매니페스트) 업데이트를 자동으로 보내고, 인터랙티브 환경에서는 업로드하기 전에 확인을 요청합니다. LEGACY capacitor.config설정은 여전히 감지됩니다. CLI를 사용하여 전체 번들 업로드를 강제합니다. directUpdate 델타(매니페스트) 업데이트를 강제하는 것 --no-delta Section titled “델타(매니페스트) 업데이트를 강제하는 것”

Enforcing Delta (Manifest) Updates

Section titled “Enforcing Delta (Manifest) Updates”

Delta 업로드를 보장하고 오류로 인한 전체 패키지 업로드를 방지하려면 --delta-only flag:

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

When --delta-only 이 옵션이 사용될 때 Capgo는 개별 파일만 업로드하고 매니페스트를 생성합니다. Delta (매니페스트) 업데이트를 지원하지 않는 장치가 업데이트를 다운로드할 수 없습니다.

이 옵션을 사용하는 경우 --delta-only if:

  • Delta (매니페스트) 업데이트를 항상 사용하고 전체 패키지 업로드를 허용하지 않습니다.
  • CI/CD PIPELINE을 설정하고 자동 업로드가 Delta (매니페스트) 업데이트로만 이루어지길 원합니다.
  • 앱이 크고 대역폭이 제한되어 있으므로 업로드/다운로드 크기를 최소화해야 합니다.

전체 패키지 업로드를 수행해야 하는 경우 --delta-only 설정이 설정되어 있다면, 단순히 업로드 명령어를 실행하시면 됩니다. --delta-only이것은 해당 업로드에 대한 설정을 덮어쓰게 하여, 필요할 때 완전한 번들을 푸시할 수 있도록 합니다.

문제 해결

제목이 “문제 해결”인 섹션

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

  • Capacitor 플러그인을 사용하고 있다면, --delta flag를 업로드할 때마다 사용하시기 바랍니다.
  • Capacitor 플러그인을 사용하고 있다면, --delta-onlyflag를 생략하지 않았는지 확인하세요. --delta 장치에서 최신 버전의 __CAPGO_KEEP_0__ 플러그인이 실행되고 있는지 확인하세요.
  • 장치가 안정적인 네트워크 연결을 가지고 있고 Capgo 서버에 접근할 수 있는지 확인하세요.
  • Your device has a stable network connection and can reach the Capgo servers

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

  1. Go to the 웹앱
  2. 앱 클릭
  3. stat 바의 번들 수를 클릭합니다.
  4. 마지막 번들을 선택합니다.
  5. __CAPGO_KEEP_0__ Partial field 번들 유형

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

업데이트가 완료되었습니다! --delta Capgo는 개별 파일 업로드 및 매니페스트 생성이 필요하다는 것을 알려줍니다.

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

델타 업데이트로 계속 가기

“델타 업데이트로 계속 가기”라는 제목의 섹션

__CAPGO_KEEP_0__ Live Updates 델타 업데이트를 사용하여 실시간 업데이트를 계획하고 싶다면 __CAPGO_KEEP_0__ Live Updates와 연결해야 합니다. Capgo Live Updates Capgo Live Updates의 제품 워크플로에 __CAPGO_KEEP_0__ Live Updates __CAPGO_KEEP_0__ Live Updates __CAPGO_KEEP_0__ Live Updates 기능의 구현 세부 정보에 대해 업데이트 동작 업데이트 동작의 구현 세부 정보 및 업데이트 유형 업데이트 유형의 구현 세부 정보.