__CAPGO_KEEP_0__

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

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

배포할 준비

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 섹션

The plugin will do a POST call to your API each time the app is open, with this body:

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,
}

The server API should respond, in JSON, to the capacitor-updater plugin.

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

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

메시지

version 에러 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]

Bundle 생성 확인 해시

중요: 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와 연결하세요. Using @__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-updater Using @__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-updater Using @capgo/capacitor-updater for the native capability in Using @capgo/capacitor-updater, Capgo Enterprise Capgo Enterprise 제품 워크플로우를 위해 아이오닉 엔터프라이즈 플러그인 대안 __CAPGO_KEEP_0__ 엔터프라이즈 플러그인 대안 Capgo 대안 Capgo 대안 제품 워크플로우를 위해 Capgo 컨설팅 제품 워크플로우를 위해 for the product workflow in Capgo Consulting.