설정

팁

__CAPGO_KEEP_0__ 설정 파일의 이러한 설정에 대한 변경은, 생산 앱이 이러한 변경 사항을 받기 위해 플랫폼과 스토어에 릴리즈하는 것을 포함하여 스토어에 릴리즈하는 앱의 경우 __CAPGO_KEEP_0__.config 파일의 이러한 설정에 대한 변경을 동기화해야 합니다.

Any changes to these settings in capacitor.config file, require syncing the platform and releasing to the store for production apps to receive them.

Note

Capgo의 유럽 연합 데이터 거주지 요구 사항이 있으신가요? updateUrl __CAPGO_KEEP_0__ Cloud? https://plugin.eu.capgo.app/updates, statsUrl to https://plugin.eu.capgo.app/statsto channelUrl , https://plugin.eu.capgo.app/channel_selfto ..

allowModifyUrl

__CAPGO_KEEP_0__.config.json을 수정할 수 있도록 JavaScript에서 동적으로 updateUrl, statsUrl 및 channelUrl을 수정할 수 있도록 허용합니다.

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

__CAPGO_KEEP_0__.config.json

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

자동 업데이트가 성공적으로 완료된 후 이전 버전을 자동으로 삭제할지 여부를 구성합니다.

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

기본값: true

capacitor.config.json

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

autoSplashscreen

즉시 적용 모드 사용 시 스플래시 스크린 숨기기를 자동으로 처리합니다. 활성화 시 업데이트가 적용되거나 업데이트가 필요하지 않은 경우 스플래시 스크린을 자동으로 숨깁니다. 이 기능을 사용하면 appReady 이벤트를 수동으로 듣거나 SplashScreen.hide()를 호출할 필요가 없습니다. 이 기능은 autoUpdate 로 설정된 경우에만 작동합니다. "atInstall", "onLaunch"또는 "always". LEGACY directUpdate 값은 백워드 호환성을 위해 여전히 지원됩니다. @capacitor/splash-screen 플러그인을 설치하고 launchAutoHide: false로 구성해야 하며, Auto Update를 활성화해야 합니다.

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

기본값: false

capacitor.config.json

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

autoUpdate

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

옵션:

• "off" 또는 false: 자동 업데이트 확인을 비활성화합니다
• "atBackground" 또는 true: 앱이 전면 모드로 전환할 때마다 자동으로 다운로드를 확인하고 다음에 앱이 배경으로 이동할 때 업데이트를 적용합니다
• "atInstall": 새로운 설치 또는 네이티브 앱 스토어 업데이트 직후에만 즉시 적용합니다. 그 외의 경우 "atBackground" behavior
• "onLaunch": 앱이 죽은 상태에서 전면으로 가져올 때 즉시 적용합니다. 그 후 첫 번째 확인 후에는 "atBackground" behavior
• "always": 전면 전환마다 확인하고 업데이트가 sẵn sàng할 때마다 즉시 적용합니다
• "onlyDownload": 자동으로 다운로드를 확인하고, updateAvailable,을.emit하고, 다음 번들 또는 업데이트를 자동으로 설정하거나 적용하지 않습니다

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

__CAPGO_KEEP_0__.config.json

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

기본값: undefined

capacitor.config.json

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

directUpdate

사용되지 않음. string modes를 사용하세요: autoUpdate , 또는. 이 옵션은 기존 앱에 대해 지원되며 유지됩니다. "atInstall", "onLaunch"옵션: "always": 직접 업데이트 하지 않습니다

: directUpdate와 동일합니다.

• false__CAPGO_KEEP_0__.
• 'atInstall'__CAPGO_KEEP_0__. 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과 동일합니다. "always" 이전 버전의 호환성을 위해 사용됩니다.

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

기본값: false

capacitor.config.json

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

disableJSLogging

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

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

기본값: false

capacitor.config.json

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

keepUrlPathAfterReload

__CAPGO_KEEP_0__.config.json

주의

reload이 발생할 때 'window.history'가 삭제됩니다.

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

기본값: false

capacitor.config.json

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

periodCheckDelay

__CAPGO_KEEP_0__.config.json

__CAPGO_KEEP_0__.config.json

__CAPGO_KEEP_0__.config.json 600 __CAPGO_KEEP_0__.config.json

capacitor.config.json

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

publicKey

__CAPGO_KEEP_0__.config.json

__CAPGO_KEEP_0__.config.json

__CAPGO_KEEP_0__.config.json undefined

capacitor.config.json

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

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 row, 기기 인벤토리, 업데이트 결정 이벤트 데이터를 저장합니다. Compliance에서 field-level breakdown을 참조하세요. 기본값: __CAPGO_KEEP_0__.config.json

클립보드에 복사 https://plugin.capgo.app/stats

capacitor.config.json

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

updateUrl

__CAPGO_KEEP_0__.config.json

업데이트 확인을 위한 URL/엔드포인트

Android, 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

Configure the CLI to use a local api for testing.

__CAPGO_KEEP_1__ 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 웹 앱 채널별로 설정을 구성할 수 있습니다. native 앱 릴리즈 없이도.

설정에서 계속

__CAPGO_KEEP_0__를 사용 중이라면 설정 API 대시보드를 계획하고 운영을 위해 연결하세요. Using @capgo/capacitor-updater capgo의 네이티브 기능을 사용하는 Using @capgo/capacitor-updater API 개요 API의 구현 세부 정보를 위한 API 개요 소개 소개의 구현 세부 정보를 위한 API 키 API 키의 구현 세부 정보를 위한 기기 기기의 구현 세부 정보를 위한