자동 업데이트

이 플러그인의 설치 단계와 전체 마크다운 가이드를 포함하여 복사할 수 있는 설정 프롬프트를 복사하십시오.

자동 업데이트 서버를 실행하는 방법을 설명하는 문서입니다.

배포할 번들

배포할 번들을 제공하는 방법에 대해 익숙하지 않다면, __CAPGO_KEEP_0__ Cloud를 시도하거나 예시를 여기서 확인하세요: https://myserver.com/app/updates/updates.json

If you’re unfamiliar with serving a bundle, we recommend you try Capgo Cloud or see an example here:

설정

추가하기 updateUrl 앱에 추가하기 capacitor.config.json.

{
  "plugins": {
    "CapacitorUpdater": {
      "updateUrl": "https://myserver.com/app/updates/updates.json",
    }
  }
}

API 업데이트

앱이 열릴 때마다 플러그인은 API에 POST 요청을 보내고, 요청 본문은 다음과 같습니다:

interface AppInfos {
    "platform": "ios" | "android" | "electron",
    "device_id": "UUID_of_device_unique_by_install",
    "app_id": "APPID_FROM_CAPACITOR_CONFIG",
    "custom_id": "your_custom_id_set_on_runtime",
    "plugin_version": "PLUGIN_VERSION",
    "version_build": "VERSION_NUMBER_FROM_NATIVE_CODE",
    "version_code": "VERSION_CODE_FROM_NATIVE_CODE",
    "version_name": "LAST_DOWNLOADER_VERSION" | "builtin"
    "version_os": "VERSION_OF_SYSTEM_OS",
    "is_emulator": boolean,
    "is_prod": boolean,
}

API 서버는 capacitor-업데이터 플러그인에 JSON 형식으로 응답해야 합니다. 업데이트가 필요할 경우, 이 데이터를 사용합니다.

{
"version": "1.2.3",
"url": "https://myserver.com/app/updates/my-new-app-2.0.0.zip",
"checksum": "sha256_checksum_of_bundle"
}

자동 업데이트 모드에서 서버는 버전을 비교하고 올바른 버전을 반환해야 합니다. URL 키가 존재하는 경우 플러그인은 다운로드 프로세스를 시작합니다.

message

version error semver 키는

형식입니다. index.html zip은 index.html 파일을 루트에, 또는 루트에 하나의 폴더만 있는 경우 폴더 내에

You can use the command of the CLI to zip your bundle:

npx @capgo/cli bundle zip --path [/path/to/my/bundle]

__CAPGO_KEEP_0__를 복사하여 클립보드에 붙여넣기합니다.

중요: Capgo CLI을 사용하여 Capgo 플러그인이 사용하는 특정 zip 형식과 구조를 보장하는 공식 CLI 도구를 사용하여 bundle zip 파일을 생성해야 합니다. 표준 zip 유틸리티는 호환되지 않는 아카이브를 생성할 수 있습니다.

bundle에 대한 체크섬을 생성하려면 Capgo CLI zip 명령어를 사용하세요. --json flag:

npx @capgo/cli bundle zip [appId] --json

이 명령어는:

Capgo 플러그인이 사용하는 호환된 zip 파일을 생성합니다.
SHA256 체크섬을 사용하여 무결성 확인을 위해 생성합니다.
JSON 형식으로 bundle 정보를 출력합니다.

예시 출력:

{
  "version": "1.2.3",
  "checksum": "a1b2c3d4e5f6789...",
  "size": 1234567
}

__CAPGO_KEEP_0__에서 사용하는 checksum 이 출력의 값을 API 응답에 넣어 설치 전 플러그인이 번들完整성을 확인할 수 있도록 하세요.

자동 업데이트에서 계속

__CAPGO_KEEP_0__를 사용하는 경우 자동 업데이트 자동 업데이트와 __CAPGO_KEEP_0__를 연결하여 enterprise 운영 및 마이그레이션 계획을 관리하세요. capgo/capacitor-업데이터를 사용하여 capgo/capacitor-업데이터의 네이티브 기능을 사용하는 경우 Capgo Enterprise Capgo Enterprise의 제품 워크플로우를 사용하는 경우 Ionic Enterprise Plugin 대체 옵션 Ionic Enterprise Plugin 대체 옵션의 제품 워크플로우에 대해 Capgo 대체 옵션 Capgo 대체 옵션의 제품 워크플로우에 대해, 그리고 Capgo 컨설팅 Capgo 컨설팅의 제품 워크플로우에 대해.