자동 업데이트

설치 단계와 이 플러그인의 전체 마크다운 가이드를 포함한 설치 지시문을 복사하세요.

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

배포할 준비

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

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

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

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

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

__CAPGO_KEEP_0__ 생성

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

To generate the checksum for your bundle, use the Capgo CLI zip command with the --json 클립보드에 복사

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

__CAPGO_KEEP_0__을 생성할 때 __CAPGO_KEEP_0__ 정보를 포함하세요.

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 Using @capgo/capacitor-업데이터 for the native capability in Using @capgo/capacitor-업데이터 Capgo 기업 for the product workflow in Capgo Enterprise, Page/area: 기업 제품/가격 페이지. 역할: 짧은 UI 레이블 또는 네비게이션 아이템. Seen in: page enterprise.astro. Capgo 제품/브랜드 및 개발자 용어를 정확히 유지. 메시지 키 `enterprise_procurement_visual_signature` (기업 구매 시각적 서명). for the product workflow in __CAPGO_KEEP_0__ 기업 Capgo Alternatives for the product workflow in Capgo Alternatives, and Capgo 대안 for the product workflow in Capgo 대안, 그리고