업데이트 동작

Capgo 앱에 대한 업데이트를 릴리스할 때, 사용자들이 업데이트를 받을 수 있도록 빠르게 전달하고 싶지만, 다운로드를 기다리거나 앱을 재시작할 필요 없이 사용자 경험을 방해하지 않도록 원치 않습니다.

Capgo의 업데이트 동작은 업데이트를 빠르게 전달하고 사용자 경험을 최소화하는 균형을 맞추기 위해 설계되었습니다.

기본 업데이트 흐름

기본적으로 Capgo는 앱 업데이트를 어떻게 처리하는지 보여줍니다.

1. 앱을 실행할 때, Capgo 플러그인은 새로운 업데이트가 있는지 확인합니다.

2. 업데이트가 발견되면, 사용자가 현재 앱 버전을 사용하는 동안 배경에서 다운로드됩니다.

3. 다운로드가 완료되면 Capgo 사용자가 앱을 백그라운드에 보낼지 또는 완전히 종료할지 기다립니다.

4. 앱을 다시 시작할 때 사용자는 업데이트된 버전을 실행합니다.

이 흐름은 사용자가 업데이트를 위한 알림이나 다운로드를 기다리지 않고 항상 최신 버전의 앱을 실행할 수 있도록 합니다.

팁

Capgo는 앱이 백그라운드에서 다시 시작될 때 업데이트를 확인하기 때문에 사용자는 앱을 완전히 종료하지 않아도 업데이트를 받을 수 있습니다.

이 방법의 장점은 무엇인가요?

배경 또는 종료 이벤트에서 업데이트를 적용하는 것은 사용자 경험에 몇 가지 주요 이점을 제공합니다.

• 업데이트 알림이나 다운로드를 기다리지 않고 사용자가 중간에 세션을 진행할 수 있습니다.

• 세션 사이에 업데이트가 무방비로 적용되므로 앱을 다시 시작할 때 항상 최신 버전의 앱을 사용할 수 있습니다.

• 활발한 사용자를 방해하지 않고도 자주 업데이트를 제공할 수 있습니다.

__CAPGO_KEEP_0__의 주요 단점은 사용자가 앱을 배경화면으로 보내고 빠르게 앱을 재개하면, 업데이트 중에 수행된 작업이 손실될 수 있다는 것입니다.

이러한 문제를 완화하기 위해 추천하는 방법은 다음과 같습니다.

• 주기적으로 상태를 저장하고 앱이 재개될 때 상태를 부드럽게 복원하는 것입니다.

• 앱 상태의 큰 부분을 수정하는 매우 빈번한 업데이트를 피하는 것입니다.

• Sensitive 흐름 (아래 참조)을 위해 업데이트 동작을 맞춤화하는 것을 고려하는 것입니다.

업데이트가 적용되는 시기를 맞춤화하는 방법

일부 경우에, 업데이트가 적용되는 시기를 더 제어하고 싶을 수 있습니다. 예를 들어, 사용자가 진행 중인 흐름을 완료하기 전에 업데이트를 설치하거나, 서버 측 변경과 앱 업데이트를 동기화하고 싶을 수 있습니다.

Capgo는 setDelay 업데이트가 설치되기 전에 충족해야 하는 조건을 지정할 수 있는

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

await CapacitorUpdater.setMultiDelay({
  delayConditions: [
    {
      kind: 'date',
      value: '2023-06-01T00:00:00.000Z',
    },
    {
      kind: 'background',
      value: '60000',
    },
  ],
});

이 예제에서는 2023년 6월 1일 이후에 업데이트를 설치하고, 앱이 배경화면으로 보내진 후 최소 60초가 지난 경우에만 업데이트를 설치합니다.

The available delay conditions are:

• date: __CAPGO_KEEP_0__까지의 특정 날짜/시간을 기다려 업데이트를 적용합니다.
• background: 앱이 백그라운드에 있을 때 최소 지연 시간이 지난 후 업데이트를 적용합니다.
• nativeVersion: 최소 버전 이상의 네이티브 바이너리가 설치된 후 업데이트를 적용합니다.
• kill: 앱이 종료된 후 다음 업데이트를 적용합니다.

이러한 조건을 혼합하여 업데이트가 설치되는 정확한 시점을 제어할 수 있습니다.

위험

주의 kill 현재 조건은 앱 종료 이벤트 이후 업데이트를 적용합니다. 다른 조건과 달리 백그라운드 이벤트 이후 업데이트를 적용하지 않습니다. 향후 릴리스에서 이 불일치가 수정될 예정입니다.

즉시 업데이트를 적용합니다.

중요한 업데이트 또는 앱의 상태가 매우 단순한 경우, 다운로드가 완료된 즉시 업데이트 적용을 원할 수 있습니다. Capgo은 배경 또는 종료 이벤트를 기다리지 않고 즉시 적용을 지원합니다. autoUpdate Capacitor 구성에서 policy를 사용하여

권장: Delta (매니페스트) 업데이트 사용

즉시 적용 모드 사용 시, 강력히 추천하는 Delta (매니페스트) 업데이트 을 활성화하여 다운로드 시간을 최소화하고 사용자 경험을 향상시키세요. Delta (매니페스트) 업데이트에서는 변경된 파일만 다운로드하여 전체 배포본을 다운로드하는 대신, 즉시 업데이트 적용 시 사용자가 앱을 사용하는 동안 업데이트가 적용되는 경우 특히 중요합니다.

즉시 적용 모드에서 이가 중요한 이유는

• 업데이트 속도: 다운로드 크기가 작아 업데이트가 완료되는 시간이 짧아져 로딩 화면을 보는 시간이 줄어듭니다.
• 더 나은 모바일 경험: 모바일 네트워크 또는 느린 연결을 사용하는 사용자는 오랜 대기 시간을 겪지 않습니다.
• 낮은 대역폭 사용량: 변경된 파일만 다운로드되므로, 당신과 당신의 사용자 모두에게 데이터를 절약합니다.

When autoUpdate is set to "atInstall", "onLaunch", or "always" in your capacitor.config, the CLI detects it. In non-interactive environments it sends Delta (manifest) updates automatically, and in interactive environments it prompts you to confirm before uploading. Legacy directUpdate config is still detected. Use --no-delta to force a full bundle upload.

Delta (manifest) 업데이트를 활성화하려면 간단히 --delta __CAPGO_KEEP_0__을 업로드할 때 플래그를 설정합니다.

npx @capgo/cli@latest bundle upload --delta

__CAPGO_KEEP_0__에서 자세히 알아보기 델타(매니페스트) 업데이트 문서.

autoUpdate __CAPGO_KEEP_0__에서 설정됩니다. JavaScript에서 __CAPGO_KEEP_0__이 아닌 __CAPGO_KEEP_0__에서. capacitor.config.ts file, not in JavaScript code. It supports these values:

• false 또는 'off': 자동 업데이트를 비활성화합니다.
• true 또는 'atBackground' (기본값): 앱이 배경으로 이동할 때 자동으로 다운로드하고 적용합니다.
• 'atInstall': 새로운 설치 또는 네이티브 앱 업데이트 후 즉시 적용하거나, 배경 흐름을 사용하십시오.
• 'onLaunch': 앱 런칭 시 즉시 적용, 런칭 확인 후 배경 흐름 사용
• 'always': Auto Update가 실행될 때마다 즉시 적용
• 'onlyDownload': 다운로드 자동, emit, 및 다음 번들 자동 설정하지 않음 updateAvailable클립보드 복사

import { CapacitorConfig } from '@capacitor/cli';

const config: CapacitorConfig = {
  plugins: {
    CapacitorUpdater: {
      autoUpdate: 'always', // or 'atInstall' for updates only on app install/update
      autoSplashscreen: true,
      keepUrlPathAfterReload: true,
    },
    SplashScreen: {
      launchAutoHide: false, // Required when using instant apply with autoSplashscreen
    },
  },
};

export default config;

중요

: instant apply 모드에서는 앱이 실제로 업데이트를 확인할 때 업데이트를 적용합니다. 기본적으로, 이는 앱 시작 또는 배경에서 재개할 때만 발생합니다. 참고로는 instant apply 모드와 호환되지 않습니다. periodCheckDelay 및

__CAPGO_KEEP_0__ autoUpdate: 'always', Capgo will immediately apply an update as soon as the download completes during an update check, even if the user is actively using the app. Without periodic checking enabled, this means updates will only be applied when the app starts or resumes from background.

__CAPGO_KEEP_0__는 native configuration이기 때문에 JavaScript __CAPGO_KEEP_0__에서 추가적인 처리가 필요합니다. autoUpdate is a native configuration, instant apply modes require some additional handling in your JavaScript code.

자동 적용 모드와 함께

, 사용할 때는 SplashScreen 구성에서 (위에 표시된 것과 같이) 자동으로 숨겨지지 않도록 autoSplashscreen를 설정해야 합니다. 이로써 업데이트가 완료된 후 스플래시 스크린이 자동으로 숨겨지지 않도록 하여 스크린의 숨김을 제어할 수 있습니다. launchAutoHide: false 자동으로 다운로드하는 것만

다운로드 자동화만

If you want Capgo to check and download updates automatically but never apply them automatically, use autoUpdate: 'onlyDownload':

const config: CapacitorConfig = {
  plugins: {
    CapacitorUpdater: {
      autoUpdate: 'onlyDownload',
    },
  },
};

복사하기 updateAvailable __CAPGO_KEEP_0__는 다운로드 된 번들을 후에 앱이 업데이트 호출 또는 업데이트 알림을 표시할 때를 결정할 수 있도록 해줍니다. CapacitorUpdater.set() or show its own update prompt.

자동 스플래시 스크린 관리

instant apply 모드 사용을 더 쉽게 하기 위해 Capgo는 버전 7.6.0부터 제공하는 옵션을 제공합니다. autoSplashscreen Copy to clipboard

const config: CapacitorConfig = {
  plugins: {
    CapacitorUpdater: {
      autoUpdate: 'always', // or 'atInstall'
      autoSplashscreen: true, // Automatically hide splashscreen
      keepUrlPathAfterReload: true,
    },
    SplashScreen: {
      launchAutoHide: false,
    },
  },
};

The plugin automatically hides the splashscreen when an update is applied autoSplashscreen The plugin automatically hides the splashscreen when no update is needed

• 수동으로 업데이트가 적용될 때 스플래시 스크린을 숨기지 않아도 됩니다.
• __CAPGO_KEEP_0__는 다운로드 된 번들을 후에 앱이 업데이트 호출 또는 업데이트 알림을 표시할 때를 결정할 수 있도록 해줍니다.
• __CAPGO_KEEP_0__는 다운로드 된 번들을 후에 앱이 업데이트 호출 또는 업데이트 알림을 표시할 때를 결정할 수 있도록 해줍니다. appReady __CAPGO_KEEP_0__ SplashScreen.hide()

수동 스플래시 스크린 관리

__CAPGO_KEEP_1__ __CAPGO_KEEP_2__ 또는 사용자 정의 로직이 필요하다면, __CAPGO_KEEP_3__ autoSplashscreen __CAPGO_KEEP_4__

import { CapacitorUpdater } from '@capgo/capacitor-updater';
import { SplashScreen } from '@capacitor/splash-screen';

CapacitorUpdater.addListener('appReady', () => {
  // Hide splash screen
  SplashScreen.hide();
});

CapacitorUpdater.notifyAppReady();

__CAPGO_KEEP_6__ appReady __CAPGO_KEEP_7__

__CAPGO_KEEP_8__ appReady __CAPGO_KEEP_9__ keepUrlPathAfterReload __CAPGO_KEEP_10__ true __CAPGO_KEEP_11__

이벤트를 처리하지 않고 appReady __CAPGO_KEEP_0__를 설정하지 않으면 keepUrlPathAfterReload 즉시 적용 모드를 사용할 때 사용자가 앱의 이전 버전을 잠시 보거나 초기 루트로 돌아가거나 업데이트가 적용되는 동안 깜빡임을 보게 될 수 있습니다.

즉시 적용 모드를 사용하면 중요한 버그 수정 또는 보안 패치를 제공할 수 있지만 몇 가지 트레이드 오프가 있습니다:

• 스플래시 스크린을 __CAPGO_KEEP_0__ 또는 수동으로 처리하지 않으면 업데이트가 적용되는 동안 사용자가 짧은 깜빡임이나 로딩 상태를 보게 될 수 있습니다. autoSplashscreen 업데이트가 앱 상태나 UI를 수정하면 사용자가 세션 중간에 갑작스러운 변경을 보게 될 수 있습니다. appReady __CAPGO_KEEP_0__이 설정되지 않으면 사용자의 위치가 앱에서 손실될 수 있으며 그들은 혼란스럽게 될 수 있습니다.
• 즉시 적용을 활성화하려면 상태를 저장하고 복원하는 것을 신중하게 처리하여 smooth한 전환을 보장해야 합니다.
• 즉시 적용을 활성화할 경우 recommends: keepUrlPathAfterReload 즉시 적용 모드를 사용하는 것이 좋습니다.
• 즉시 적용 모드를 사용하는 것이 좋습니다.

즉시 적용 모드를 사용하는 것이 좋습니다.

• __CAPGO_KEEP_0__ autoSplashscreen: true __CAPGO_KEEP_0__를 사용하여 가장 단순한 설정을 사용하거나, 사용자 정의 로직이 필요할 때 이벤트를 수동으로 처리합니다. appReady __CAPGO_KEEP_0__를 설정하여 사용자의 위치를 앱에서 보존합니다.
• 사용자의 진행 상황을 잃지 않도록 앱 상태를 필요에 따라 저장하고 복원합니다. keepUrlPathAfterReload 앱의 업데이트 동작을 철저히 테스트하여 충격적인 전환, 잃어버린 상태, 또는 혼란스러운 위치 변경이 없는지 확인합니다. true 대부분의 경우 기본 업데이트 동작이 업데이트를 빠르게 제공하고 방해를 최소화하는 최적의 균형을 제공합니다. 하지만 특정 요구가 있는 앱의 경우 __CAPGO_KEEP_0__는 업데이트를 언제, 어떻게 적용할 수 있는 유연성을 제공합니다.
• 업데이트 동작에서 계속하기
• 업데이트 동작에서 계속하기

Capgo를 사용하고 있습니다.

__CAPGO_KEEP_0__를 사용하고 있습니다.

__CAPGO_KEEP_0__를 사용하여 가장 단순한 설정을 사용하거나, 사용자 정의 로직이 필요할 때 이벤트를 수동으로 처리합니다. 업데이트 동작 __CAPGO_KEEP_0__에서 실시간 업데이트 전달을 계획하기 위해 연결하세요. Capgo 실시간 업데이트 Capgo 실시간 업데이트에서 제품 워크플로우를 위해. 개요 개요의 구현 세부 정보를 위해. 기능 기능의 구현 세부 정보를 위해. 업데이트 유형 업데이트 유형의 구현 세부 정보를 위해. 시작하기 시작하기의 구현 세부 정보를 위해.