설정

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

팁

capacitor.config 파일에서 이 설정을 변경하는 경우, 프로덕션 앱이 변경 사항을 받으려면 플랫폼을 싱크하고 스토어에 릴리즈해야 합니다.

allowModifyUrl

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

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

앱이 준비되기까지의 시간 초과 시간을 설정하세요.

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

__CAPGO_KEEP_0__.config.json을 삭제할지 여부를 자동으로 결정합니다. 업데이트 후 이전 버전을 삭제할지 여부를 자동으로 결정합니다.

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

기본값: true

capacitor.config.json

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

autoSplashscreen

스플래시 스크린을 자동으로 숨기기 위해 instant apply 모드 사용 시 자동으로 처리합니다. 활성화 시, 업데이트 적용 후 또는 업데이트가 필요하지 않은 경우 스플래시 스크린을 자동으로 숨깁니다. 이러한 기능은 appReady 이벤트를 수동으로 듣고 SplashScreen.hide()를 호출하지 않아도 됩니다. autoUpdate is set to "atInstall", "onLaunch", 또는 "always". 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

플러그인은 업데이트 서버를 통해 자동 업데이트를 사용하는 방법을 구성합니다. 이전 버전의 호환성을 위해 boolean 값도 지원됩니다: true 동일합니다. "atBackground" 또는 false 동일합니다. "off".

선택 항목:

• "off" 또는 false: 자동 업데이트를 비활성화합니다.
• "atBackground" or true: 배경으로 이동할 때 자동으로 확인하고 다운로드 후 적용
• "atInstall": 새 설치나 네이티브 앱 업데이트 후에만 즉시 적용, 그렇지 않으면 "atBackground"
• "onLaunch": 앱이 시작될 때 즉시 적용, 그렇지 않으면 "atBackground" 배포 후 확인
• "always": Auto Update가 실행될 때마다 즉시 적용
• "onlyDownload": 배경으로 이동할 때 자동으로 확인하고 다운로드 후 emit, updateAvailable, 그리고 다음 번들 자동 설정을 절대하지 않습니다.

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

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

옵션:

• false: 직접 업데이트 수행하지 않음
• 'atInstall': autoUpdate: "atInstall"
• 'onLaunch': autoUpdate: "onLaunch"
• 'always': autoUpdate: "always"
• true: (deprecated) 항상와 동일한 backward compatibility를 위해

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

기본값: false

capacitor.config.json

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

disableJSLogging

플러그인에서 자바스크립트 로깅을 비활성화합니다. true로 설정하면 플러그인은 자바스크립트 콘솔에 로그를 기록하지 않습니다. 오직 네이티브 로그만 수행됩니다.

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

기본값: false

capacitor.config.json

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

keepUrlPathAfterReload

재로드 후 URL 경로를 유지하도록 플러그인을 구성합니다.

주의

reload이 트리거될 때, ‘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

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

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

기본값: undefined

capacitor.config.json

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

resetWhenUpdate

새로운 네이티브 앱 번들 설치 시 기존 다운로드된 번들을 자동으로 삭제합니다.

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

기본값: true

capacitor.config.json

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

responseTimeout

API이 설정된 시간까지 네이티브 플러그인에서 기다리는 밀리초 수를 설정합니다.

안드로이드, 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에서 사용 가능합니다. ‘’로 설정하면 통계 보고를 비활성화합니다.

기본값: 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를 로컬 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 web app 이전