자동 업데이트

이 설정 프롬프트를 복사하여 설치 단계와 이 플러그인의 전체 마크다운 가이드를 포함합니다.

자동 업데이트 서버를 실행하는 방법에 대한 이 문서는 설명합니다.

배포

bundle이 HTTPS를 통해 제공되고, 앱이 업데이트를 다운로드할 수 있도록 서버가 올바른 CORS 헤더를 가지고 있는지 확인하세요. e.g. https://myserver.com/app/updates/updates.json

bundle을 제공하는 방법에 대해 익숙하지 않다면 Capgo Cloud를 사용해 보거나 예시를 여기서 확인하세요:

자동 배포

설정

설정에 추가하세요 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’ 및 ‘error’ 키를 추가하면 버전이 설정되지 않고 로그에 표시되는 메시지가 표시됩니다.

version 형식이어야 합니다. semver format.

루트 폴더 내에 있어야 합니다. index.html Capgo의 명령을 사용하여 번들을 zip할 수 있습니다: index.html inside.

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

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

파일 묶음 체크섬 생성

중요: You must use the Capgo CLI to create your bundle zip file. The Capgo plugin requires a specific zip format and structure that is only guaranteed when using the official CLI tool. Standard zip utilities may create incompatible archives.

파일 묶음 체크섬을 생성하려면 Capgo CLI zip 명령어를 사용하세요. --json flag:

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

이 명령어는 다음과 같이 작동합니다.

Capgo 플러그인과 호환되는 올바른 형식의 zip 파일을 생성하세요.
SHA256 체크섬을 생성하여完整성 검증을 위해
JSON 형식으로 배포 정보를 출력합니다.

예시 출력:

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

자동 업데이트 checksum 이러한 출력에서 값을 가져와 API 응답에 포함하여 플러그인을 설치하기 전에 번들의 무결성을 확인할 수 있도록 하십시오.

이 출력에서 제공하는 값을 __CAPGO_KEEP_0__ 응답에 포함하여 플러그인이 배포의完整성을 확인하기 전에 설치를 허용하도록 하세요.

자동 업데이트에서 계속하기 자동 업데이트 기능을 사용 중이라면 자동 업데이트 자동 업데이트 기능을 사용 중이라면 enterprise 운영 및 마이그레이션 계획을 위해 연결하세요. @capgo/capacitor-업데이터 Capgo의 내장 기능을 사용하는 @capgo/capacitor-업데이터를 위해 Capgo 기업 버전 Capgo 제품 워크플로우를 위한 Ionic Enterprise 플러그인 대체 Ionic Enterprise 플러그인 대체의 제품 워크플로우를 위해 Capgo 대체 방법 Capgo 제품 워크플로우에서 Alternatives, 및 Capgo 자문 Capgo 제품 워크플로우를 위한 서비스.