__CAPGO_KEEP_1__

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

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

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

자동 롤백 보호

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

자동 롤백 방법

When a new update is downloaded and applied, Capgo expects your app to call notifyAppReady() __CAPGO_KEEP_0__는 사용자가 업데이트가 성공적으로 로드되었는지 확인하기 위해 호출해야 하는 메서드를 기대합니다.

이 메서드는 업데이트가 성공적으로 로드되었는지 확인합니다.
앱의 핵심 기능이 작동 중입니다.
업데이트는 안전합니다.

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

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

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

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

이 자동 보호 기능은 앱이 비정상적으로 작동하는 경우 사용자가 고장난 앱과 고립되지 않도록 보장합니다.

__CAPGO_KEEP_0__의 타임아웃 설정

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

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

__CAPGO_KEEP_0__의 기본 타임아웃은 일반적으로 10초지만, 앱 초기화 요구 사항에 따라 이 값을 조정할 수 있습니다. 앱이 복잡한 초기화 프로세스를 통해 로드하는 데 더 오래 걸리는 경우 이 값을 증가시키는 것이 좋습니다. appReadyTimeout __CAPGO_KEEP_0__으로 돌아가기

__CAPGO_KEEP_0__으로 돌아가기

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

롤백 UI 인터페이스

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

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

__CAPGO_KEEP_0__ 대시보드에 로그인하세요. Capgo Dashboard.
롤백할 채널 이름을 클릭하세요.
채널 보기에서 4 번째 탭(이력)으로 이동하세요.
빌드 이력을 확인하여 롤백할 빌드를 찾으세요.
선택한 빌드를 채널의 활성 빌드로 설정하세요.
롤백할 빌드로 확인하세요.
대안 방법: Crown 아이콘 사용

__CAPGO_KEEP_0__

__CAPGO_KEEP_1__ 방법으로도, 채널의 빌드 히스토리에 있는 빌드 옆의 왕관 아이콘을 클릭하여 첫 번째 탭에서 직접 롤백할 수 있습니다.

__CAPGO_KEEP_2__ 탭에서 빌드 히스토리에 있는 빌드 중 원하는 빌드를 찾으세요.
__CAPGO_KEEP_3__ 빌드 옆의 왕관 아이콘을 클릭하여 채널의 활성 빌드로 설정하세요.
__CAPGO_KEEP_5__ 롤백할 빌드에 대해 확인하세요.

__CAPGO_KEEP_9__

__CAPGO_KEEP_10__

만약 채널에서 업데이트를 일시적으로 중단하고 문제를 조사하고 싶다면, 현재 빌드와 채널을.unlink할 수 있습니다.

채널을 unlink하는 방법:

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

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

업데이트에 문제가 있는 것으로 판단했지만 아직 rollback할 빌드를 결정하지 못한 경우 유용합니다. 채널을 unlink하면 업데이트를 푸시하지 않고 조사 시간을 주는 것입니다.

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

빌트인 번들을 강제로 채널에 적용하는 방법:

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

Navigate to the channel in the Capgo Dashboard.
Click the “Built-in Bundle” button.
__CAPGO_KEEP_0__를 강제로 빌드할까요?

__CAPGO_KEEP_1__을 강제로 빌드하면 모든 채널에 등록된 기기들은 다음 업데이트를 확인할 때 원래 패키지된 웹 빌드로 돌아갑니다. 이 과정이 현재 빌드에 관계없이 항상 발생합니다.

__CAPGO_KEEP_2__ 빌드에 비해 더 강력한 롤백 옵션입니다. 앱이 마지막으로 앱 스토어에 게시된 이후에 출시된 모든 라이브 업데이트를 버립니다.

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

__CAPGO_KEEP_4__

__CAPGO_KEEP_4__을 즉시 확인하고 사용자 피드백을 받는 것이 중요합니다.

__CAPGO_KEEP_0__ = Built-in Bundle, __CAPGO_KEEP_1__ = Confirm, __CAPGO_KEEP_2__ = original packaged web build, __CAPGO_KEEP_3__ = Be cautious, __CAPGO_KEEP_4__ = Monitoring crash reports and user feedback
작업을 중단하지 않고 업데이트를 테스트하기 위해 phased rollouts 또는 staged channel 시스템을 사용합니다.
업데이트를 되돌리거나 unlink 하거나 built-in bundle을 강제로 적용할 때의 결정 과정을 명확히 하며, 해당 권한을 가진 사람을 지정합니다.
사용자에게 문제와 해결책에 대한 정보를 전달합니다. (필요한 경우)

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

Rollbacks에서 계속하기

이 기능을 사용하고 있다면 Rollbacks 를 사용하여 롤백 계획과 버전 관리를 계획하고, Version Targeting 와 연결하세요. 버전 타겟팅의 구현 세부 사항을 참조하세요. 업데이트 동작 업데이트 동작의 구현 세부 정보에 대해 번들 __CAPGO_KEEP_0__ Live Updates Capgo Live Updates의 제품 워크플로에 대해 Capgo Live Updates의 롤백 전략 Capacitor Live Updates의 롤백 전략의 실제 적용 사례에 대해 for the practical context in Rollback Strategies for Capacitor Live Updates.