설정

설치 단계와 이 플러그인의 전체 마크다운 가이드를 포함한 설정 프롬프트를 복사하세요.

업데이트 시스템에 대한 더 세밀한 제어를 원하시면, 다음과 같은 설정으로 구성할 수 있습니다.

`allowModifyUrl`

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

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

기본값: false

{
  "plugins": {
    "CapacitorUpdater": {
      "allowModifyUrl": true
    }
  }
}

`appId`

앱 ID를 앱의 config에서 설정하세요.

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

기본값: undefined

{
  "plugins": {
    "CapacitorUpdater": {
      "appId": "com.example.app"
    }
  }
}

`appReadyTimeout`

네이티브 플러그인이 업데이트를 실패하기까지 기다리는 밀리초 수를 설정하세요.

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

기본값: 10000 (10초)

{
  "plugins": {
    "CapacitorUpdater": {
      "appReadyTimeout": 1000
    }
  }
}

`autoDeleteFailed`

실패한 번들을 자동으로 삭제할지 설정합니다.

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

기본값: true

{
  "plugins": {
    "CapacitorUpdater": {
      "autoDeleteFailed": false
    }
  }
}

`autoDeletePrevious`

업데이트가 성공적으로 완료된 후 이전 버전의 번들을 자동으로 삭제할지 설정합니다.

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

기본값: true

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

`autoSplashscreen`

자동 스플래시 스크린 숨기기를 사용할 때 직접 업데이트 사용 시 자동으로 스플래시 스크린을 숨깁니다. 활성화하면 업데이트 적용이 완료되거나 업데이트가 필요하지 않은 경우 스플래시 스크린을 자동으로 숨깁니다. 이로 인해 앱이 준비되면 스플래시 스크린을 숨기기 위해 수동으로 앱준비 이벤트를 듣고 스플래시 스크린 숨기기를 호출할 필요가 없습니다. 직접 업데이트 설정이 "atInstall", "always", 또는 true로 설정된 경우에만 작동합니다. @capacitor/splash-screen 플러그인을 설치하고 launchAutoHide: false로 구성해야 하며, autoUpdate 및 directUpdate가 활성화되어야 합니다.

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

기본값: false

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

`autoUpdate`

플러그인이 업데이트 서버를 통해 자동 업데이트 기능을 사용할지 설정합니다.

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

기본값: true

{
  "plugins": {
    "CapacitorUpdater": {
      "autoUpdate": false
    }
  }
}

`channelUrl`

채널 연산을 위한 URL/엔드포인트를 설정하세요.

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

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

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

`defaultChannel`

앱의 기본 채널을 config에서 설정하세요. 대/소문자 구분.

cloud에서 설정한 기본 채널을 덮어씁니다. 하지만 cloud에서 설정한 채널을 덮어씌우지 않습니다.

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

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

`directUpdate`

플러그인 업데이트를 직접 설치할 때의 설정입니다. 자동 업데이트 모드만 지원합니다. 10MB 이하의 앱과 —delta 플래그를 사용하여 업로드 한 앱에 적합합니다. 10MB 이상의 ZIP 앱은 사용자에게 업데이트가 느려질 수 있습니다.

옵션:

false: 업데이트를 직접하지 않습니다. (기본 동작: 시작 시 다운로드, 배경화면 시 설정)
'atInstall': 앱이 설치 및 업데이트된 경우에만 직접 업데이트합니다. 스토어에서 앱을 업데이트한 경우에는 기본 동작을 사용합니다.
'onLaunch': 앱이 설치 및 업데이트된 경우 또는 앱이 종료된 경우에만 직접 업데이트합니다. 스토어에서 앱을 업데이트한 경우 또는 앱이 종료된 경우에는 기본 동작을 사용합니다.
'always': 위의 모든 경우에 직접 업데이트합니다. 기본 동작을 사용하지 않습니다.
true: (deprecated) '항상'과 동일한 동작을 위해 이전 버전과 호환성을 유지합니다.

Android, iOS, Electron에서 지원합니다.

기본값: false

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

`disableJSLogging`

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

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

기본: false

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

`keepUrlPathAfterReload`

플러그인을 재로드 후 URL 경로를 유지하기 위해 구성하십시오.

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

기본값: false

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

`periodCheckDelay`

기간 업데이트 확인의 지연 기간을 설정합니다. 단위는 초입니다. 600 초 (10분) 보다 작을 수 없습니다.

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

기본값: 600 10분

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

`publicKey`

끝에서 끝까지 라이브 업데이트 암호화 버전 2에 대한 공개 키를 구성합니다.

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

기본값: undefined

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

`resetWhenUpdate`

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

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

기본값: true

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

`responseTimeout`

네이티브 플러그인이 API 타임아웃을 고려하기 전에 몇 밀리초 동안 기다려야 하는지 설정합니다.

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

기본값: 20 (20 초)

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

`shakeMenu`

테스트/디버깅 목적으로 업데이트 메뉴를 표시하기 위해 흔들기 동작을 활성화합니다.

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

기본값: false

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

`statsUrl`

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

Android, iOS, Electron에서 사용할 수 있습니다. ""으로 설정하여 통계 보고를 비활성화하세요.

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

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

`updateUrl`

업데이트 체크를 전송하는 URL / 엔드포인트를 구성하세요.

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

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

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

`version`

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

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

기본값: undefined

{
  "plugins": {
    "CapacitorUpdater": {
      "version": "1.0.0"
    }
  }
}

개발 설정

`localApi`

개발을 위해 CLI을 사용하는 api를 로컬로 구성합니다.

기본값: undefined

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

`localApiFiles`

테스트를 위해 CLI을 사용하기 위해 로컬 파일 api을 구성하십시오.

기본값: undefined

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

`localHost`

테스트 또는 자체 호스팅 업데이트 서버를 사용하기 위해 CLI을 로컬 서버로 구성하십시오.

기본값: undefined

{
  "plugins": {
    "CapacitorUpdater": {
      "localHost": "http://localhost:5173"
    }
  }
}

`localSupa`

테스트 또는 자체 호스팅 업데이트 서버를 사용하기 위해 CLI을 로컬 서버로 구성하십시오.

기본값: undefined

{
  "plugins": {
    "CapacitorUpdater": {
      "localSupa": "http://localhost:54321"
    }
  }
}

`localSupaAnon`

CLI를 사용하여 로컬 서버를 테스트하기 위해 구성하십시오.

기본값: undefined

{
  "plugins": {
    "CapacitorUpdater": {
      "localSupaAnon": "YOUR_LOCAL_ANON_KEY"
    }
  }
}

`localWebHost`

CLI를 사용하여 로컬 서버 또는 자체 호스팅 업데이트 서버를 테스트하십시오.

기본값: undefined

{
  "plugins": {
    "CapacitorUpdater": {
      "localWebHost": "http://localhost:5173"
    }
  }
}