설정

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

팁

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

주의

Capgo Cloud에 있는 EU 데이터 거주 요구 사항이 있으십니까? 설정 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

앱의 아이디를 설정하세요.

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

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

안드로이드, 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 deprecated @capacitor/splash-screen Capgo launchAutoHide: false설치

및 설정

이 옵션을 활성화하면 플러그인이 업데이트가 적용된 후 또는 업데이트가 필요하지 않은 경우 스플래시 스크린을 숨깁니다. false

capacitor.config.json

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

autoUpdate

자동 업데이트 설정을 통해 플러그인에서 라이브 업데이트 확인, 다운로드 및 적용을 구성합니다. 앱이 전면으로 이동할 때 및 앱이 열려 있는 동안 반복 타이머를 사용하여 업데이트 확인을 수행합니다. periodCheckDelay 타이머 간격을 제어합니다. 백워드 호환성을 위해 Boolean 값도 지원됩니다: true 동일합니다 "atBackground" 또는 false 동일합니다 "off"String 값은 이전의 Auto Update 및 Direct Update 구성과 병합됩니다.

선택 항목:

• "off" 자동 업데이트 확인을 비활성화합니다 false또는
• "atBackground" 선택 항목: true: 자동 업데이트 확인 및 다운로드
• "atInstall": 새로운 설치 또는 네이티브 앱 스토어 업데이트 후 즉시 적용; 그 외 "atBackground" : 앱이 죽은 상태에서 전면으로 가져올 때 즉시 적용. 첫 번째 확인 후에는
• "onLaunch": 전면 전환 시마다 확인하고 업데이트가 있을 때 즉시 적용 "atBackground" : 자동으로 확인하고 다운로드하며
• "always", 업데이트를 자동으로 적용하지 않습니다.
• "onlyDownload": 즉시 적용 모드 ( updateAvailable)는 사용자가 기다리는 동안 적용됩니다.

업로드 시 "atInstall", "onLaunch", "always"로만 변경된 파일만 다운로드합니다. 전체 zip 업로드는 사용자 경험을 느리게 합니다. 안드로이드 및 iOS에서 이러한 모드는 npx @capgo/cli@latest bundle upload --delta 와 autoSplashscreen: true 가 필요합니다. @capacitor/splash-screen with launchAutoHide: false.

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

앱의 기본 채널을 설정하는 데 사용되는 config에서 설정합니다. 대/소문자 구분. 이 설정은 클라우드에서 설정한 기본 채널을 덮어씁니다. 하지만 클라우드에서 설정한 채널을 덮어씁니다. 클라우드에서 설정한 채널을 덮어씁니다.

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

기본값: undefined

capacitor.config.json

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

directUpdate

deprecated. 사용 ‘string modes’ autoUpdate , 또는 이 옵션은 기존 앱에 대해 지원됩니다. 사용자 경험을 느끼지 않도록 업데이트가 느려지지 않도록 업로드해야 합니다. 이 모드는 업데이트가 느려지지 않도록 업로드해야 합니다. "atInstall", "onLaunch"Instant apply "always"이 모드는 업데이트가 느려지지 않도록 업로드해야 합니다. --delta 이 모드는 업데이트가 느려지지 않도록 업로드해야 합니다. autoSplashscreen: true 및 @capacitor/splash-screen 과 launchAutoHide: false.

설정:

• 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 로그만 수행됩니다.

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

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

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

기본값: 600 (10분)

capacitor.config.json

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

publicKey

__CAPGO_KEEP_0__.config.json

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

기본값: undefined

capacitor.config.json

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

주의

publicKey V2 암호화 및 업로드 시 사용한 개인 키와 일치해야 합니다. Delta 업데이트를 위해 V2 암호화와 부분 암호화가 활성화된 상태에서 암호화된 번들 강제 적용을 활성화하세요. 조직이 업로드를 암호화해야 하는 경우. publicKey 업로드된 Delta가 암호화되지 않은 경우에만 서버 측 정책으로 사용하지 마십시오.

resetWhenUpdate

새로운 네이티브 앱 번들을 장치에 설치할 때 이전에 다운로드한 번들을 자동으로 삭제합니다.

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

기본값: true

capacitor.config.json

{
  "plugins": {
    "CapacitorUpdater": {
      "resetWhenUpdate": false
    }
  }
}

responseTimeout

API이 native 플러그인을 고려하기 전에 기다리는 밀리초 수를 설정합니다.

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

기본값: 20 (20초)

capacitor.config.json

{
  "plugins": {
    "CapacitorUpdater": {
      "responseTimeout": 10 // (10 seconds)
    }
  }
}

shakeMenu

__CAPGO_KEEP_0__을 Shake하여 업데이트 메뉴를 디버깅/테스트 목적으로 표시합니다.

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

기본값: false

capacitor.config.json

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

statsUrl

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

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

비활성화 statsUrl 모든 Capgo 장치 저장소를 비활성화하지는 않습니다. 만약 updateUrl 활성화된 경우 /updates billing MAU 행, 장치 인벤토리, 업데이트 결정 이벤트 데이터가 필요하여 업데이트를 제공하고 MAU를 계산하기 위해 여전히 저장됩니다. 준수 field-level breakdown을 위한 세부 정보입니다.

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

capacitor.config.json

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

updateUrl

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

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

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

capacitor.config.json

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

version

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

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

Tip

__CAPGO_KEEP_0__ Capgo __CAPGO_KEEP_0__

__CAPGO_KEEP_0__

__CAPGO_KEEP_0__ __CAPGO_KEEP_0__ API Using @capgo/capacitor-updater for the native capability in Using @capgo/capacitor-updater, API 개요 API 개요의 구현 세부 정보를 위해 소개 소개의 구현 세부 정보를 위해 API 키 API 키의 구현 세부 정보를 위해, 그리고 장치 장치의 구현 세부 정보를 위해