설정

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

Tip

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

Note

EU 데이터 주권을 필요로하신다면, 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. See 데이터 위치.

allowModifyUrl

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

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

native 플러그인에서 업데이트가 실패로 간주되기 전에 대기하는 밀리초 수를 설정합니다.

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

인스턴트 적용 모드에서 사용할 때 스플래시 화면을 자동으로 숨기도록 처리합니다. 활성화 시, 플러그인은 업데이트가 적용되거나 업데이트가 필요하지 않을 때 스플래시 화면을 자동으로 숨깁니다. 이러한 기능은 appReady 이벤트를 수동으로 듣고 SplashScreen.hide()를 호출할 필요가 없도록 합니다. 만약 autoUpdate 가 설정되어야만 작동합니다. "atInstall", "onLaunch"]} Note: The translation is based on the provided source text and may not be perfect. It's always a good idea to have a native speaker review the translation for accuracy and cultural relevance. Also, the translation of the last sentence is a bit tricky, as the original sentence has a conditional clause ( "always". 유산값은 뒤로 호환성을 위해 여전히 지원됩니다. @__CAPGO_KEEP_0__/splash-screen 플러그인을 설치하고 launchAutoHide: false로 구성해야 합니다. 자동 업데이트 기능이 활성화되어야 합니다. 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__.config.json false

capacitor.config.json

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

autoUpdate

타이머 간격을 제어합니다. Boolean 값은 뒤로 호환성을 위해 여전히 지원됩니다: periodCheckDelay 동일합니다. true 동일합니다. "atBackground" 동일합니다. false 동일합니다. "off". String values merge the previous Auto Update and Direct Update configuration.

설정 옵션:

• "off" 또는 false: 자동 업데이트 확인을 비활성화합니다.
• "atBackground" 또는 true: 앱이 전면 모드로 전환될 때마다 자동으로 업데이트 확인 및 다운로드를 수행하고, 다음에 앱이 백그라운드 모드로 전환될 때 업데이트 적용
• "atInstall": 새로운 설치 또는 네이티브 앱 스토어 업데이트 후에만 즉시 적용; 그 외에는 "atBackground" 동작
• "onLaunch": 앱이 죽은 상태에서 전면 모드로 전환될 때 즉시 적용합니다. 첫 번째 확인 후에는 "atBackground" 동작
• "always": 전면 모드 전환 시마다 확인하고, 업데이트 가능성이 있을 때마다 즉시 적용
• "onlyDownload": 자동으로 확인 및 다운로드를 수행하고, emit updateAvailable자동 업데이트를 설정하지 않으며 다음 번들 또는 업데이트를 자동으로 적용하지 않습니다.

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

기본값: "atBackground" (true 아직도 받아들여지고 있습니다.

capacitor.config.json

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

channelUrl

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

기본값:

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

capacitor.config.json

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

defaultChannel

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

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

기본값: undefined

capacitor.config.json

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

directUpdate

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

__CAPGO_KEEP_0__

• 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

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

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

기본값: false

capacitor.config.json

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

keepUrlPathAfterReload

URL 경로를 유지하기 위해 플러그인을 설정합니다.

주의

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

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

기본값: false

capacitor.config.json

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

periodCheckDelay

10분 이상의 지연 시간을 설정하여 주기적인 업데이트 확인을 합니다.

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

기본값: 600 10분

capacitor.config.json

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

publicKey

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

기본값:

__CAPGO_KEEP_0__.config.json undefined

capacitor.config.json

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

주의

publicKey __CAPGO_KEEP_0__은 Delta 업데이트를 위해 V2 암호화와 부분 암호화가 활성화된 상태로 사용해야 하며, 업로드할 때마다 암호화된 배포를 강제할 수 있습니다. 단, __CAPGO_KEEP_0__을 서버 측 정책으로만 의존해서는 안 됩니다. publicKey 설정 제목: "resetWhenUpdate"

resetWhenUpdate

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

기본값:

__CAPGO_KEEP_0__.config.json 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에서 사용할 수 있습니다.

기본값:

__CAPGO_KEEP_0__.config.json false

capacitor

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

statsUrl

statistic 업데이트 URL/엔드포인트를 설정하세요.

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

비활성화 statsUrl 이 기능을 비활성화하면 Capgo 기기 저장소의 모든 데이터가 비활성화되지 않습니다. 만약 Capgo가 활성화되어 있다면, updateUrl 활성화되어 있다면, /updates 계정 MAU 행, 기기 인벤토리, 업데이트 결정 이벤트 데이터를 포함하여 업데이트를 제공하고 MAU를 계산하기 위해 필요한 데이터를 저장합니다. Compliance 자세한 field-level breakdown은

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

capacitor.config.json

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

updateUrl

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

Configure the current version of the app. This will be used for the first update request. If not set, the plugin will get the version from the native code.

__CAPGO_KEEP_0__.config.json

__CAPGO_KEEP_0__. 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 웹 앱 __CAPGO_KEEP_0__ 채널별로 설정할 수 있으며 Native 앱 릴리즈가 필요하지 않습니다.

설정에서 계속

__CAPGO_KEEP_0__을 사용하는 경우 설정 API을 사용하여 대시보드와 API 운영을 계획하고 싶다면 API과 연결하세요. @capgo/capacitor-업데이터 @capgo/capacitor-업데이터를 사용하는 Native 기능 API 개요 API 구현 세부 사항 소개 __CAPGO_KEEP_0__ Keys API Keys 구현 세부 사항에 대해 API Keys 및 구현 세부 사항에 대해 기기 기기 구현 세부 사항에 대해