설정

업데이트 시스템에 대한 더 세부적인 제어를 원하시면, 다음 설정으로 구성할 수 있습니다.

팁

capacitor.config 파일의 이러한 설정에 대한 변경은, 프로덕션 앱이 변경 사항을 받기 위해 플랫폼을 동기화하고 스토어에 릴리즈해야합니다.

주의

Capgo 유럽 데이터 거주지 요구를 위해 Cloud를 설정하세요. updateUrl to https://plugin.eu.capgo.app/updates, statsUrl to https://plugin.eu.capgo.app/stats, channelUrl to https://plugin.eu.capgo.app/channel_self. Data Location.

allowModifyUrl

URL을 JavaScript에서 동적으로 수정할 수 있도록 업데이트 URL, 통계 URL 및 채널 URL을 수정할 수 있는 플러그인을 허용합니다.

Android, iOS 및 Electron에서 사용할 수 있습니다.

기본값: false

capacitor.config.json

{
  "plugins": {
    "CapacitorUpdater": {
      "allowModifyUrl": true
    }
  }
}

appId

앱 ID를 설정하세요.

Android, iOS, 및 Electron에서 사용 가능합니다.

기본값: undefined

capacitor.config.json

{
  "plugins": {
    "CapacitorUpdater": {
      "appId": "com.example.app"
    }
  }
}

appReadyTimeout

네이티브 플러그인을 업데이트가 실패한 것으로 간주하기 전에 기다리는 밀리초 수를 설정하세요.

Android, iOS, 및 Electron에서 사용 가능합니다.

기본값: 10000 10초

capacitor.config.json

{
  "plugins": {
    "CapacitorUpdater": {
      "appReadyTimeout": 1000
    }
  }
}

autoDeleteFailed

자동 삭제 실패 플러그인 설정

안드로이드, iOS, 및 Electron에서 사용 가능

기본값: true

capacitor.config.json

{
  "plugins": {
    "CapacitorUpdater": {
      "autoDeleteFailed": false
    }
  }
}

autoDeletePrevious

자동 이전 삭제 플러그인 설정

안드로이드, iOS, 및 Electron에서 사용 가능

기본값: true

capacitor.config.json

{
  "plugins": {
    "CapacitorUpdater": {
      "autoDeletePrevious": false
    }
  }
}

autoSplashscreen

스플래시 화면을 자동으로 숨기기 위해 즉시 적용 모드 사용 시 숨기기 이벤트를 자동으로 처리합니다. 활성화 시, 플러그인은 업데이트가 적용되거나 업데이트가 필요하지 않은 경우 스플래시 화면을 자동으로 숨깁니다. 이러한 업데이트를 위해 수동으로 앱이 준비되면 스플래시 화면을 숨기기 위해 스플래시 화면 숨기기 함수를 호출할 필요가 없습니다. 이 기능은 autoUpdate 만 활성화됩니다. Legacy "atInstall", "onLaunch"값은 백워드 호환성을 위해 여전히 지원됩니다. @__CAPGO_KEEP_0__/splash-screen 플러그인이 설치되어 launchAutoHide: false로 구성되어야 하며, 자동 업데이트 기능이 활성화되어야 합니다. Android, iOS, Electron에서 사용할 수 있습니다. "always"기본값: directUpdate capacitor.config.json

__CAPGO_KEEP_0__.config.json

__CAPGO_KEEP_0__.config.json false

capacitor.config.json

{
  "plugins": {
    "CapacitorUpdater": {
      "autoUpdate": "atInstall",
      "autoSplashscreen": true
    }
  }
}

autoUpdate

자동 업데이트 서버를 통해 자동 업데이트를 사용하는 방법을 설정합니다. 이전 버전의 호환성을 위해 boolean 값도 지원됩니다: true 동일합니다. "atBackground" 또는 false 동일합니다. "off".

선택 항목:

• "off" 또는 false: 자동 업데이트를 비활성화합니다.
• "atBackground" 또는 true: 앱이 백그라운드에 이동할 때 자동으로 다운로드하고 적용합니다.
• "atInstall": 새 설치 또는 네이티브 앱 업데이트 후에 즉시 적용하거나, 그렇지 않으면 "atBackground"
• "onLaunch": 앱이 시작될 때 즉시 적용하거나, 그렇지 않으면 "atBackground" after the launch check
• "always": 즉시 적용할 때마다 Auto Update가 실행될 때
• "onlyDownload": 자동으로 확인하고 다운로드할 때, emit할 때 updateAvailable자동으로 다음 번들 설정하지 않습니다.

Android, iOS, 및 Electron에서 사용할 수 있습니다.

기본값: "atBackground" (true , 여전히 적용됩니다)

capacitor.config.json

{
  "plugins": {
    "CapacitorUpdater": {
      "autoUpdate": "onlyDownload"
    }
  }
}

channelUrl

채널 연산에 대한 URL/엔드포인트를 구성합니다.

Android, iOS, 및 Electron에서 사용할 수 있습니다.

Default: https://plugin.capgo.app/channel_self

capacitor.config.json

{
  "plugins": {
    "CapacitorUpdater": {
      "channelUrl": "https://example.com/api/channel"
    }
  }
}

defaultChannel

앱의 기본 채널을 config에서 설정하세요. 대/소문자 구분. 이 설정은 클라우드에서 설정한 기본 채널을 덮어씁니다. 하지만 클라우드에서 설정한 채널을 덮어씁니다. 클라우드에서 설정한 채널을 덮어씁니다.

Android, iOS, Electron에서 사용 가능합니다.

Default: undefined

capacitor.config.json

{
  "plugins": {
    "CapacitorUpdater": {
      "defaultChannel": "production"
    }
  }
}

directUpdate

deprecated. string modes 대신 사용하세요: autoUpdate string modes 대신 사용하세요: "atInstall", "onLaunch"또는 "always"이 옵션은 기존 앱에 대해 지원됩니다.

옵션:

• false: 직접 업데이트 하지 않습니다
• 'atInstall': __CAPGO_KEEP_0__.config.json과 동일합니다 autoUpdate: "atInstall"
• 'onLaunch': __CAPGO_KEEP_0__.config.json과 동일합니다 autoUpdate: "onLaunch"
• 'always': __CAPGO_KEEP_0__.config.json과 동일합니다 autoUpdate: "always"
• true: (deprecated) __CAPGO_KEEP_0__.config.json과 “always”와 동일합니다. (이 옵션은 향후 버전에서 제거될 예정입니다.)

Android, iOS, Electron에서 사용할 수 있습니다.

기본값: false

capacitor.config.json

{
  "plugins": {
    "CapacitorUpdater": {
      "autoUpdate": "atInstall"
    }
  }
}

disableJSLogging

자바스크립트 로깅을 비활성화합니다. true로 설정하면 플러그인은 자바스크립트 콘솔에 로그를 기록하지 않습니다. native 로그만 수행됩니다.

Android, iOS, Electron에서 사용 가능합니다.

기본값: false

capacitor.config.json

{
  "plugins": {
    "CapacitorUpdater": {
      "disableJSLogging": true
    }
  }
}

keepUrlPathAfterReload

URL 경로를 재로드 후 유지하도록 플러그인을 구성합니다.

주의

재로드가 트리거되면 'window.history'가 지워집니다.

Android, iOS, Electron에서 사용 가능합니다.

Default: false

capacitor.config.json

{
  "plugins": {
    "CapacitorUpdater": {
      "keepUrlPathAfterReload": true
    }
  }
}

periodCheckDelay

기간 업데이트 확인 지연 시간을 설정합니다. 단위는 초입니다. 600 초 (10분) 보다 작을 수 없습니다.

안드로이드, iOS, Electron에서 사용 가능합니다.

Default: 600 (10분)

capacitor.config.json

{
  "plugins": {
    "CapacitorUpdater": {
      "periodCheckDelay": 600 // (10 minutes)
    }
  }
}

publicKey

버전 2의 끝에서 끝까지 실시간 업데이트 암호화에 사용되는 공개 키를 설정합니다.

Android, iOS, 및 Electron에서 사용 가능합니다.

기본값: undefined

capacitor.config.json

{
  "plugins": {
    "CapacitorUpdater": {
      "publicKey": "YOUR_PUBLIC_KEY"
    }
  }
}

resetWhenUpdate

기기에 새로운 네이티브 앱 번들을 설치할 때 이전에 다운로드 한 번들을 자동으로 삭제합니다.

Android, iOS, 및 Electron에서 사용 가능합니다.

기본값: true

capacitor.config.json

{
  "plugins": {
    "CapacitorUpdater": {
      "resetWhenUpdate": false
    }
  }
}

responseTimeout

API이 타임아웃을 고려하기 전에 네이티브 플러그인을 몇 밀리초 동안 기다리게 할 수 있습니다.

Android, iOS, 및 Electron에서 사용 가능합니다.

기본값: 20 20초

capacitor.config.json

{
  "plugins": {
    "CapacitorUpdater": {
      "responseTimeout": 10 // (10 seconds)
    }
  }
}

shakeMenu

테스트/디버깅 목적으로 업데이트 메뉴를 표시하기 위해 흔들기 동작을 활성화합니다.

Android, iOS, 및 Electron에서 사용 가능합니다.

기본값: false

capacitor.config.json

{
  "plugins": {
    "CapacitorUpdater": {
      "shakeMenu": true
    }
  }
}

statsUrl

__CAPGO_KEEP_0__ URL/엔드포인트를 통계 업데이트 통계를 전송하는 데 사용됩니다.

Android, iOS, Electron에서 사용할 수 있습니다. ""으로 설정하여 명시적 통계 보고를 비활성화합니다. /stats.

비활성화 statsUrl Capgo 장치 저장소의 모든 항목을 비활성화하지는 않습니다. 만약 updateUrl 활성화되어 있다면 /updates 도 결제 MAU 행, 장치 인벤토리, 업데이트 결정 이벤트 데이터를 저장합니다. 업데이트 및 MAU 카운팅을 위해 필요한 데이터입니다. 규정 준수 세부 정보를 참조하십시오.

기본값: https://plugin.capgo.app/stats

capacitor.config.json

{
  "plugins": {
    "CapacitorUpdater": {
      "statsUrl": "https://example.com/api/stats"
    }
  }
}

updateUrl

__CAPGO_KEEP_0__.config.json을 설정하여 업데이트 확인을 위한 URL/엔드포인트를 구성하세요.

Android, iOS, Electron에서 사용 가능합니다.

기본값: https://plugin.capgo.app/updates

capacitor.config.json

{
  "plugins": {
    "CapacitorUpdater": {
      "updateUrl": "https://example.com/api/auto_update"
    }
  }
}

version

앱의 현재 버전을 구성하세요. 첫 번째 업데이트 요청에 사용됩니다. 설정하지 않으면 플러그인은 네이티브 code.에서 버전을 가져옵니다.

Android, iOS, Electron에서 사용 가능합니다.

기본값: undefined

capacitor.config.json

{
  "plugins": {
    "CapacitorUpdater": {
      "version": "1.0.0"
    }
  }
}

개발 설정

localApi

CLI을 사용하여 로컬 api을 테스트하기 위해 구성합니다.

기본값: undefined

capacitor.config.json

{
  "plugins": {
    "CapacitorUpdater": {
      "localApi": "http://localhost:54321/functions/v1"
    }
  }
}

localApiFiles

CLI을 사용하여 로컬 파일 api을 테스트하기 위해 구성합니다.

기본값: undefined

capacitor.config.json

{
  "plugins": {
    "CapacitorUpdater": {
      "localApiFiles": "http://localhost:54321/functions/v1/files"
    }
  }
}

localHost

CLI를 사용하여 로컬 서버를 테스트하거나 자체 호스팅 업데이트 서버를 구성하세요.

기본값: undefined

capacitor.config.json

{
  "plugins": {
    "CapacitorUpdater": {
      "localHost": "http://localhost:5173"
    }
  }
}

localSupa

CLI를 사용하여 로컬 서버를 테스트하거나 자체 호스팅 업데이트 서버를 구성하세요.

기본값: undefined

capacitor.config.json

{
  "plugins": {
    "CapacitorUpdater": {
      "localSupa": "http://localhost:54321"
    }
  }
}

localSupaAnon

CLI를 사용하여 로컬 서버를 테스트하세요.

기본값: undefined

capacitor.config.json

{
  "plugins": {
    "CapacitorUpdater": {
      "localSupaAnon": "YOUR_LOCAL_ANON_KEY"
    }
  }
}

localWebHost

CLI을 사용하여 테스트 또는 자체 호스팅 업데이트 서버를 구성합니다.

기본값: undefined

capacitor.config.json

{
  "plugins": {
    "CapacitorUpdater": {
      "localWebHost": "http://localhost:5173"
    }
  }
}

팁

자세한 설정은 __CAPGO_KEEP_0__ 웹 앱에서 찾을 수 있습니다. Capgo web app __CAPGO_KEEP_0__ web app

Settings에서 계속 진행하세요

__CAPGO_KEEP_0__을 사용 중이라면 설정 API과 capgo을 Cloudflare의 @capgo/capacitor-updater와 연결하세요 for the native capability in Using @capgo/capacitor-updater, API 개요 API 개요에서 구현 세부 정보를 확인하세요 소개 소개에서 구현 세부 정보를 확인하세요 API 키 API 키의 구현 세부 사항에 대해 장치 __CAPGO_KEEP_0__ 키의 구현 세부 사항에 대해.