__CAPGO_KEEP_6__

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

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

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

두 번째 이점은 앱이 큰 자산을 가지고 있고 자주 변경되지 않는 경우, 예를 들어 이미지 또는 비디오와 같은 경우, 압축된 JS 파일에 비해 다운로드가 한번만 이루어집니다.

델타(매니페스트) 업데이트는 어떻게 작동하는가

델타(매니페스트) 업데이트는 Capgo에서 Capgo 플러그인이 설치된 앱에 의해 처리됩니다. __CAPGO_KEEP_2__을 사용하여 앱의 새로운 버전을 업로드할 때 --delta 기호, Capgo은 다음과 같은 작업을 수행합니다.:

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

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

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

델타(매니페스트) 업데이트를 활성화합니다.

Delta (manifest) 업데이트를 Capgo 앱에 활성화하려면, 단순히 다음 플래그를 사용하여 새로운 버전을 업로드하세요: --delta 업로드할 때

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

만약 autoUpdate 즉시 적용 모드 ("atInstall", "onLaunch", 또는 "always")로 설정되어 있다면 __CAPGO_KEEP_0__는 이를 감지합니다. 비 인터랙티브 환경에서는 Delta (manifest) 업데이트를 자동으로 보내고, 인터랙티브 환경에서는 업로드하기 전에 확인을 요청합니다. LEGACY 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 Delta (Manifest) 업데이트를 강제

Delta (manifest) 업데이트를 __CAPGO_KEEP_0__ 앱에 활성화하려면, 단순히 다음 플래그를 사용하여 새로운 버전을 업로드하세요:

전체 업로드가 Δelta (매니페스트) 업데이트로만 이루어지고, 의도치 않은 전체 배포 업로드가 발생하지 않도록 하려면 --delta-only flag:

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

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

Δelta 업데이트를 항상 사용하고, 전체 배포 업로드를 허용하지 않으려면 --delta-only CI/CD PIPELINE을 설정하고, 모든 자동 업로드가 Δelta 업데이트로 이루어지도록 하려면

앱이 크고, 대역폭이 제한되어 있으므로, 업로드/다운로드 크기를 최소화해야 하므로
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

이러한 작업을 완전히 업로드하려면 <targetLanguage>에서 "fullBundle" 옵션을 설정한 경우, 단순히 업로드 명령어를 실행하면 됩니다. 이 옵션은 단일 업로드에만 적용되며, 필요할 때 완전한 업로드를 푸시할 수 있습니다. --delta-only <targetLanguage>에서 "fullBundle" 옵션이 설정된 경우, 단순히 업로드 명령어를 실행하면 됩니다. --delta-only이 옵션은 단일 업로드에만 적용되며, 필요할 때 완전한 업로드를 푸시할 수 있습니다.

문제 해결

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

<targetLanguage>에서 "--delta" 플래그를 업로드할 때마다 사용했는지 확인하세요. --delta <targetLanguage>에서 "--delta" 플래그를 사용하는 경우, "--no-delta" 플래그를 사용하지 않았는지 확인하세요.
<targetLanguage>에서 "--no-delta" 플래그를 사용하지 않았는지 확인하세요. --delta-only<targetLanguage>에서 "--no-delta" 플래그를 사용하지 않았는지 확인하세요. --delta <targetLanguage>에서 "--no-delta" 플래그를 사용하지 않았는지 확인하세요.
Your device is running the latest version of the Capgo plugin
Capgo 서버에 연결이 안정적이고 접근할 수 있는 경우, 장치가 네트워크 연결을 가지고 있습니다.

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

웹앱 웹앱
앱 클릭
stat 바의 번들 수를 클릭합니다.
마지막 번들을 선택합니다.
체크 Partial field

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

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

__CAPGO_KEEP_0__을 사용할 때마다 업로드하는 새로운 버전이 Delta (manifest) 업데이트로 전달되기를 원한다면 매번 이 플래그를 사용해야 합니다. 플래그를 생략하면 __CAPGO_KEEP_0__은 전체 JS 번들을 하나의 파일로 업로드하고, 변경된 부분이 작더라도 장치에서는 전체 번들을 다운로드합니다. --delta every time you upload a new version that you want to be delivered as a Delta (manifest) update. If you omit the flag, Capgo will upload the entire JS bundle as a single file, and devices will download the whole bundle even if only a small part has changed.

Delta 업데이트로 계속 진행하기

Delta 업데이트를 사용하여 __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의 구현 세부 정보를 참조하세요. 기능 기능 구현 세부 사항에 대해 업데이트 동작 업데이트 동작 구현 세부 사항에 대해, 업데이트 유형 업데이트 유형 구현 세부 사항에 대해.