네이티브 빌드에 라이브 업데이트가 없는지 테스트합니다.

새로운 네이티브 바이너리를 테스트할 때, 그것이 웹 애셋을 포함한 바이너리에서 시작되도록 보장하세요. — 이전에 다운로드한 라이브 업데이트에서 시작되지 않도록. 다음의 보안 장치를 하나 또는 combination하세요.

1. 네이티브 베이스 라인 버전을 업데이트하세요

설정 CapacitorUpdater.version 자연 빌드에 사용되는 버전에서 시작하여 각 자연 빌드마다 증가시킵니다. 더 최신의 자연 기준은 설치된 바이너리와 이전 버전의 패키지와 구분되며, 기본값으로는 다운로드된 패키지를 더 최신의 자연 앱이 설치될 때 삭제합니다. 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;

예를 들어, version: '1.4.1' 는 더 높은 자연 기준으로 빌드된 바이너리를 가지고 있습니다. 기존 1.4.0 패키지보다 더 높은 자연 기준을 가지고 있습니다. 재사용하지 마세요. 필요한 경우 패키지된 자산을 확인하기 위해 자연 버전을 재사용할 때.

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

Capgo 콘솔에서 앱을 열고, 채널, 채널을 선택한 다음 정보 탭. 켜기 꺼짐 둘 다 개발용 빌드 허용 그리고 Allow Emulators.

채널 정보 탭에 있는 Allow development build 및 Allow Emulators 설정

주의

주의

스크린샷은 설정 위치를 보여주고, 활성화된 토글을 보여줍니다. 개발 빌드나 에뮬레이터가 받지 못하도록 하려면 채널의 두 토글을 모두 꺼주세요.

3. 네이티브 CI 빌드에서만 라이브 업데이트 활성화

개발 팀이 기본적으로 로컬, 에뮬레이터, 개발자 빌드를 안전하게 하려면 라이브 업데이트 옵트인으로 설정할 수 있습니다. 환경 변수를 통해 라이브 업데이트 확인을 비활성화할 수 있습니다. 아래의 설정은 업데이트 확인이 수행되지 않는다는 것을 의미합니다. 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이 네이티브 프로젝트에 동기화되는 구성 파일을 복사합니다. 변수를 설정하지 않으면 로컬 빌드와 에뮬레이터 빌드는 라이브 업데이트 확인을 수행하지 않습니다. autoUpdate: false 빠른 체크리스트

제목: 빠른 체크리스트

1. 버전을 증가시키는 CapacitorUpdater.version 자연적인 바이너리
2. 비활성화 개발 빌드 허용 Live Updates를 사용하지 않고 에뮬레이터 허용 채널에서 테스트할 때
3. 로컬로 빌드하지 않음 CAPGO_LIVE_UPDATES.
4. 설정 CAPGO_LIVE_UPDATES=true CI 작업 npx cap sync 자연적인 CI 작업

전용 CI 작업

• 채널 채널 라우팅 및 정책
• 업데이트 동작 업데이트 확인 및 적용
• 버전 대상 버전 대상