Rollbacks

Copy a setup prompt with the install steps and the full markdown guide for this plugin.

While Capgo’s live updates allow you to quickly deliver improvements and fixes to your users, there may be situations where you need to roll back to a previous version of your app. Perhaps a new update introduced an unexpected critical issue, or maybe you want to revert a specific change while you work on a fix.

Capgo는 채널의 빌드 관리 및 사용자가 받는 앱 버전을 제어하는 방법을 제공합니다. 이에는 수동 롤백 옵션 및 자동 안전 메커니즘도 포함됩니다.

자동 롤백 보호

Capgo은 사용자들을 보호하기 위한 내장 안전기능을 포함합니다. JavaScript 오류가 method가 호출되기 전에 발생하면 플러그인은 자동으로 이전에 작동하던 버전으로 롤백합니다. notifyAppReady() 자동 롤백 방법

자동 롤백 방법

When a new update is downloaded and applied, Capgo expects your app to call notifyAppReady() JavaScript 번들 로드 시 비상정지 오류가 발생하지 않음

앱의 핵심 기능이 작동함
업데이트가 안전하게 유지됨
만약

이 메소드가 JavaScript 충돌이나 비상정지 오류로 인해 호출되지 않으면 __CAPGO_KEEP_0__은: notifyAppReady() is not called due to a JavaScript crash or critical error, Capgo will:

자동 롤백 방법
자동으로 이전에 작동하던 번들을 되돌아간다
문제가 있는 업데이트를 실패로 표시하여 다시 적용되지 않도록 한다

import { CapacitorUpdater } from '@capgo/capacitor-updater'

// Call this after your app has successfully initialized
await CapacitorUpdater.notifyAppReady()

시간 초과 설정

You can configure how long Capgo waits for notifyAppReady() Configuring the Timeout appReadyTimeout Capacitor 설정에서:

{
  "plugins": {
    "CapacitorUpdater": {
      "appReadyTimeout": 10000
    }
  }
}

The appReadyTimeout 값은 밀리초 단위로 지정됩니다. 기본 시간 초과는 일반적으로 10초지만, 앱 초기화 요구 사항에 따라 이 값을 조정할 수 있습니다. 앱이 복잡한 초기화 프로세스를 통해 로드하는 경우가 더 길면 이 값을 증가시키는 것이 좋습니다.

이전 버전으로 롤백하기

Capgo는 새로운 빌드를 업로드하고 채널에 assign할 때마다 빌드의 기록을 유지합니다. 특정 업데이트를 되돌리려면 이전 빌드를 선택하여 다시 배포할 수 있습니다.

__CAPGO_KEEP_0__ 롤백 UI

Capgo Dashboard의 4번째 탭(히스토리)에서 채널을 보는 경우, 롤백 인터페이스를 통해 롤백할 수 있습니다. 이 탭은 채널에 대한 모든 빌드의 완전한 목록을 제공하여 이전 버전으로 쉽게 되돌릴 수 있습니다.

__CAPGO_KEEP_0__ Dashboard에서 롤백하기:

__CAPGO_KEEP_0__ 로그인 Capgo.
채널 섹션으로 이동하세요.
롤백할 채널 이름을 클릭하세요.
채널 보기에서 4번째 탭 (History)으로 이동하세요.
롤백할 빌드의 빌드 히스토리에서 찾으세요.
선택한 빌드를 채널의 활성 빌드로 설정하세요.
이 빌드로 롤백하시겠습니까?

대안 방법: Crown 아이콘 사용

첫 번째 방법 이외에도, 채널의 빌드 히스토리에서 빌드를 선택한 채널의 활성 빌드로 설정할 수 있습니다.

첫 번째 탭에서 빌드의 빌드 히스토리에서 빌드를 찾으세요.
첫 번째 탭에서 빌드의 빌드 히스토리에서 빌드를 선택한 채널의 활성 빌드로 설정하세요.
이 빌드를 되돌리려면 확인하시겠습니까?

롤백 후, 업데이트된 채널에 구성된 장치가 업데이트를 확인할 때 이전 빌드를 받게 됩니다. 롤백된 빌드는 새로운 업데이트로 처리되므로 일반 업데이트 흐름과 조건이 적용됩니다.

채널 해제

채널을 일시적으로 업데이트를 중단하고 문제를 조사하고자 한다면, 채널을 현재 빌드에서 해제할 수 있습니다.

채널을 해제하려면 다음을 수행하세요.

Capgo 대시보드에서 채널을 탐색하세요.
현재 빌드 옆의 '해제' 버튼을 클릭하세요.
채널을 해제하려면 확인하시겠습니까?

__CAPGO_KEEP_0__ 채널이.unlink되면, 새로운 업데이트를 배포하지 않습니다. 채널에 구성된 장치들은 채널이 다시 빌드와 연결될 때까지 현재 빌드에 머물러 있습니다.

이것은 업데이트에 문제가 있는 경우에 유용합니다. 그러나 아직 rollback할 빌드를 선택하지 못한 경우에. 채널을 unlink하면 업데이트를 푸시하지 않고 조사할 시간을 주줍니다.

강제 빌드 인 빌드

어떤 경우에는 채널의 모든 장치가 원래 패키징된 웹 빌드에 다시 돌아가고 싶을 수 있습니다. 이것을 “빌드 인 빌드”라고 합니다.

강제 빌드 인 빌드를 채널에 적용하려면:

Capgo 대시보드에서 채널로 이동하세요.
강제 빌드 인 빌드 버튼을 클릭하세요.
강제 빌드 인 빌드를 적용하려면 확인하세요.

강제 빌드 인 빌드를 적용하면 채널에 구성된 장치들은 다음 업데이트 체크에서 원래 패키징된 웹 빌드로 돌아갑니다. 이것은 현재 빌드에 관계없이 발생합니다.

이것은 특정 이전 빌드로 롤백하는 것보다 더 강력한 롤백 옵션입니다. 왜냐하면 앱이 마지막으로 앱 스토어에 게시된 이후에 출시된 모든 라이브 업데이트를 버리기 때문입니다.

문제 해결 및 대응

문제가 발생한 업데이트의 영향을 최소화하고 빠르게 문제를 해결하기 위해, 업데이트를 모니터링하고 문제를 해결하는 계획을 갖는 것이 중요합니다.

해결책으로는 다음과 같습니다.

업데이트가 문제를 일으키는지 바로 확인하기 위해 사용자 피드백과 충돌 보고서를 즉시 확인하는 것
업데이트를 작은 그룹에 먼저 테스트하고 널리 릴리즈하기 전에 단계적 롤아웃 또는 스테이지드 채널 시스템을 사용하는 것
업데이트를 롤백, 언링크, 또는 내장 번들을 강제로 할 때의 결정 과정을 명확히 하며, 이를 할 수 있는 권한을 가진 사람을 지정하는 것
사용자에게 문제와 해결책에 대해 알리는 것

주의 깊게 모니터링하고 문제가 발생한 업데이트를 빠르게 관리할 수 있는 능력을结合하면, 사용자에게 지속적으로 개선되는 앱 경험을 제공하면서 중단을 최소화할 수 있습니다.

롤백으로 계속 진행

ROLLBACKS를 사용 중이라면 ROLLBACKS ROLLBACKS를 버전 관리와 롤백 계획에 사용하고, 버전 대상 설정에 버전 대상 설정 버전 대상 설정의 구현 세부 정보 업데이트 동작 업데이트 동작의 구현 세부 정보 번들 번들의 구현 세부 정보 Capgo Live Updates Capgo Live Updates의 제품 워크플로우 Capacitor Live Updates를 위한 롤백 전략 Capacitor Live Updates를 위한 롤백 전략의 실제 적용