자동 업데이트

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

HTTPS를 통해 배포된 번들을 제공하세요

Section titled “Serve your bundle” https://myserver.com/app/updates/updates.json

Capgo Cloud 또는 예시를 보려면 여기를 클릭하세요.

배포할 파일을 서버에 올리기

설정

__CAPGO_KEEP_0__를 추가하세요. updateUrl __CAPGO_KEEP_0__ capacitor.config.json.

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

주의

자신의 서버에서 업데이트를 푸시할 때는 Android 앱의 보안 정책에 맞지 않는 'HTTP' 엔드포인트를 사용할 수 없습니다. 테스트 용도로는 'allow it'을 허용할 수 있습니다. __CAPGO_KEEP_0__를 업데이트하세요..

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는 JSON 형식으로 capacitor-업데이터 플러그인에 응답해야 합니다. 업데이트가 필요한 경우 데이터를 반환해야 합니다:

{
"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 키는 ‘__CAPGO_KEEP_2__’ 형식이어야 합니다. semver 압축 파일은 루트 디렉토리에 ‘__CAPGO_KEEP_3__’ 파일이 있어야 합니다. 또는 루트 디렉토리에 하나의 폴더만 존재하고 그 안에 ‘__CAPGO_KEEP_3__’ 파일이 있어야 합니다.

Copy to clipboard index.html The server __CAPGO_KEEP_0__ should respond, in JSON, to the __CAPGO_KEEP_1__-updater plugin. With this data if an update is necessary: index.html Copy to clipboard

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

서버에서 제공할 파일과 함께 번들을 생성하세요.

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

번들 체크섬 생성

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

번들 체크섬을 생성하려면 Capgo CLI zip 명령어를 사용하세요. 다음 플래그를 사용하세요: --json 체크섬 정보가 포함된 번들을 생성하세요.

클립보드에 복사

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

__CAPGO_KEEP_0__은 placeholder입니다. __CAPGO_KEEP_1__은 placeholder입니다. __CAPGO_KEEP_2__은 placeholder입니다. __CAPGO_KEEP_3__은 placeholder입니다.

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

예시 출력:

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

__CAPGO_KEEP_0__ 응답에서 사용할 값을 이 출력에서 가져와서 플러그인이 설치 전 배포의 인TEGRITY를 검증할 수 있도록 하세요. checksum value from this output in your API response to ensure the plugin can verify the bundle integrity before installation.

자동 업데이트에서 계속 진행하세요.

자동 업데이트 기능을 사용 중이라면, 이에 연결하세요. __CAPGO_KEEP_0__ __CAPGO_KEEP_0__ Using @capgo/capacitor-업데이터 for the native capability in Using @capgo/capacitor-업데이터, Capgo 엔터프라이즈 for the product workflow in Capgo 엔터프라이즈, 아이온틱 엔터프라이즈 플러그인 대안 for the product workflow in 아이온틱 엔터프라이즈 플러그인 대안, Capgo 대안 for the product workflow in Capgo 대안, 그리고 Capgo 컨설팅 for the product workflow in Capgo 컨설팅.