롤백

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

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

자동 롤백 보호

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

자동 롤백 방법

When a new update is downloaded and applied, Capgo expects your app to call Capgo's method before the method is called, the plugin will automatically roll back to the previous working version. notifyAppReady() 업데이트가 성공적으로 로드되었는지 확인하기 위해 구성 가능한 시간 프레임 내에서 확인합니다. 이 메서드는 다음을 시그널합니다:

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

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

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

팁

__CAPGO_KEEP_0__을 호출하십시오 notifyAppReady() In code에서 앱 초기화 후 code core 컴포넌트가 성공적으로 로드된 후에. 이 보장은 자동 롤백 보호 기능이 의도된 대로 작동하도록 합니다.

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

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

이 자동 보호 기능은 앱이 깨진 업데이트로 인해 비정상적으로 작동하는 경우 사용자가 막히지 않도록 보장합니다.

타임아웃 설정

Capgo은 Capgo이 호출되기까지 얼마나 오랜 시간을 기다릴 것인지 설정할 수 있습니다. notifyAppReady() 설정하는 방법 appReadyTimeout Capacitor의 Capacitor 설정에서

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

값은 밀리초 단위로 지정됩니다. 기본 타임아웃은 일반적으로 10초지만, 앱 초기화 요구 사항에 따라 조정할 수 있습니다. 앱 초기화 프로세스가 복잡하여 로드 시간이 길 경우 이 값을 증가시키는 것이 좋습니다. appReadyTimeout 이전 버전으로 롤백

이전 버전으로 롤백

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

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

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

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

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

3. 채널 보기에서 4 번째 탭 (이력)으로 이동하세요.

4. 빌드 이력을 확인하여 되돌리려는 빌드를 찾으세요.

5. 빌드를 선택하여 채널에 활성화된 빌드로 설정하세요.

6. __CAPGO_KEEP_0__ 대시보드

7. 이 빌드를 되돌리려면 확인합니다.

대안 방법: Crown 아이콘 사용

빌드 히스토리에서 채널의 첫 번째 탭에서 빌드를 되돌리려면 Crown 아이콘을 클릭하세요.

1. 채널의 첫 번째 탭에서 빌드를 찾으세요.
2. Crown 아이콘을 클릭하여 채널의 활성 빌드로 지정하세요.
3. 이 빌드를 되돌리려면 확인합니다.

주의

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

되돌리기를 완료한 후, 업데이트를 확인할 때 업데이트된 채널을 듣는 장치가 이전 빌드를 받을 것입니다. 롤백된 빌드는 일반 업데이트와 동일한 흐름과 조건을 따릅니다.

비상 롤백을 가속화하는 알림 (비공개 프리뷰)

채널을 다시 연결하는 데 일반적으로 다음 장치가 업데이트 확인을 위해 확인할 때까지 몇 분 정도 걸립니다. Capgo 알림 통합은 현재 비공개 프리뷰 상태이며, 지원되는 앱이 배경에서 실행 중일 때 silent update-check 알림을 보내는 데 사용할 수 있습니다. 업데이터 통합이 활성화되면 앱은 구성된 업데이트 모드에 따라 롤백을 확인하고 다운로드하고 설치할 수 있습니다.

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

비상 롤백 경로를 요청하거나 설정하려면 support@__CAPGO_KEEP_0__.app로 연락하세요. support@capgo.app채널을 해제하는 경우 채널을 해제하는 경우.

채널을 해제하려면

__CAPGO_KEEP_0__

__CAPGO_KEEP_0__

1. 채널을 Capgo 대시보드에서 열어보세요.

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

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

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

업데이트에 문제가 발생했지만 rollback할 빌드를 아직 결정하지 못한 경우 유용합니다. 채널을 해제하면 문제를 조사할 시간을 주면서 추가 업데이트를 배포하지 않습니다.

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

문제가 심각한 경우, 앱의 네이티브 바이너리와 함께 패키징된 웹 빌드로 모든 기기를 다시 되돌리려는 경우가 있습니다. 이 것을 빌트인 번들이라고 합니다.

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

1. 채널을 Capgo 대시보드에서 열어보세요.

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

3. 빌트인 번들을 강제로 적용하시겠습니까?

__CAPGO_KEEP_0__의 모든 기기에서 __CAPGO_KEEP_0__ 채널을 설정한 경우, 다음 업데이트를 확인할 때 원래 패키지된 웹 빌드를 다시 사용하게 됩니다. 이 현상은 현재 빌드에 관계없이 발생합니다.

__CAPGO_KEEP_0__를 강제로 빌드할 때, 앱이 마지막으로 앱 스토어에 게시된 이후에 릴리즈된 모든 라이브 업데이트를 폐기합니다. 이 옵션은 특정 이전 빌드로 돌아가는 것보다 더 강력한 롤백 옵션입니다.

주의

__CAPGO_KEEP_0__ 채널의 모든 기기를 강제로 빌드할 때 주의해야 합니다. 이 작업의 영향을 고려하고 다음 단계를 계획한 후에 이 작업을 수행해야 합니다.

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

__CAPGO_KEEP_0__가 아직 __CAPGO_KEEP_1__에 제한된 롤아웃인 경우, __CAPGO_KEEP_2__를 사용하여

__CAPGO_KEEP_2__

__CAPGO_KEEP_2__를 사용하여 노출을 중단하거나 __CAPGO_KEEP_1__의 대상으로부터 __CAPGO_KEEP_2__를 지우고 __CAPGO_KEEP_0__ 채널의 전체 기기에서 안정적인 빌드를 변경할 수 있습니다. __CAPGO_KEEP_3__ 및 __CAPGO_KEEP_4__를 위한 계획이 필요합니다. __CAPGO_KEEP_5__

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

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

롤백에서 계속하기

이미 사용 중이라면 롤백 롤백을 계획하고 버전 관리를 위해 사용하는 경우 버전 대상 설정 버전 대상 설정 업데이트 동작 업데이트 동작의 구현 세부 사항에 대해 번들 번들의 구현 세부 사항에 대해 Capgo Live Updates Capgo Live Updates의 제품 워크플로에 대해, 및 Capacitor Live Updates의 롤백 전략 Capacitor Live Updates의 롤백 전략의 실제 상황에 대해.