내용으로 건너뛰기
Capgo - Capacitor 앱을 빌드, 배포 및 업데이트 Capgo

자동 업데이트

GitHub

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

배포

배포

서비스를 제공하는 것이 중요합니다. HTTPS를 통해 배포하고, 앱이 업데이트를 다운로드할 수 있도록 서버에 적절한 CORS 헤더를 설정하십시오. 예를 들어 https://myserver.com/app/updates/updates.json

배포를 이해하지 못한다면, Capgo Cloud를 사용하거나 예시를 참조하십시오:

자동 배포

설정

설정

설정에 추가하세요 updateUrl 에 추가하세요 capacitor.config.json.

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

업데이트 API

업데이트 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 서버는 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 CLI의 명령어를 사용하여 번들을 zip할 수 있습니다: index.html inside.

CLI 명령어를 사용하여 번들 압축할 수 있습니다.

파일을 서버에서 제공하기 위해 묶인 번들을 생성하세요.
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__ 응답에 사용하여 플러그인이 설치 전에 배포의完整성을 검증할 수 있도록 하십시오.

자동 업데이트에서 계속

자동 업데이트에서 계속하기 자동 업데이트 기능을 사용 중이라면 자동 업데이트 기능을 사용 중이라면 Using @capgo/capacitor-updater Capgo native 기능을 사용하는 @capgo/capacitor-업데이터를 위해 Capgo 기업 버전 Capgo Enterprise 제품 워크플로우를 위한 Capgo 제품 워크플로우 Ionic Enterprise Plugin 대체품 Capgo 대체 방법 Capgo 제품 워크플로우에서 Alternatives, 및 Capgo 자문 Capgo 제품 워크플로우를 위한 컨설팅을 위해.