롤백

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

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 오류가 메서드 호출 전에 발생하면 플러그인은 자동으로 이전에 작동하던 버전으로 롤백합니다.

자동 롤백의 작동 방식

Capgo이 앱이 업데이트가 성공적으로 로드되었는지 확인하기 위해 Capgo이 다운로드 및 적용된 새로운 업데이트를 호출할 때까지의 시간 프레임을 조정할 수 있습니다. notifyAppReady() __CAPGO_KEEP_0__이 호출되지 않으면 __CAPGO_KEEP_0__은:

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

만약 notifyAppReady() Capgo이 호출되지 않으면 Capgo은:

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

Tip

앱 초기화 시 __CAPGO_KEEP_0__을 호출하여 notifyAppReady() 앱의 핵심 컴포넌트가 성공적으로 로드된 후 code을 호출하세요. 이로 인해 자동 롤백 보호 기능이 정상적으로 작동하도록 보장합니다.

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() __CAPGO_KEEP_0__이 __CAPGO_KEEP_0__을 호출하기까지 기다리는 시간을 설정하려면 appReadyTimeout Capacitor의 Capacitor 설정에서

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

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

이전 버전으로 롤백하기

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

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

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

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

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

3. __CAPGO_KEEP_0__ Dashboard

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

5. 롤백할 빌드의 버전을 찾으세요.

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

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

대안 방법: Crown 아이콘 사용

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

1. 첫 번째 탭에서 롤백할 빌드를 찾으세요.
2. 첫 번째 탭에서 롤백할 빌드의 Crown 아이콘을 클릭하여 채널의 활성 빌드로 선택하세요.
3. 이 빌드로 롤백하시겠습니까?

주의

선택한 채널로 돌아가기만 하면 영향을 받는 채널에 한해서만 영향을 미칩니다. 여러 채널 (예: Production, Staging, etc.)이 있는 경우, 영향을 받는 채널에 대해 반복적으로 롤백 프로세스를 수행해야 합니다.

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

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

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

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

이 경로를 설정하려면 알림: 무음 업데이트를 확인하도록 허용.

채널을.unlink

업데이트를 조사하는 중에 일시적으로 업데이트를 중단하고 싶다면, 현재 빌드와 채널을.unlink할 수 있습니다.

채널을 연결 해제하려면:

1. Capgo 대시보드에서 채널을 탐색하세요.

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

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

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

업데이트에 문제가 발생했지만 현재 빌드에 롤백할 빌드를 결정하지 못한 경우 유용합니다. 채널을 연결 해제하면 업데이트를 푸시하지 않고 조사 시간을 주는 데 도움이 됩니다.

빌트인 번들을 강제로 적용하기

채널의 모든 장치가 원래 앱의 네이티브 바이너리와 함께 패키징된 웹 빌드로 다시 돌아가도록 원활하게 되돌리려면 더 심각한 상황에서 필요할 수 있습니다. 이 것을 "빌트인 번들"이라고 합니다.

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

1. Capgo 대시보드에서 채널을 탐색하세요.

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

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

강제로 내장 패키지를 설정하면, 해당 채널로 구성된 모든 기기들은 다음 업데이트를 확인할 때 원래 패키지된 웹 빌드로 돌아갑니다. 이 작업은 현재 빌드에 관계없이 수행됩니다.

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

주의

강제로 내장 패키지를 설정할 때 주의해야 합니다. 이 작업은 모든 채널에 영향을 미치므로, 이 작업을 수행하기 전에 충분히 고려하고 계획을 세우세요.

문제 해결 및 모니터링

다음 전략을 사용하세요:

한정된 코호트에 대한 롤아웃을 사용할 때

진보적 롤아웃 Progressive rollouts 업데이트를 중단하거나 안정 버전을 변경하기 전에 대상으로부터 노출을 중단하거나 제거하는 방법입니다.

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

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

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 롤백 전략의 실제 적용