Live Updates 없이 Native Build 테스트

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

새로운 Native Build를 테스트할 때는 이전에 다운로드한 live update가 아닌, 해당 바이너리에 포함된 웹 에셋부터 시작되는지 확인해야 합니다. 아래의 방법 중 하나를 사용하거나 조합하여 적용하세요.

1. Native Baseline Version 올리기

설정 CapacitorUpdater.version 네이티브 릴리스에 사용된 버전보다 높게 설정하고, Native Build를 할 때마다 버전을 올려주세요. 새로운 네이티브 베이스라인을 사용하면 설치된 바이너리가 이전 번들과 구분되며, 기본 설정에 따라 resetWhenUpdate: true새로운 네이티브 앱이 설치될 때 다운로드된 번들을 제거합니다.

import type { CapacitorConfig } from '@capacitor/cli';
import pkg from './package.json';

const config: CapacitorConfig = {
  plugins: {
    CapacitorUpdater: {
      // Keep this aligned with, and increase it for, every native build.
      version: pkg.version,
      autoUpdate: 'atBackground',
    },
  },
};

export default config;

For example, a binary built with version: '1.4.1' 기존보다 더 높은 Native Build 기준을 가집니다 1.4.0 번들과 포함된 에셋을 검증해야 할 때는 기존 네이티브 버전을 재사용하지 마세요.

2. 콘솔에서 에뮬레이터 및 개발 빌드 업데이트 차단하기

Capgo 콘솔에서 앱을 열고, 채널빌드에 사용된 채널을 선택한 다음, 정보 탭을 엽니다. 다음 항목을 끄기 둘 다 개발 빌드 허용 및 에뮬레이터 허용.

Allow development build 및 Allow Emulators 설정이 표시된 Capgo channel Information 탭 — 이 설정들은 channel Information 탭에 있습니다. 개발용 빌드와 에뮬레이터가 번들된 웹 에셋을 사용하도록 하려면 강조된 두 설정을 모두 비활성화하세요.

이 채널 정책은 선택한 빌드 유형에 대해서만 업데이트 전달을 차단합니다. 프로덕션 서명이 된 실기기는 채널의 다른 설정에 따라 여전히 업데이트를 받을 수 있습니다.

3. Native CI 빌드에서만 Live Updates 활성화하기

로컬, 에뮬레이터, 개발자 빌드의 안전성을 기본으로 확보하려는 팀은 환경 변수를 통해 Live Updates를 선택적으로 활성화(opt-in)하세요. 아래 설정은 다음 조건이 충족되지 않으면 업데이트 확인을 비활성화합니다: CAPGO_LIVE_UPDATES 이 값이 정확히 다음과 같을 때: true:

import type { CapacitorConfig } from '@capacitor/cli';
import pkg from './package.json';

const liveUpdatesEnabled = process.env.CAPGO_LIVE_UPDATES === 'true';

const config: CapacitorConfig = {
  appId: 'com.example.app',
  appName: 'Example App',
  plugins: {
    CapacitorUpdater: {
      // Bump package.json for every native build.
      version: pkg.version,
      // Local builds are off; native CI explicitly enables live updates.
      autoUpdate: liveUpdatesEnabled ? 'atBackground' : false,
    },
  },
};

export default config;

네이티브 앱을 동기화하고 빌드하는 CI 단계에서만 변수를 설정하세요:

- run: CAPGO_LIVE_UPDATES=true npx cap sync
- run: ./build-native-app.sh

실행 npx cap sync Capacitor가 sync 과정에서 이 설정을 native 프로젝트로 복사하기 때문에, 변수를 설정한 후에는 로컬 빌드 및 에뮬레이터 빌드가 계속 유지되며 autoUpdate: false Live Update를 확인하지 않습니다.

빠른 체크리스트

버전 수치를 높이세요 CapacitorUpdater.version native binary용.
비활성화 development build 허용 및 에뮬레이터 허용 해당 빌드 유형을 테스트할 때 채널에
없이 로컬에서 빌드하기 CAPGO_LIVE_UPDATES.
설정 CAPGO_LIVE_UPDATES=true 오직 ~하기 전에만 npx cap sync Live Update를 받아야 하는 Native Build CI 작업에서.

채널 — 채널 라우팅 및 정책.
업데이트 동작 — 업데이트 확인 및 적용 시점.
버전 타겟팅 — 번들을 Native Build 버전과 호환되도록 유지하세요.