설정

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

팁

이 설정의 변경은 capacitor.config 파일에서만 적용되며, 플랫폼을 싱크하고 스토어에 릴리즈해야만 프로덕션 앱이 이를 받을 수 있습니다.

주의

유럽 데이터 거주지 필요로 Capgo Cloud? updateUrl 까지 https://plugin.eu.capgo.app/updates, statsUrl 까지 https://plugin.eu.capgo.app/stats까지 channelUrl . https://plugin.eu.capgo.app/channel_self위치 allowModifyUrl.

allowModifyUrl

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

기본값:

__CAPGO_KEEP_0__.config.json false

capacitor

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

appId

앱 아이디를 설정하여 앱의 구성 파일에서 사용합니다.

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

기본값: undefined

capacitor.config.json

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

appReadyTimeout

네이티브 플러그인이 업데이트를 실패로 간주하기 전에 기다리는 밀리초 수를 설정합니다.

안드로이드, 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 is "atInstall", "onLaunch", 또는 "always". LEGACY directUpdate values are still supported for backward compatibility. Requires the @capacitor/splash-screen plugin to be installed and configured with launchAutoHide: false. Requires Auto Update to be enabled.

이 기능은 @__CAPGO_KEEP_0__/splash-screen 플러그인이 설치되어 launchAutoHide: false로 구성되어 있어야 하며, Auto Update가 활성화되어 있어야 합니다.

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

capacitor.config.json

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

autoUpdate

플러그인 업데이트를 설정하는 방법 periodCheckDelay 플러그인이 앱이 전면에 표시될 때와 앱이 열려 있는 동안 반복적으로 업데이트를 확인하고 다운로드합니다. true 타이머 간격을 조정합니다. "atBackground" Boolean 값은 이전 버전과 호환성을 위해 여전히 지원됩니다. false Boolean 값과 동일합니다. "off"String 값은 이전의 자동 업데이트 및 직접 업데이트 구성과 병합됩니다.

선택 항목:

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

와 함께 emit하고, 다음 번들 또는 업데이트를 자동으로 설정하거나 적용하지 않습니다.

Android, iOS, 및 Electron에서 사용할 수 있습니다. "atBackground" (true 기본값:

capacitor.config.json

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

channelUrl

채널 작업을 위한 URL/엔드포인트를 구성하세요.

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

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

capacitor.config.json

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

defaultChannel

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

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

기본값: undefined

capacitor.config.json

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

directUpdate

사용되지 않음. autoUpdate 문자 모드 대신 사용하세요: "atInstall", "onLaunch", 또는 "always" 이 옵션은 기존 앱에 대해 지원되므로 유지됩니다.

옵션:

• false: 직접 업데이트 하지 않음
• 'atInstall': autoUpdate: "atInstall"
• 'onLaunch': autoUpdate: "onLaunch"
• 'always': autoUpdate: "always"
• true: (사용되지 않음) "always" 기존 호환성을 위해 유지됩니다.

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

기본값: false

capacitor.config.json

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

disableJSLogging

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

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

기본값: false

capacitor.config.json

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

keepUrlPathAfterReload

플러그인을 사용하여 URL 경로를 다시 로드 후 유지할 수 있습니다.

주의

재로드가 트리거되면 'window.history'가 초기화됩니다.

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

기본값: false

capacitor.config.json

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

periodCheckDelay

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

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

기본값: 600 (10분)

capacitor.config.json

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

publicKey

버전 2의 종단 간 실시간 업데이트 암호화에 사용되는 공개 키를 구성합니다.

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

기본값: undefined

capacitor.config.json

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

주의

publicKey V2 암호화를 구성하고 업로드 중에 사용되는 개인 키와 일치해야 합니다. 델타 업데이트를 위해 V2 암호화를 사용하고 부분 암호화를 활성화하고, 조직이 업로드를 암호화해야 하는 경우 암호화된 번들 강제를 활성화하세요. 암호화되지 않은 델타가 공개되는 것을 방지하기 위해 서버 측 정책으로만 의존하지 마십시오. publicKey __CAPGO_KEEP_0__.config.json

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 규정 준수 에 대한 field-level breakdown을 참조하세요.

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

capacitor.config.json

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

updateUrl

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

기본값:

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

capacitor

{
  "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

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

기본값: 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 웹 앱에서 추가 설정이 있습니다. Capgo web app 설정에서 계속

설정에서 계속하기

Capgo를 사용 중이라면 설정 업데이트 설정을 위해 대시보드와 API 연산을 계획하고 연결하세요. Using @capgo/capacitor-업데이터 Using @capgo/capacitor-업데이터의 네이티브 기능 API 개요 API 개요의 구현 세부 사항 소개 소개의 구현 세부 사항 API 키 API 키의 구현 세부 사항 장치 장치의 구현 세부 사항