롤백

Capgo의 라이브 업데이트 기능으로 인해 사용자에게 빠르게 개선 사항 및 수정 사항을 제공할 수 있지만, 사용자에게 제공하는 앱의 이전 버전으로 롤백해야 하는 상황이 발생할 수 있습니다. 예를 들어, 새로운 업데이트가 예상치 못한 심각한 문제를 발생시키거나, 특정 변경 사항을 롤백하고修정에 대한 작업을 수행하는 동안 롤백하고 싶을 수 있습니다.

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

자동 롤백 보호

Capgo은 사용자가 깨진 업데이트로부터 보호하기 위해 내장된 안전 메커니즘을 제공합니다. JavaScript 오류가 method가 호출되기 전에 발생하면 플러그인은 자동으로 이전에 작동하던 버전으로 롤백합니다. notifyAppReady() __CAPGO_KEEP_0__

자동 롤백의 작동 방식

Capgo이 앱이 업데이트가 성공적으로 로드되었는지 확인하기 위해 Capgo이 업데이트를 다운로드하고 적용할 때, 앱이 Capgo이 지정한 시간 내에 호출해야 합니다. notifyAppReady() __CAPGO_KEEP_0__이 호출되지 않으면 __CAPGO_KEEP_0__은:

• JavaScript 번들이 비정상적인 오류 없이 로드되었습니다.
• 앱의 핵심 기능이 작동하고 있습니다.
• 업데이트가 안전합니다.

만약 __CAPGO_KEEP_0__이 호출되지 않으면 __CAPGO_KEEP_0__은: notifyAppReady() is not called due to a JavaScript crash or critical error, Capgo will:

1. 이전의 작동하는 번들을 자동으로 되돌립니다.
2. 문제가 있는 업데이트를 실패로 표시하여 다시 적용되지 않도록 합니다.
3. If __CAPGO_KEEP_0__ is not called due to a JavaScript crash or critical error, __CAPGO_KEEP_0__ will:

Tip

앱 초기화 시 __CAPGO_KEEP_0__을 호출하기 전에 핵심 컴포넌트가 성공적으로 로드되도록 하세요. 이로 인해 자동 롤백 보호 기능이 원활하게 작동할 수 있습니다. notifyAppReady() in your app’s initialization code after your core components have loaded successfully. This ensures the automatic rollback protection works as intended.

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

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

Timeout 설정

Timeout 설정

Capgo 설정에서 notifyAppReady() Copy to clipboard appReadyTimeout in your Capacitor configuration:

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

The appReadyTimeout value is specified in milliseconds. The default timeout is typically 10 seconds, but you can adjust this based on your app’s initialization requirements. If your app takes longer to load due to complex initialization processes, you may want to increase this value.

__CAPGO_KEEP_0__의 이전 버전으로 롤백하기

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

Capgo의 롤백은 주로 History 탭을 통해 이루어집니다. 이 탭은 Capgo 대시보드에서 채널을 보는 경우 4번째 탭에 위치하고 있습니다. 이 탭은 채널에 대한 모든 빌드의 목록을 제공하여 이전 버전으로 쉽게 선택하고 되돌릴 수 있도록 합니다.

__CAPGO_KEEP_0__으로 롤백하기

1. __CAPGO_KEEP_0__ 대시보드에 로그인하세요. Capgo 대시보드에 로그인하세요..

2. __CAPGO_KEEP_0__의 '채널' 섹션으로 이동하세요.

3. __CAPGO_KEEP_0__의 채널 이름을 클릭하세요.

4. 4번째 탭 (History)으로 채널 보기로 이동하세요.

5. 빌드 히스토리에서 롤백하고 싶은 빌드를 찾으세요.

6. 채널의 빌드로 롤백하고 싶은 빌드를 선택하세요.

7. 이 빌드로 롤백하시겠습니까?

대안 방법: Crown 아이콘 사용

첫 번째 탭에서 Crown 아이콘을 클릭하여 채널의 빌드 히스토리에서 롤백할 수 있습니다.

1. 채널의 빌드 히스토리에서 롤백하고 싶은 빌드를 찾으세요.
2. 첫 번째 탭에서 빌드 히스토리에서 롤백하고 싶은 빌드 옆에 있는 Crown 아이콘을 클릭하세요.
3. 이 빌드로 롤백하시겠습니까?

__CAPGO_KEEP_0__

롤백은 선택한 채널에만 영향을 미칩니다. 여러 채널 (예: Production, Staging, etc.)이 있다면, 각 채널에 영향을 미치는 롤백 프로세스를 반복해야 합니다.

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

채널 해제

업데이트를 잠시 중단하고 문제를 조사하고 싶다면, 현재 빌드와 연결된 채널을 해제할 수 있습니다.

채널을 해제하려면:

1. Capgo

2. 해제

3. 해제를 확인합니다.

채널이 해제되면, 새로운 업데이트를 배포하지 않습니다. 해제된 채널을 듣도록 구성된 기기는 채널이 다시 빌드와 연결될 때까지 현재 빌드에 머물러 있습니다.

이것은 업데이트에 문제가 있는 것으로 판단했지만, 롤백할 빌드를 결정하지 못했을 때 유용합니다. 채널을 해제하면, 문제를 조사할 시간을 주면서 더 이상 업데이트를 푸시하지 않습니다.

Built-In Bundle 강제

더 심각한 상황에서는 앱의 네이티브 바이너리와 함께 원래 패키징된 웹 빌드로 채널 내 모든 기기들을 되돌리려는 경우가 있습니다. 이 것을 "built-in bundle"이라고 합니다.

채널에 있는 기기들을 built-in bundle로 강제로 설정하려면:

1. Capgo 대시보드에서 채널로 이동하세요.

2. built-in bundle 버튼을 클릭하세요.

3. built-in bundle 강제 설정을 확인하세요.

built-in bundle 강제 설정을 하면 채널에 설정된 모든 기기는 다음 업데이트 체크 시 원래 패키징된 웹 빌드로 되돌아갑니다. 이 작업은 기기가 현재 어느 빌드인지에 관계없이 발생합니다.

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

주의

built-in bundle 강제 설정을 할 때 주의해야 합니다. 왜냐하면 채널에 있는 모든 기기를 영향을 받게 됩니다. 이 작업의 영향을 고려하고 앞으로의 계획을 세우신 후에 이 작업을 수행하세요.

__CAPGO_KEEP_0__

__CAPGO_KEEP_0__

__CAPGO_KEEP_0__

• __CAPGO_KEEP_0__
• __CAPGO_KEEP_0__
• __CAPGO_KEEP_0__
• __CAPGO_KEEP_0__

__CAPGO_KEEP_0__

__CAPGO_KEEP_0__

__CAPGO_KEEP_0__ 롤백 __CAPGO_KEEP_0__을 연결하여 계획 롤백 및 버전 관리를 하세요. 버전 목표 버전 목표에 대한 구현 세부 정보를 위해 업데이트 동작 업데이트 동작에 대한 구현 세부 정보를 위해 번들 번들에 대한 구현 세부 정보를 위해 Capgo Live Updates Capgo Live Updates의 제품 워크플로에 대해 Capacitor Live Updates의 롤백 전략 Capacitor Live Updates의 실제 상황에 대한 롤백 전략