롤백

설치

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

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

자동 롤백 보호

Capgo에는 사용자에게 손상된 업데이트로부터 보호하는 내장된 안전 메커니즘이 포함되어 있습니다. JavaScript 오류가 메서드 호출 전에 발생하면 플러그인은 자동으로 이전에 작동하던 버전으로 롤백합니다. notifyAppReady() 자동 롤백 작동 방식

__CAPGO_KEEP_0__는 사용자에게 손상된 업데이트로부터 보호하는 내장된 안전 메커니즘이 포함되어 있습니다. JavaScript 오류가 메서드 호출 전에 발생하면 플러그인은 자동으로 이전에 작동하던 버전으로 롤백합니다.

새로운 업데이트가 다운로드되고 적용될 때, Capgo은 앱이 업데이트가 성공적으로 로드되었는지 확인하기 위해 Capgo을 호출하길 기대합니다. notifyAppReady() __CAPGO_KEEP_0__은 업데이트가 성공적으로 로드되었는지 확인하기 위해 __CAPGO_KEEP_0__을 호출하길 기대합니다. 이 메소드는 다음과 같은 신호를 보내는 것을 의미합니다:

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

만약 notifyAppReady() Capgo이 호출되지 않으면 Capgo은 자바스크립트 충돌이나 비상 오류로 인해 업데이트가 초기화되지 않았음을 감지하고:

자동으로 이전에 작동하던 번들을 되돌려줌
문제가 발생한 업데이트를 실패로 표시하여 다시 적용되지 않도록 함
팁

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

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

문서/영역: Capgo 마케팅 웹사이트. 역할: UI 레이블. 위치: 페이지 에이전트/[슬러그].astro. 메시지 키 `agents_page_copy_label` (에이전트 페이지 복사 레이블).

자동 보호 기능은 앱이 비정상적으로 작동하는 경우 사용자가 앱을 사용하지 못하게 막아줍니다.

Capgo이 기다리는 시간을 설정할 수 있습니다. notifyAppReady() __CAPGO_KEEP_0__이 __CAPGO_KEEP_0__을 호출하기까지 기다리는 시간을 설정하려면 appReadyTimeout Capacitor 구성에서

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

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

이전 버전으로 롤백하기

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

롤백 UI 인터페이스

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

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

__CAPGO_KEEP_0__ 대시보드에 로그인하세요. Capgo 대시보드.
롤백할 채널 이름을 클릭하세요.
채널 보기에서 4번째 탭(이력)으로 이동하세요.
__CAPGO_KEEP_0__
원하는 빌드를 역행하기 위해 빌드 히스토리에서 찾으십시오.
선택하여 채널에서 활성 빌드로 만드십시오.
이 빌드로 역행하시겠습니까?

대안 방법: Crown 아이콘 사용

첫 번째 탭에서 Crown 아이콘을 클릭하여 채널 빌드 히스토리에서 빌드를 찾으십시오.

첫 번째 탭에서 역행하고 싶은 빌드를 찾으십시오.
채널 관리 옵션
이 빌드로 역행하시겠습니까?

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

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

Repointing a channel normally takes effect the next time a device checks for an update. Capgo Notifications can send a silent update-check notification to a supported app while it is in the background. With the updater integration enabled, the app can check, download, and install the rollback according to its configured update mode.

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

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

알림: 무음 업데이트를 확인하도록 설정

채널을 해제하는 경우

업데이트를 받을 때까지 기다리게 하는 경우, 채널을 현재 빌드에서 해제할 수 있습니다.

Capgo 채널로 이동하세요.
현재 빌드 옆의 '링크 해제' 버튼을 클릭하세요.
링크 해제를 확인하세요.

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

업데이트에 문제가 발생했지만 rollback할 빌드를 선택하지 못하는 경우 유용합니다. 채널을 unlink하면 업데이트를 푸시하지 않고 조사할 시간을 주는 것입니다.

강제 빌드인 버블

채널의 모든 장치를 원래 앱의 네이티브 바이너리와 함께 패키징된 웹 빌드로 되돌리려면 더 심각한 상황에서 필요할 수 있습니다. 이 것을 '빌드인 버블'이라고 합니다.

강제 빌드인 버블을 채널에 적용하려면:

Capgo 채널로 이동하세요.
강제 빌드인 버블을 확인하세요.
강제 빌드인 버블을 확인하세요.

강제로 내장 패키지를 빌드하면, 해당 채널에 구성된 모든 기기들은 다음 업데이트 확인 시 원래 패키지된 웹 빌드로 돌아갑니다. 이 현상은 기기들이 현재 어떤 빌드에 있는지에 관계없이 발생합니다.

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

문제 해결 및 반응

문제가 발생한 업데이트를 빨리 발견하고 문제가 발생한 업데이트의 영향을 최소화하기 위해서는 문제 해결 및 반응에 대한 계획을 갖는 것이 중요합니다.

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

한 그룹에만 롤아웃이 제한된 경우에는 진보적인 롤아웃 Live Update를 중지하거나 stable 채널의 전체 버전을 변경하기 전에 대상으로부터 노출을 중지하거나 지우세요.

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

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

Rollbacks에서 계속합니다.

Rollbacks를 사용하여 rollback과 버전 관리를 계획하고, 버전 관리를 연결하여 버전 목표 context 페이지/영역: Capgo 솔루션 마케팅 페이지. 역할: 짧은 UI 레이블 또는 네비게이션 아이템. 위치: 사이트 헤더, SolutionsMegaMenu.astro, 페이지 solutions/version-targeting.astro. 메시지 키 `solutions_version_targeting` (솔루션 버전 목표). 버전 목표에 대한 구현 세부 정보를 참조하세요. 업데이트 동작 업데이트 동작의 구현 세부 사항에 대해 배포 배포의 구현 세부 사항에 대해 Capgo 라이브 업데이트 Live Updates의 제품 워크플로우에서 Capgo Live Updates에 대해 업데이트 동작의 제품 워크플로우에 대해 Capacitor Live Updates, Capacitor Live Updates에 대한 롤백 전략