롤백

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__

__CAPGO_KEEP_0__

새로운 업데이트가 다운로드 및 적용되었을 때, Capgo은 앱이 업데이트가 성공적으로 로드되었는지 확인하기 위해 Capgo을 호출해야 합니다. 이 메소드는 다음과 같은 신호를 보냅니다: notifyAppReady() 자바스크립트 번들을 로드하는 데 중대한 오류가 없다는 것을 의미합니다.

• 앱의 핵심 기능이 작동하고 있습니다.
• 업데이트가 안전하게 유지될 수 있습니다.
• 만약

__CAPGO_KEEP_0__이 호출되지 않으면 __CAPGO_KEEP_0__은 자바스크립트 충돌 또는 중대한 오류로 인해 업데이트가 초기화되지 않았음을 감지하고: notifyAppReady() is not called due to a JavaScript crash or critical error, Capgo will:

1. 문제가 있는 업데이트를 실패로 표시하여 다시 적용되지 않도록 합니다.
2. Tip
3. Tip

Tip

앱 초기화 시 notifyAppReady() code

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
    }
  }
}

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

이전 버전으로 롤백하기

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

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

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

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

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

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

4. __CAPGO_KEEP_0__ 대시보드

5. 이 빌드의 역사를 확인하여 원하는 빌드를 찾으세요.

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

7. 이 빌드를 되돌아가겠습니까?

대안 방법: Crown 아이콘 사용

첫 번째 탭에서 Crown 아이콘을 클릭하여 채널의 빌드 역사를 확인하세요.

1. 첫 번째 탭에서 원하는 빌드를 찾으세요.
2. Crown 아이콘을 클릭하여 채널의 활성 빌드로 설정하세요.
3. 이 빌드를 되돌아가겠습니까?

주의

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

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

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

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

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

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

채널을 해제하는 방법

업데이트를 조사하는 중인 문제를 해결하기 위해 일시적으로 업데이트를 중단하려면, 현재 빌드와 채널을 해제할 수 있습니다.

채널을 해제하려면:

1. Capgo 채널로 이동하세요.

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

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

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

업데이트에 문제가 발생했지만 rollback할 빌드를 선택하지 못하는 경우 유용합니다. 연결을 해제하면 문제를 조사할 시간을 주고 더 이상 업데이트를 푸시하지 않습니다.

강제 빌드 인 배너

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

강제 빌드 인 배너를 채널에 적용하려면:

1. Capgo 채널로 이동하세요.

2. 빌드 인 배너 버튼을 클릭하세요.

3. 강제 빌드 인 배너를 적용하시겠습니까?

When you force the built-in bundle, all devices configured to that channel will revert back to the original packaged web build on their next update check. This happens regardless of what build they’re currently on.

This is a more aggressive rollback option than reverting to a specific previous build, as it discards all live updates released since the app was last published to the app stores.

주의

When forcing the built-in bundle, be cautious as it will affect all devices on the channel. Make sure you’ve considered the impact and have a plan to move forward before taking this action.

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

한 번에 출시된 롤아웃을 대상으로 하여,

진보적인 롤아웃

노출을 중단하거나 대상으로 하여, 전체 채널에서 안정적인 번들을 변경하기 전에 사용할 수 있습니다. progressive rollouts to pause exposure or clear its target before changing the stable bundle for the whole channel.

• 업데이트 릴리스 직후 사용자 피드백과 오류 보고서를 즉시 모니터링합니다.
• 업데이트를 더 넓은 범위로 릴리스하기 전에 더 작은 그룹에 테스트하기 위한 phased rollouts 또는 staged channel 시스템을 사용합니다.
• 업데이트를 롤백, 언링크, 또는 내장 번들을 강제로 할 때의 결정 과정을 명확히 하며, 이를 수행할 권한이 있는 사람을 결정합니다.
• 사용자에게 문제와 해결책에 대한 정보를 전달합니다. (만약 필요하다면)

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

롤백에서 계속하세요.

Capgo를 사용하여 rollback과 버전 관리를 계획하고 버전 목표 설정을 연결합니다. 버전 목표 설정 버전 목표 설정을 구현하는 구체적인 세부 사항입니다. 버전 목표 설정 버전 목표 설정 업데이트 동작 업데이트 동작 구현 세부 사항을 위해 번들 번들 구현 세부 사항을 위해 Capgo Live Updates Capgo Live Updates Capacitor Live Updates 제품 워크플로우를 위해, Capacitor Live Updates