롤백

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 provides several ways to manage a channel’s builds and control the version of your app that users receive, including both manual rollback options and automatic safety mechanisms.

자동 롤백 보호

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

자동 롤백 작동 방식 섹션

업데이트가 다운로드되고 적용될 때, Capgo는 앱이 호출해야 하는 것을 기대합니다. notifyAppReady() 사용자 앱의 핵심 기능이 작동함

• 업데이트가 안전하게 유지됨
• 만약
• 만약

만약 notifyAppReady() JavaScript 오류나 심각한 오류로 인해 호출되지 않으면 Capgo는:

1. 업데이트가 초기화되지 않았는지 감지합니다.
2. 이전의 작동하는 패키스로 자동으로 되돌아갑니다.
3. 문제가 있는 업데이트를 실패로 표시하여 다시 적용되지 않도록 합니다.

팁

앱의 초기화에서 __CAPGO_KEEP_0__를 호출하여 핵심 컴포넌트가 성공적으로 로드된 후에 호출하십시오. 이 보장된 자동 롤백 보호 기능이 올바르게 작동하도록 합니다. notifyAppReady() 애플리케이션 초기화 시 code core 컴포넌트가 성공적으로 로드된 후에 이 기능을 사용하세요. 이 기능은 자동 롤백 보호 기능이 정상적으로 작동하도록 보장합니다.

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

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

타임아웃 설정

타임아웃 설정

Capgo의 대기 시간을 설정하려면 notifyAppReady() __CAPGO_KEEP_0__의 설정에서 appReadyTimeout Capacitor 설정에서

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

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

이전 버전으로 롤백하기

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

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

__CAPGO_KEEP_0__ 대시보드의 이력 탭에서 롤백하는 방법

1. 로그인하여 Capgo 대시보드에.

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

3. 원하는 채널 이름을 클릭하세요.

4. 채널 보기에서 4번째 탭(히스토리)으로 이동하세요.

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

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

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

대안 방법: Crown 아이콘 사용

채널 빌드 히스토리에서 첫 번째 탭으로 이동하여 Crown 아이콘을 클릭하세요.

1. 첫 번째 탭에서 원하는 빌드를 찾으세요.
2. 이 빌드를 채널에 활성화하려면 빌드 옆에 있는 왕관 아이콘을 클릭하세요.
3. 이 빌드로 롤백하려면 확인하세요.

주의

이전 빌드로 롤백하면 선택한 채널만 영향을 받습니다. 여러 채널 (예: 프로덕션, 스테이징 등)이 있다면 각 채널에 대해 롤백 프로세스를 반복해야 합니다.

롤백 후, 업데이트를 체크하는 장치에 업데이트된 채널을 구성한 장치만 이전 빌드를 받을 것입니다. 롤백한 빌드는 새로운 업데이트로 처리되므로 일반 업데이트 흐름과 조건이 적용됩니다.

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

채널을 다시 지시하는 경우, 장치가 업데이트를 체크할 때까지 효과가 나타납니다. Capgo 알림은 지원되는 앱이 배경에서 실행 중일 때 silent 업데이트를 체크할 수 있도록 합니다. 업데이터 통합이 활성화된 경우, 앱은 업데이트 모드에 따라 체크, 다운로드, 설치할 수 있습니다.

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

이 경로를 설정하려면 알림: 무음 업데이트 확인을 활성화하세요..

채널 해제

채널을 현재 빌드에서 일시적으로 업데이트 확인을 중단하고 문제를 조사하는 동안에 문제가 발생한 빌드에 대한 문제를 해결하기 위해 채널을 현재 빌드에서 해제할 수 있습니다.

채널을 해제하려면:

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

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

3. 채널을 해제할 것인지 확인하세요.

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

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

빌드인 번들 강제

더 심각한 상황에서, 채널 내 모든 기기에서 앱의 네이티브 바이너리와 함께 원래 패키징된 웹 빌드로 되돌리기를 원할 수 있습니다. 이 것을 "내장된 번들"이라고 합니다.

채널에 내장된 번들을 강제로 적용하려면:

1. Capgo 대시보드에서 채널을 선택합니다.

2. 내장된 번들을 클릭합니다.

3. 내장된 번들을 강제로 적용하시겠습니까?

내장된 번들을 강제로 적용하면, 채널에 구성된 모든 기기는 다음 업데이트 확인 시 원래 패키징된 웹 빌드로 되돌아갑니다. 기기는 현재 어떤 빌드인지에 관계없이 이 과정이 발생합니다.

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

주의

내장된 번들을 강제로 적용할 때 주의해야 합니다. 채널에 있는 모든 기기를 영향받게 되므로, 이 액션을 취하기 전에 충분히 고려하고 앞으로 나아가기 위한 계획을 세우세요.

문제를 모니터링하고 대응하기

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

어떤 전략을 사용할 수 있습니다:

코호트에 한정된 롤아웃이 아직 진행 중인 경우에는 진보적 롤아웃 Live Update를 중단하거나 stable bundle을 전체 채널에 적용하기 전에 노출을 중단하거나 대상으로부터 지우세요.

• 안정적인 채널의 전체 버전을 변경하기 전에 노출을 중단하거나 대상자를 지우거나.
• 업데이트를 릴리스한 직후에 사용자 피드백과 크래시 리포트를 즉시 모니터링하는 것
• 작은 그룹에 업데이트를 테스트하기 전에 넓은 릴리스를 위해 사용하는 단계적 롤아웃 또는 단계적 채널 시스템
• 롤백, 언링크, 또는 내장 버전 강제로 변경할 때의 결정 프로세스를 명확하게 하며, 이를 수행할 권한이 있는 사람을 결정하는 것

사용자에게 문제와 해결책에 대한 정보를 전달하는 것

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

Live Updates 롤백 롤백 버전 관리 버전 관리 Live Updates Live Updates Live Updates Live Updates Capgo Live Updates Live Updates의 제품 워크플로우에서 Capgo Live Updates, 및 Capacitor 리브 업데이트 롤백 전략 롤백 전략에 대한 실용적인 맥락에서 Live Update의 Capacitor을 위한 롤백 전략.