롤백

이 플러그인의 설치 단계와 전체 마크다운 가이드가 포함된 설정 지시를 복사하세요.

While Capgo의 실시간 업데이트 기능을 통해 사용자에게 빠르게 개선 사항과 수정 사항을 제공할 수 있지만, 사용자에게 이전 버전의 앱으로 돌아가야 하는 상황이 발생할 수 있습니다. 새로운 업데이트에서 예상치 못한 심각한 문제가 발생했거나, 특정 변경 사항을 수정하는 동안 해결책을 찾을 때까지 이전 버전으로 돌아가고 싶을 수 있습니다.

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

자동 롤백 보호

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

‘자동 롤백 방법’ 제목

When a new update is downloaded and applied, Capgo expects your app to call notifyAppReady() JavaScript 번들 로드 시 심각한 오류가 발생하지 않았습니다.

앱의 핵심 기능이 작동하고 있습니다.
__CAPGO_KEEP_0__
업데이트는 안전합니다.

만약 notifyAppReady() Capgo

JavaScript 충돌이나 심각한 오류로 인해 호출되지 않으면 __CAPGO_KEEP_0__가:
업데이트가 올바르게 초기화되지 않은 것을 감지합니다.
이전의 작동하는 번들을 자동으로 되돌아갑니다.

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

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

클립보드에 복사하기

__CAPGO_KEEP_0__ 시간 초과 설정

Capgo이 Capgo에 의해 호출되기까지 기다리는 시간을 설정할 수 있습니다. notifyAppReady() 을 설정하여 appReadyTimeout Capacitor 설정에서

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

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

이전 버전으로 되돌아가기

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

__CAPGO_KEEP_0__ UI

Capgo의 채널을 보는 동안 4번째 탭 (History)에서 롤백 인터페이스를 통해 롤백하는 것이 주된 방법입니다. 이 탭은 채널에 대한 모든 사용 가능한 빌드의 전반적인 시각을 제공하여 이전 버전으로 쉽게 선택하고 되돌아갈 수 있습니다.

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

__CAPGO_KEEP_0__ 대시보드에 로그인하세요. Capgo 대시보드에 접속하세요..
채널 섹션으로 이동하세요.
롤백하려는 채널의 이름을 클릭하세요.
채널 보기에서 4번째 탭 (History)으로 이동하세요.
빌드 히스토리에서 롤백하려는 빌드를 찾으세요.
채널에 대한 빌드로 활성화하세요.
롤백하려는 빌드로 롤백하시겠습니까를 확인하세요.

대안 방법: Crown 아이콘 사용

__CAPGO_KEEP_0__

In the first tab of the channel view, find the build you want to revert to.
Click the crown icon next to that build to make it the active build for the channel.
이 빌드를 원하는 채널로 롤백하시겠습니까?

롤백 후, 업데이트를 확인할 때 업데이트된 채널을 듣는 장치에 이전 빌드가 전달됩니다. 롤백된 빌드는 일반 업데이트와 동일한 흐름과 조건을 따릅니다.

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

Capgo

This is an acceleration path, not a forced fleet command. Delivery remains best-effort and depends on operating-system background scheduling, network availability, and device state. It cannot update an offline or force-quit app, so it cannot promise a fixed time to reach every device.

To request private-preview access or set up this critical path, contact support@capgo.appYou can also read 알림: 무음 업데이트 확인을 활성화하세요.

채널 해제

채널을 잠시 중단하고 문제를 조사하는 동안 업데이트를 중단하고 싶다면 채널을 현재 빌드에서 해제할 수 있습니다.

채널을 해제하려면:

Capgo 대시보드에서 채널을 이동하세요.
현재 빌드 옆에 있는 '해제' 버튼을 클릭하세요.
채널을 해제할 것인지 확인하세요.

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

이 기능은 업데이트에 문제가 있는 것으로 판단했지만 rollback 할 빌드를 결정하지 못했을 때 유용합니다. 채널을 링크 해제하면 업데이트를 푸시하지 않고 조사 시간을 주는 것입니다.

빌트인 번들 강제

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

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

Capgo 데스크톱으로 이동하여 채널을 선택합니다.
"빌트인 번들" 버튼을 클릭합니다.
빌트인 번들을 강제로 적용하시겠습니까?

빌트인 번들을 강제로 적용하면 장치가 현재 빌드에 있는지 관계없이 채널에 구성된 장치들은 다음 업데이트 체크 시 원래 패키징된 웹 빌드로 되돌아갑니다.

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

문제를 감지하고 대응하기

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

다음 전략을 포함합니다:

코호트에 제한된 롤아웃이 아직 진행 중이라면 진보적인 롤아웃 을 사용하여, 전체 채널에 대한 안정적인 번들을 변경하기 전에 노출을 중단하거나 대상자를 지우세요.

업데이트를 출시한 직후에 사용자 피드백과 충돌 보고서를 즉시 모니터링하세요.
작은 그룹에 업데이트를 테스트하기 전에 널리 릴리스하기 전에 단계적인 롤아웃 또는 단계 채널 시스템을 사용하세요.
롤백, 언링크 또는 내장 번들을 강제로 적용할 때의 결정 프로세스를 명확히 하세요. 그리고 이를 수행할 권한이 있는 사람을 결정하세요.
사용자에게 문제와 해결책에 대한 정보를 전달하고, 적절한 경우

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

롤백으로부터 계속

Capgo를 사용하고 있다면 롤백 롤백과 버전 관리를 계획하고 싶다면 버전 목표 버전 목표의 구현 세부 사항에 대한 업데이트 동작 업데이트 동작의 구현 세부 사항에 대한 배포 배포 패키지 내 구현 세부 사항에 대해 Capgo Live Updates Capgo Live Updates의 제품 워크플로에 대해 Capacitor Live Updates의 롤백 전략 Capacitor Live Updates의 롤백 전략의 실제 적용 상황에 대해