자동 업데이트

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

배포할 준비가되었습니다

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

만들어 보지 못한 Capgo Cloud를 사용해 보거나 여기 있는 예시를 참조해 보세요:

배포

설정

설정 섹션 updateUrl 설정 capacitor.config.json.

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

주의

자신이 만든 업데이트 시, Android 앱의 보안 정책에 맞지 않아 'HTTP' 엔드포인트를 사용할 수 없습니다. 테스트 용도로는 __CAPGO_KEEP_0__를 허용할 수 있습니다. 업데이트.

API

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

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 key는 semver 형식이어야 합니다.

zip은 index.html 루트 디렉토리에 파일 하나 또는 루트 디렉토리에 폴더 하나만 존재해야 합니다. 폴더 내부에는 index.html 내용이 있어야 합니다.

CLI 명령어를 사용하여 배포본을 압축할 수 있습니다:

서버에서 파일을 제공하기 위해 배포본을 생성하세요

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

배포본 체크섬 생성

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

Capgo CLI zip 명령어를 사용하여 배포본의 체크섬을 생성하세요. --json flag:

체크섬 정보가 포함된 배포본을 생성하세요

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

이 명령어는:

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

예시 출력:

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

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

Auto Update에서 계속 진행하세요.

Auto Update Auto Update Auto Update @capgo/capacitor-업데이터를 사용하여 native 기능을 위해 @capgo/capacitor-업데이터를 사용하여 Capgo Enterprise Capgo Enterprise 아이온 Enterprise 플러그인 대안 아이온 Enterprise 플러그인 대안 Capgo 대안 Capgo 대안 Capgo 컨설팅 Capgo 컨설팅