설정

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

팁

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

주의

EU 데이터 거주지 요구가 있으시다면 Capgo Cloud를 설정하세요. updateUrl to https://plugin.eu.capgo.app/updates, statsUrl to https://plugin.eu.capgo.app/stats, and 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

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

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 값을 설치하고 launchAutoHide: false설정합니다. 업데이트가 적용되거나 업데이트가 필요하지 않으면 플러그인은 스플래시 화면을 숨깁니다. 이것은 앱이 준비되면 수동으로 앱리디이벤트를 듣고 스플래시 화면을 숨기는 것을 생략합니다.

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

기본값: false

capacitor.config.json

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

autoUpdate

라이브 업데이트 설정을 구성합니다. 앱이 전면에 표시될 때와 앱이 열려 있는 동안 반복적으로 실행되는 타이머를 통해 업데이트 확인을 합니다. periodCheckDelay 타이머 간격을 조정합니다. 이전 버전과 호환성을 위해 Boolean 값도 지원됩니다: true Boolean 값과 동일합니다. "atBackground" 또는 false Boolean 값과 동일합니다. "off"String 값은 이전의 Auto Update 및 Direct Update 설정을 병합합니다.

선택 항목:

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

: 확인하고 자동으로 다운로드하며, "atInstall", "onLaunch", "always"emit npx @capgo/cli@latest bundle upload --delta , 그리고 다음 번들 또는 업데이트를 자동으로 설정하지 않습니다. autoSplashscreen: true 즉시 적용 모드 ( @capacitor/splash-screen with 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

__CAPGO_KEEP_0__.config.json

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

기본값: undefined

capacitor.config.json

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

directUpdate

사용되지 않음. autoUpdate 문자 모드 대신 사용하세요: "atInstall", "onLaunch"또는 "always". 이 옵션은 기존 앱에 대해 지원되며 유지됩니다. 인스턴트 적용은 --delta 로 업로드되어 사용자 경험에 영향을 주지 않도록 업데이트 속도를 높일 수 있습니다. 이 모드는 autoSplashscreen: true and @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

플러그인에서 JavaScript 로깅을 비활성화합니다. true 인 경우 플러그인은 JavaScript 콘솔에 로그를 기록하지 않습니다. native 로그만 수행됩니다.

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

기본값: false

capacitor.config.json

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

keepUrlPathAfterReload

주의

Caution

페이지가 다시 로드될 때, 'window.history'는 비워집니다.

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

끝에서 끝까지 live update 암호화 버전 2를 위한 공개 키를 설정합니다.

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

기본값: undefined

capacitor.config.json

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

주의

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

resetWhenUpdate

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

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

기본값: true

capacitor.config.json

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

responseTimeout

API이 native 플러그인을 20초 동안 기다리기 전에 타임아웃을 고려하는 시간을 설정합니다.

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

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

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

비활성화 statsUrl Capgo 기기 저장소의 모든 항목을 비활성화하지는 않습니다. updateUrl 만약 /updates 활성화된 경우 Compliance 준수

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

capacitor.config.json

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

updateUrl

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

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

CLI을 개발 목적으로 사용하는 local api을 사용하도록 설정합니다.

기본: undefined

capacitor.config.json

{
  "plugins": {
    "CapacitorUpdater": {
      "localApi": "http://localhost:54321/functions/v1"
    }
  }
}

localApiFiles

CLI을 개발 목적으로 사용하는 local file 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 웹 앱 채널 별로 설정을 구성할 수 있습니다.

설정에서 계속

설정 설정 업데이트 플러그인 설정을 통해 대시보드와 API 작업을 계획하고 연결하세요. @capgo/capacitor-업데이터 Capgo를 사용하여 @capgo/capacitor-업데이터 Capgo를 사용하여 @API/__CAPGO_KEEP_1__-업데이터의 네이티브 기능을 사용할 수 있습니다. API 개요에 대한 구현 세부 사항에 대해 소개 __CAPGO_KEEP_0__ 키에 대한 구현 세부 사항에 대해 API 키 for API 구현 세부 사항에 대한 키들에 대해 Devices 장치에 대한 구현 세부 사항에 대해