설정

업데이트 시스템을 더 세밀하게 제어하려면 다음 설정을 구성할 수 있습니다:

팁

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. 참조 데이터 위치.

자체 호스트네임을 사용하려면 updateUrl, statsUrl, 그리고 channelUrl, 참고: 커스텀 도메인 설정.

allowModifyUrl

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

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

기본값: false

capacitor.config.json

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

appId

config에서 앱의 appId를 설정합니다.

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

기본값: undefined

capacitor.config.json

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

appReadyTimeout

업데이트를 '실패'로 간주하기 전까지 네이티브 플러그인이 대기할 밀리초(ms)를 설정합니다.

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

즉시 적용 모드 사용 시 필수 ("atInstall", "onLaunch", 또는 "always"), 지원 중단된 directUpdate 값도 포함됩니다. 설치하세요 @capacitor/splash-screen 그리고 설정하세요. launchAutoHide: false. 활성화하면 업데이트가 적용되거나 업데이트가 필요 없는 경우 플러그인이 자동으로 스플래시 화면을 숨깁니다. 이를 통해 appReady 이벤트를 직접 리스닝하고 SplashScreen.hide()를 호출할 필요가 없습니다.

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

기본값: 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")는 사용자가 기다리는 동안 적용됩니다. 업로드할 때 npx @capgo/cli@latest bundle upload --delta 를 사용하면 변경된 파일만 다운로드됩니다. 전체 zip 업로드는 사용자 경험을 느리게 만듭니다. Android와 iOS에서 이 모드들은 autoSplashscreen: true 및 @capacitor/splash-screen 포함 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

설정 파일에서 앱의 기본 채널을 지정합니다. 대소문자를 구분합니다. 이 설정은 클라우드에서 설정된 기본 채널을 덮어쓰지만, 클라우드에서 수행된 덮어쓰기는 여전히 적용됩니다.

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

기본값: undefined

capacitor.config.json

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

directUpdate

비추천. 대신 autoUpdate string 모드를 사용하세요: "atInstall", "onLaunch", 또는 "always". 이 옵션은 기존 앱을 위해 계속 지원됩니다. Instant apply는 다음과 함께 업로드해야 합니다. --delta 업데이트가 사용자 경험을 저해하지 않도록 합니다. 이 모드들은 autoSplashscreen: true 및 @capacitor/splash-screen 포함 launchAutoHide: false.

옵션:

• false: 직접 업데이트를 절대 수행하지 않음
• 'atInstall': 와 동일 autoUpdate: "atInstall"
• 'onLaunch': 와 동일 autoUpdate: "onLaunch"
• 'always': 와 동일 autoUpdate: "always"
• true: (비추천) 와 동일 "always" 하위 호환성을 위해

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

기본값: false

capacitor.config.json

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

disableJSLogging

플러그인의 JavaScript 로깅을 비활성화합니다. true인 경우 플러그인은 JavaScript 콘솔에 로그를 기록하지 않습니다. 네이티브 로그만 기록됩니다.

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

끝에서 끝 live update 암호화 버전 2를 위한 공개 키를 구성합니다.

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

기본값: undefined

capacitor.config.json

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

주의

publicKey Encryption V2를 구성하며, upload 시 사용한 private key와 일치해야 합니다. Delta update의 경우 partial encryption이 활성화된 V2 encryption을 사용하고, 조직에서 모든 upload를 암호화해야 한다면 encrypted-bundle enforcement를 활성화하세요. 다음에만 의존하지 마세요: publicKey 암호화되지 않은 Delta가 게시되는 것을 막는 서버 측 정책으로서...

resetWhenUpdate

기기에 새 native app bundle이 설치되면 이전에 다운로드한 bundle을 자동으로 삭제합니다.

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

기본값: true

capacitor.config.json

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

responseTimeout

네이티브 플러그인이 API 타임아웃으로 판단하기 전까지 대기할 밀리초(ms)를 설정합니다.

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

기본값: 20 (20초)

capacitor.config.json

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

shakeMenu

디버깅 및 테스트를 위해 흔들기 제스처로 업데이트 메뉴를 표시하도록 설정합니다.

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

기본값: false

capacitor.config.json

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

statsUrl

업데이트 통계가 전송될 URL/엔드포인트를 설정합니다.

Android, iOS, Electron에서 사용 가능합니다. ""(빈 문자열)으로 설정하면 명시적인 통계 보고를 비활성화합니다. /stats.

비활성화하면 statsUrl 모든 Capgo 디바이스 저장을 비활성화하지 않습니다. updateUrl 이 기능이 활성화된 상태로 유지되면, /updates 업데이트 제공 및 MAU 계수에 필요한 결제 MAU 행, 디바이스 인벤토리, 업데이트 결정 이벤트 데이터를 계속 저장합니다. 컴플라이언스 필드별 세부 내용을 확인하세요.

기본값: 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"
    }
  }
}

팁

추가 설정은 Capgo 웹 앱 에서 네이티브 앱 출시 없이 채널별로 구성할 수 있습니다.

설정에서 계속하기

사용 중이라면 설정 대시보드 및 API 운영을 계획하려면, 이를 다음과 연결하세요 @capgo/capacitor-updater 사용하기 네이티브 기능의 경우 @capgo/capacitor-updater 사용하기에서, API 개요 구현 세부 사항은 API 개요에서 소개 구현 세부 사항은 소개에서 API 키 API Keys의 구현 세부 사항은, 기기 Devices의 구현 세부 사항은.