설정

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

팁

이 설정의 변경은 capacitor.config 파일에서만 적용되며, 플랫폼을 싱크하고 스토어에 릴리즈해야 합니다.

주의

EU 데이터 거주지 요구가 있는 Capgo Cloud를 사용하시려면 updateUrl to https://plugin.eu.capgo.app/updates, statsUrl to https://plugin.eu.capgo.app/statsLive Update channelUrl to https://plugin.eu.capgo.app/channel_selfLive Update 데이터 위치.

Live Update updateUrl, statsUrlLive Update channelUrlLive Update Live Update.

allowModifyUrl

Live Update

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

기본값: false

capacitor.config.json

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

appId

앱 아이디를 설정하여 앱의 구성 요소를 구성합니다.

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

실패한 패키지를 자동으로 삭제할지 여부를 설정합니다.

Android, iOS, Electron에서 지원됩니다.

기본값: true

capacitor.config.json

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

autoDeletePrevious

업데이트가 성공적으로 완료된 후 플러그인이 이전 버전의 패키지를 자동으로 삭제할지 여부를 구성합니다.

안드로이드, iOS, 및 Electron에서 사용할 수 있습니다.

기본값: true

capacitor.config.json

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

autoSplashscreen

인스턴트 적용 모드 중 하나를 사용할 때 필수입니다. (, 또는 )."atInstall", "onLaunch", 또는 "always", directUpdate 설치하고 설정 @capacitor/splash-screen 설정 launchAutoHide: false. When enabled, the plugin hides the splashscreen after updates are applied or when no update is needed. This removes the need to manually listen for appReady events and call SplashScreen.hide().

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

기본값: false

capacitor.config.json

{
  "plugins": {
    "CapacitorUpdater": {
      "autoUpdate": "atInstall",
      "autoSplashscreen": true
    },
    "SplashScreen": {
      "launchAutoHide": false
    }
  }
}

autoUpdate

앱이 전면에 표시될 때 또는 앱이 열려 있는 동안 반복적으로 실행되는 타이머를 통해 업데이트 확인, 다운로드 및 적용을 구성합니다. periodCheckDelay 타이머 간격을 조절합니다. 백워드 호환성을 위해 여전히 boolean 값이 지원됩니다: true boolean 값은 다음과 같습니다. "atBackground" 또는 false boolean 값은 다음과 같습니다. "off"문자열 값은 이전의 자동 업데이트 및 직접 업데이트 구성이 합쳐집니다.

선택 항목:

• "off" 또는 false: 자동 업데이트 확인을 비활성화합니다
• "atBackground" 또는 true: 앱이 전면 모드로 전환될 때마다 자동으로 확인하고 다운로드하고, 다음으로 앱이 배경으로 전환될 때 업데이트를 적용합니다
• "atInstall": 새로운 설치나 네이티브 앱 스토어 업데이트 직후에만 즉시 적용합니다. 그 외의 경우 "atBackground" 행동
• "onLaunch": 앱이 죽은 상태에서 전면 모드로 전환될 때 즉시 적용합니다. 첫 번째 확인 후에는 "atBackground" 행동
• "always": 전면 전환마다 확인하고 업데이트가 있을 때 즉시 적용합니다
• "onlyDownload": 자동으로 확인하고 다운로드하고, updateAvailableemit

, 그리고 다음 번들 또는 업데이트를 자동으로 설정하거나 적용하지 않습니다. "atInstall", "onLaunch", "always"기다리는 동안 적용합니다. 업로드는 npx @capgo/cli@latest bundle upload --delta 변경된 파일만 다운로드합니다. 전체 zip 업로드는 사용자 경험을 느리게 합니다. 안드로이드와 iOS에서 이러한 모드는 autoSplashscreen: true 및 @capacitor/splash-screen 와 launchAutoHide: false.

안드로이드, iOS, 및 Electron에서 사용할 수 있습니다.

기본값: "atBackground" (true 아직도 허용됩니다.

capacitor.config.json

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

channelUrl

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

안드로이드, 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 string modes를 사용하세요: "atInstall", "onLaunch"또는 "always". 이 옵션은 기존 앱에 대해 지원되므로 유지됩니다. 인스턴트 적용은 사용자 경험을 느리게 하지 않도록 업데이트와 함께 업로드해야 합니다. --delta 이러한 모드는 사용자 경험을 느리게 하지 않도록 업데이트를 수행합니다. autoSplashscreen: true 또는 @capacitor/splash-screen 과 launchAutoHide: false.

Options:

• false: 직접 업데이트를 수행하지 않습니다.
• 'atInstall': 위와 동일합니다. autoUpdate: "atInstall"
• 'onLaunch': 위와 동일합니다. autoUpdate: "onLaunch"
• 'always': 위와 동일합니다. autoUpdate: "always"
• true: (deprecated) 위와 동일합니다. "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'가 삭제됩니다.

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

기본값: false

capacitor.설정.json

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

periodCheckDelay

정기 업데이트 확인 간격을 설정합니다. 단위는 초입니다. 600초 (10분) 이상으로 설정해야 합니다.

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

기본값: 600 10분

capacitor.config.json

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

publicKey

끝에서 끝으로 live update 암호화에 사용되는 공개 키를 구성하는 방법 Version 2.

안드로이드, iOS, 및 Electron에서 사용할 수 있습니다.

기본값: undefined

capacitor.config.json

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

주의

publicKey 엔드 투 엔드 __CAPGO_KEEP_0__ 암호화를 구성하고 업로드 시 사용한 개인 키와 일치해야 합니다. 델타 업데이트를 위해 V2 암호화를 사용하고 부분 암호화를 활성화하고, 업로드가 암호화된 묶음으로만 허용되는 조직이 암호화된 업로드를 요구하는 경우 암호화된 묶음 강제를 활성화하세요. publicKey 서버 측 정책으로만 사용하여 암호화되지 않은 델타가 게시되지 않도록 방지하는 것은 위험합니다.

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

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

안드로이드, iOS, 및 Electron에서 사용할 수 있습니다.

기본값: false

capacitor.config.json

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

statsUrl

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

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

비활성화 statsUrl 모든 Capgo 장치 저장소가 비활성화되지 않습니다. 만약 updateUrl 유지되도록 하며, /updates 업데이트와 MAU를 계산하기 위해 필요한 billing MAU 행, 장치 인벤토리, 업데이트 결정 이벤트 데이터를 여전히 저장합니다. See Compliance

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

capacitor.config.json

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

updateUrl

복사

업데이트 URL/엔드포인트를 구성합니다. (업데이트 확인을 위해 전송됩니다.)

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

capacitor.config.json

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

version

앱의 현재 버전을 설정합니다. 첫 번째 업데이트 論제에서 사용됩니다. 설정하지 않으면 플러그인은 native 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"
    }
  }
}

팁

__CAPGO_KEEP_0__ 웹 앱에서 추가 설정이 있습니다. Capgo 웹 앱 설정에서 계속

설정에서 계속하기

설정에서 계속하기 설정에서 계속하기 계획 대시보드와 API 작업을 계획하고 연결하세요. Using @capgo/capacitor-업데이터 자연스러운 네이티브 기능을 위해 Using @capgo/capacitor-업데이터 API 개요 API 개요의 구현 세부 정보를 위해 소개 소개의 구현 세부 정보를 위해 API 키 API 키의 구현 세부 정보를 위해, 그리고 장치 장치의 구현 세부 정보를 위해