롤백

Capgo의 라이브 업데이트로 인해 사용자에게 빠르게 개선 사항과 수정 사항을 제공할 수 있지만, 이전 버전의 앱으로 롤백해야 하는 상황이 발생할 수 있습니다. 새로운 업데이트가 예상치 못한 심각한 문제를 발생시키거나, 특정 변경 사항을 되돌리면서 해결 방법을 찾을 때까지 revert하고 싶을 수 있습니다.

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

자동 롤백 보호

Capgo includes a built-in safety mechanism to protect your users from broken updates. If a JavaScript error occurs before the notifyAppReady() __CAPGO_KEEP_0__은 사용자가 깨진 업데이트로부터 보호하기 위해 내장된 안전 메커니즘을 제공합니다. JavaScript 오류가 method가 호출되기 전에 발생하면, 플러그인은 자동으로 이전에 작동하던 버전으로 롤백합니다.

자동 롤백의 작동 방식

Capgo이 앱이 업데이트가 성공적으로 로드되었는지 확인하기 위해 Capgo이 다운로드 및 적용된 새로운 업데이트를 호출할 때까지 기다립니다. notifyAppReady() __CAPGO_KEEP_0__이 업데이트가 성공적으로 로드되었는지 확인하기 위해 __CAPGO_KEEP_0__이 다운로드 및 적용된 새로운 업데이트를 호출할 때까지 기다립니다. 이 메서드는 다음과 같은 신호를 보냅니다:

• JavaScript 번들 로드 시 비상 오류가 발생하지 않음
• 앱의 핵심 기능이 작동함
• 업데이트가 안전하게 유지됨

만약 notifyAppReady() Capgo이 호출되지 않으면 JavaScript 충돌 또는 비상 오류로 인해 Capgo은:

1. 업데이트가 초기화되지 않았음을 감지하고
2. 이전의 작동하는 번들을 자동으로 되돌려줌
3. 문제가 있는 업데이트를 실패로 표시하여 다시 적용되지 않도록 함

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()

Copy to clipboard

오류가 발생한 업데이트를 실수로 푸시해도 사용자는 비정상적인 앱과 마주치지 않도록 자동 보호 기능이 도와줍니다.

You can configure how long Capgo waits for notifyAppReady() Copy to clipboard appReadyTimeout in your Capacitor configuration:

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

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

이전 버전으로 롤백하는 방법

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

롤백은 Capgo 대시보드의 4번째 탭(이력)에서 찾을 수 있습니다. 이 탭은 채널의 모든 빌드에 대한 포괄적인 시각화를 제공하여 이전 버전으로 쉽게 선택하고 되돌릴 수 있습니다.

이력 탭을 사용하여 롤백하는 방법:

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

2. 롤백할 채널 이름을 클릭하세요.

3. __CAPGO_KEEP_0__

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

5. 롤백할 빌드의 빌드 히스토리에서 찾으세요.

6. 이 빌드를 채널의 활성 빌드로 선택하세요.

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

대안 방법: Crown 아이콘 사용

첫 번째 탭에서 Crown 아이콘을 클릭하여 채널의 빌드 히스토리에서 롤백할 빌드를 찾으세요.

1. 첫 번째 탭에서 롤백할 빌드를 찾으세요.
2. 채널 관리 옵션
3. 참고

주의

선택한 채널로 돌아가는 것은 단지 선택한 채널만 영향을 미칩니다. 여러 채널 (예: Production, Staging, etc.)이 있는 경우 각 채널에 영향을 미치는 경우 rollback 프로세스를 반복해야 합니다.

롤백 후, 업데이트된 채널을 듣도록 구성된 기기는 다음 업데이트를 확인할 때 이전 빌드를 받게 됩니다. 롤백된 빌드는 일반 업데이트와 같은 흐름과 조건을 따릅니다.

긴급 롤백을 가속화하는 알림

채널을 다시 연결하는 것은 일반적으로 다음 업데이트를 확인할 때까지 효과가 있습니다. Capgo 알림은 지원되는 앱이 배경에서 실행 중일 때 silent 업데이트를 확인할 수 있도록 silent 업데이트를 확인하는 알림을 보내는 기능입니다. 업데이터 통합이 활성화된 경우 앱은 업데이트 모드에 따라 업데이트를 확인, 다운로드, 설치할 수 있습니다.

이것은 가속화 경로이며 강제된 플릿 명령이 아닙니다. 배달은 최선의 노력으로 운영 체제 배경 스케줄링, 네트워크 가용성 및 장치 상태에 따라 결정됩니다. 오프라인 또는 강제 종료된 앱을 업데이트할 수 없으므로 모든 장치에 도달하는 데 고정된 시간을 약속할 수 없습니다.

이 경로를 설정하려면 다음을 따르십시오. 알림: 무음 업데이트를 확인하도록 허용하십시오.

채널을 해제하십시오

채널을 해제하면 잠시 동안 업데이트를 중단할 수 있습니다. 이 경우 문제를 조사하는 동안 업데이트를 중단하고 싶다면 채널을 현재 빌드에서 해제할 수 있습니다.

채널을 해제하려면:

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

2. 현재 빌드 옆의 "해제" 버튼을 클릭하세요.

3. 채널을 해제하시겠습니까?

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

업데이트에 문제가 발견되었지만 아직 롤백할 빌드를 결정하지 못한 경우 유용합니다. 채널을 해제하면 업데이트를 푸시하지 않고 조사 시간을 얻을 수 있습니다.

빌트인 번들을 강제로 적용하는 경우

채널의 모든 장치를 원래 앱의 네이티브 바이너리와 함께 패키징된 웹 빌드로 되돌리려면 더 심각한 상황에서 사용할 수 있습니다. 이 경우 "빌트인 번들"이라고 합니다.

채널에 빌트인 번들을 강제로 적용하려면:

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

2. "빌트인 번들" 버튼을 클릭하세요.

3. 강제로 내장 패키지를 확인하시겠습니까?

강제로 내장 패키지를 설정하면, 해당 채널로 구성된 모든 기기들은 다음 업데이트 확인 시 원래 패키지된 웹 빌드를 다시 사용하게 됩니다. 이 작업은 기기들이 현재 사용 중인 빌드와 관계없이 발생합니다.

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

주의

강제로 내장 패키지를 설정할 때 주의해야 합니다. 이는 채널에 있는 모든 기기를 영향받게 하므로, 이 작업을 수행하기 전에 충분히 고려하고 진행 방안을 마련해야 합니다.

문제를 신속하게 발견하고 문제가 있는 업데이트의 영향을 최소화하기 위해, 릴리스를 모니터링하고 문제를 해결하는 계획을 갖는 것이 중요합니다.

한정된 코호트에 대한 롤아웃을 진행 중이라면

진보적 롤아웃

__CAPGO_KEEP_0__ __CAPGO_KEEP_0__ 업데이트를 중단하거나 안정 버전을 변경하기 전에 대상으로부터 노출을 중단하거나 제거하는 방법입니다.

• 업데이트가 출시된 직후 사용자 피드백과 오류 보고서를 모니터링합니다.
• 업데이트를 작은 그룹에 테스트하기 위해 phased rollouts 또는 staged channel 시스템을 사용합니다.
• 업데이트를 되돌리기, unlink, 또는 built-in bundle 강제로 변경할 때의 결정 과정을 명확히 하며, 해당 권한을 가진 사람을 지정합니다.
• 사용자에게 문제와 해결책에 대한 정보를 전달합니다.

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

Rollbacks에서 계속하기

Rollbacks를 사용하여 되돌리기와 버전 관리를 계획하고, 그것을 버전 목표와 연결하세요. Rollbacks 버전 목표 버전 목표 __CAPGO_KEEP_0__ Live Updates 업데이트 동작 __CAPGO_KEEP_0__ Live Updates 구현 세부 사항 배포 __CAPGO_KEEP_0__ Live Updates 구현 세부 사항 Capgo Live Updates Capgo Live Updates 제품 워크플로우에 대해 Capacitor Live Updates 롤백 전략 Capacitor Live Updates 롤백 전략의 실제 적용