내용으로 건너뛰기
Capgo - Capacitor 앱에 대한 실시간 업데이트 Capgo

설정

GitHub

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

allowModifyUrl

데이터 위치

Section titled “allowModifyUrl”

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

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

capacitor.config.json
{
  "plugins": {
    "CapacitorUpdater": {
      "allowModifyUrl": true
    }
  }
}

appId

appId

앱 아이디를 설정하세요.

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

기본값: undefined

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

appReadyTimeout

앱 로드 시간

native 플러그인은 업데이트가 실패한 것으로 간주하기 전에 몇 밀리초 기다릴까요?

안드로이드, 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 로 설정되어 있을 때만 작동합니다. "atInstall", "onLaunch", 또는 "always"기존 directUpdate 값은 백워드 호환성을 위해 여전히 지원됩니다. @capacitor/splash-screen 플러그인이 설치되어 launchAutoHide: false로 구성되어야 하며, 자동 업데이트 기능이 활성화되어야 합니다.

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

기본값: 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, 그리고 다음 번들 자동 설정을 nunca하지 않습니다.

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

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

capacitor.config.json
{
  "plugins": {
    "CapacitorUpdater": {
      "autoUpdate": "onlyDownload"
    }
  }
}

channelUrl

channelUrl

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

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

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

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

defaultChannel

기본 채널 설정

앱의 기본 채널을 config에서 설정합니다. 대/소문자 구분. 이 설정은 클라우드에서 기본 채널을 설정한 것을 덮어씁니다. 하지만 클라우드에서 덮어씌운 설정은 여전히 존중됩니다.

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

기본값: undefined

capacitor.config.json
{
  "plugins": {
    "CapacitorUpdater": {
      "defaultChannel": "production"
    }
  }
}

directUpdate

직접 업데이트

deprecated. string modes를 사용하세요: autoUpdate 기본 채널 설정 "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과 '항상'과 동일합니다. (이 옵션은 향후 버전에서 제거될 예정입니다.)

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

기본값: false

capacitor.config.json
{
  "plugins": {
    "CapacitorUpdater": {
      "autoUpdate": "atInstall"
    }
  }
}

disableJSLogging

__CAPGO_KEEP_0__.config.json

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

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

기본값: false

capacitor.config.json
{
  "plugins": {
    "CapacitorUpdater": {
      "disableJSLogging": true
    }
  }
}

keepUrlPathAfterReload

URL 경로를 재로드 후 유지합니다.

주의

__CAPGO_KEEP_0__.config.json

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

‘resetWhenUpdate’라는 제목의 섹션

새로운 네이티브 앱 번들 설치 시 기존 다운로드된 번들을 자동으로 삭제합니다.

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

기본값: true

capacitor.config.json
{
  "plugins": {
    "CapacitorUpdater": {
      "resetWhenUpdate": false
    }
  }
}

responseTimeout

‘responseTimeout’라는 제목의 섹션

네이티브 플러그인이 API 시간 초과를 고려하기 전에 대기하는 밀리초 수를 설정합니다.

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

기본값: 20 (20 초)

capacitor.config.json
{
  "plugins": {
    "CapacitorUpdater": {
      "responseTimeout": 10 // (10 seconds)
    }
  }
}

shakeMenu

'shakeMenu'라는 섹션

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

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

기본값: false

capacitor.config.json
{
  "plugins": {
    "CapacitorUpdater": {
      "shakeMenu": true
    }
  }
}

statsUrl

'statsUrl'라는 섹션

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

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

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

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

updateUrl

업데이트 URL / 엔드포인트를 구성합니다.

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

기본값:

__CAPGO_KEEP_0__.config.json https://plugin.capgo.app/updates

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

version

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

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

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

기본값: undefined

capacitor.config.json
{
  "plugins": {
    "CapacitorUpdater": {
      "version": "1.0.0"
    }
  }
}

개발 설정

개발 설정 섹션

localApi

localApi 섹션

개발을 위해 로컬 api를 사용하도록 CLI를 구성합니다.

기본값: undefined

capacitor.config.json
{
  "plugins": {
    "CapacitorUpdater": {
      "localApi": "http://localhost:54321/functions/v1"
    }
  }
}

localApiFiles

localApiFiles 섹션

CLI을 사용하여 테스트를 위해 로컬 파일 api을 구성하십시오.

기본값: undefined

capacitor.config.json
{
  "plugins": {
    "CapacitorUpdater": {
      "localApiFiles": "http://localhost:54321/functions/v1/files"
    }
  }
}

localHost

localHost 섹션

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

기본값: undefined

capacitor.config.json
{
  "plugins": {
    "CapacitorUpdater": {
      "localHost": "http://localhost:5173"
    }
  }
}

localSupa

localSupa 섹션

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

기본값: undefined

capacitor.config.json
{
  "plugins": {
    "CapacitorUpdater": {
      "localSupa": "http://localhost:54321"
    }
  }
}

localSupaAnon

‘localSupaAnon’ 제목의 섹션

CLI을 사용하여 테스트를 위해 로컬 서버를 사용하도록 구성합니다.

기본값: undefined

capacitor.config.json
{
  "plugins": {
    "CapacitorUpdater": {
      "localSupaAnon": "YOUR_LOCAL_ANON_KEY"
    }
  }
}

localWebHost

‘localWebHost’ 제목의 섹션

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

기본값: undefined

capacitor.config.json
{
  "plugins": {
    "CapacitorUpdater": {
      "localWebHost": "http://localhost:5173"
    }
  }
}

설정에서 계속

설정에서 계속하기

네이티브 앱 릴리즈 없이도 __CAPGO_KEEP_0__ 웹 앱에서 채널별로 설정을 구성할 수 있습니다. 설정 to plan dashboard and API operations, connect it with Using @capgo/capacitor-updater capgo native 기능을 위한 @capacitor/capgo-업데이터 사용 API 개요 API 개요의 구현 세부 정보를 위한 소개 소개의 구현 세부 정보를 위한 API 키 API 키의 구현 세부 정보를 위한, 및 장치 장치의 구현 세부 정보를 위한