설정

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

팁

이 설정의 변경은 capacitor.config 파일에서만 적용되며, 프로덕션 앱은 스토어에 릴리즈 후에만 이러한 변경 사항을 받을 수 있습니다.

주의

EU 데이터 거주지 요구가 있는 Capgo Cloud를 사용하시려면 updateUrl 설정 https://plugin.eu.capgo.app/updates, statsUrl Android, iOS, 및 Electron에서 사용 가능합니다. https://plugin.eu.capgo.app/stats, 및 channelUrl Android, iOS, 및 Electron에서 사용 가능합니다. https://plugin.eu.capgo.app/channel_self. Data Location.

allowModifyUrl

JavaScript에서 updateUrl, statsUrl 및 channelUrl을 동적으로 수정할 수 있도록 플러그인을 허용합니다.

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

기본값: false

capacitor.config.json

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

appId

__CAPGO_KEEP_0__.config.json

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

__CAPGO_KEEP_0__.config.json을 통해 자동으로 실패한 번들을 삭제할지 설정합니다.

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

기본값: true

capacitor.config.json

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

autoDeletePrevious

__CAPGO_KEEP_0__.config.json을 통해 이전 번들을 성공적인 업데이트 후 자동으로 삭제할지 설정합니다.

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

기본값: true

capacitor.config.json

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

autoSplashscreen

인스턴트 적용 모드 사용 시 스플래시 화면 숨기기를 자동으로 처리합니다. 활성화 시, 플러그인은 업데이트가 적용되거나 업데이트가 필요하지 않을 때 스플래시 화면을 자동으로 숨깁니다. 이러한 업데이트가 필요하지 않을 때 스플래시 화면을 숨기기 위해 앱이 준비되면 이벤트를 수신하고 스플래시 화면을 숨기기 위해 SplashScreen.hide()를 호출할 필요가 없습니다. 다만, autoUpdate is set to "atInstall", "onLaunch", or "always". LEGACY directUpdate 값은 백워드 호환성을 위해 여전히 지원됩니다. @capacitor/splash-screen 플러그인이 설치 및 launchAutoHide: false로 구성되어 있어야 하며, Auto Update가 활성화되어 있어야 합니다. Android, iOS, Electron에서 사용할 수 있습니다.

Default:

__CAPGO_KEEP_0__.config.json false

capacitor.config.json

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

autoUpdate

Copy to clipboard periodCheckDelay 타이머 간격 제어. true Boolean 값은 이전 호환성을 위해 여전히 지원됩니다. "atBackground" 동일합니다. false 또는 "off"동일합니다.

String 값은 이전의 Auto Update 및 Direct Update 구성이 합쳐집니다.

• "off" 선택 항목: false또는
• "atBackground" 자동 업데이트 확인을 비활성화합니다. true또는
• "atInstall"앱이 전면 모드로 이동할 때마다 자동으로 다운로드하고 다음 배경화면에서 업데이트 적용 "atBackground" 새로운 설치 또는 네이티브 앱 스토어 업데이트 후에 즉시 적용; 그렇지 않으면
• "onLaunch": __CAPGO_KEEP_0__. 앱이 죽은 상태에서 전면으로 가져와졌을 때 즉시 적용합니다. 첫 번째 확인 후, 업데이트 가 있는 경우에는 자동으로 적용합니다. "atBackground" behavior
• "always": 전면 전환 시마다 확인하고 업데이트 가 있는 경우 즉시 적용합니다.
• "onlyDownload": 자동으로 확인하고 다운로드 하며, 업데이트 가 있는 경우 __CAPGO_KEEP_0__.config.json을 emit하고, 다음 번들 또는 자동으로 업데이트 를 설정하지 않습니다. updateAvailableAndroid, iOS, 및 Electron 에서 사용할 수 있습니다.

기본값:

__CAPGO_KEEP_0__.config.json이 여전히 지원됩니다. "atBackground" (true __CAPGO_KEEP_0__.config.json을 클립보드에 복사합니다.

capacitor.config.json의 'channelUrl' 섹션

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

channelUrl

__CAPGO_KEEP_0__.config.json

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

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

capacitor.config.json

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

defaultChannel

앱의 기본 채널을 config에서 설정합니다. 대/소문자 구분.

이 설정은 클라우드에서 기본 채널을 설정한 것을 덮어씁니다. 하지만 클라우드에서 설정한 기본 채널을 덮어씌우지 않습니다.

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

capacitor.config.json

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

directUpdate

직접 업데이트 제목 (deprecated) autoUpdate __CAPGO_KEEP_0__ 모드 대신: "atInstall", "onLaunch", 또는 "always". 이 옵션은 기존 앱에 대해 지원되며 유지됩니다.

옵션:

• false: 직접 업데이트 하지 않습니다
• 'atInstall': __CAPGO_KEEP_1__과 동일합니다 autoUpdate: "atInstall"
• 'onLaunch': __CAPGO_KEEP_1__과 동일합니다 autoUpdate: "onLaunch"
• 'always': __CAPGO_KEEP_1__과 동일합니다 autoUpdate: "always"
• true: (deprecated) __CAPGO_KEEP_1__과 동일합니다 "always" 기존 호환성을 위해 유지됩니다.

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

기본값: false

capacitor.config.json

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

disableJSLogging

플러그인을 사용하는 JavaScript 로깅을 비활성화합니다. true로 설정하면 플러그인은 JavaScript 콘솔에 로그를 출력하지 않습니다. native 로그만 수행됩니다.

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

기본값: false

capacitor.config.json

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

keepUrlPathAfterReload

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

주의

When a reload is triggered, ‘window.history’ will be cleared.

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

기본값: false

capacitor.config.json

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

periodCheckDelay

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

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

기본값: 600 (10분)

capacitor.config.json

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

publicKey

__CAPGO_KEEP_0__.config.json을 위한 끝에서 끝까지 실시간 업데이트 암호화 버전 2를 구성하십시오.

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

기본값: undefined

capacitor.config.json

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

주의

publicKey V2 암호화를 구성하고 업로드 중에 사용한 개인 키와 일치하십시오. Delta 업데이트의 경우, V2 암호화를 사용하고 부분 암호화가 가능하도록 하십시오. 또한 업로드가 암호화된 것으로만 허용하는 암호화된 번들 강제 정책을 활성화하십시오. 단, 서버 측 정책만으로는 암호화되지 않은 Delta가 게시되는 것을 방지할 수 없습니다. publicKey resetWhenUpdate 섹션 제목

resetWhenUpdate

__CAPGO_KEEP_0__.config.json

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

기본값: true

capacitor.config.json

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

responseTimeout

API이 native 플러그인을 20초 동안 기다리기 전에 설정하는 밀리초 수를 구성합니다.

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

기본값: 20 (20초)

capacitor.config.json

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

shakeMenu

__CAPGO_KEEP_0__.config.json

__CAPGO_KEEP_0__.config.json

기본값: false

capacitor.config.json

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

statsUrl

업데이트 통계를 전송하는 URL/엔드포인트를 구성합니다.

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

비활성화 statsUrl Capgo 기기 저장소의 모든 항목을 비활성화하지 않습니다. 만약 updateUrl 활성화되어 있다면 /updates 업데이트 및 MAU 카운팅을 위해 필요한 결제 MAU 행, 기기 인벤토리, 업데이트 결정 이벤트 데이터를 여전히 저장합니다. 자세한 내용은 위반 field-level breakdown을 위한.

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

capacitor.config.json

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

updateUrl

업데이트 체크를 위한 URL/엔드포인트를 설정합니다.

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

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

capacitor.config.json

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

version

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

안드로이드, 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"
    }
  }
}

Tip

__CAPGO_KEEP_0__에서 추가 설정이 있습니다. Capgo 웹 앱 __CAPGO_KEEP_0__ 채널당 설정을 변경할 수 있습니다. native 앱 릴리즈가 필요하지 않습니다.

설정에서 계속하기

__CAPGO_KEEP_0__을 사용하는 경우 __CAPGO_KEEP_0__ API과 __CAPGO_KEEP_1__-updater를 연결합니다. Using @capgo/capacitor-updater capgo native 기능을 위한 @capacitor/__CAPGO_KEEP_2__-업데이터를 사용하세요. API 개요 API 개요의 구현 세부 정보를 위한 __CAPGO_KEEP_0__ 소개 __CAPGO_KEEP_0__의 구현 세부 정보를 위한 소개 API 키 API 키의 구현 세부 정보를 위한, 및 __CAPGO_KEEP_0__ 장치 __CAPGO_KEEP_0__ 장치의 구현 세부 정보를 위한.