Live Updates가 없는 Native 빌드를 테스트하세요

새로운 네이티브 바이너리를 테스트할 때, 그것이 웹 애셋을 포함하는 바이너리에서 시작되어야 하며, 이전에 다운로드 한 라이브 업데이트에서 시작되지 않도록 하십시오. 다음 중 하나 또는 여러 가지를 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. 에뮬레이터 및 개발 빌드 업데이트 차단하기

Open your app in the Capgo console, go to 채널선택한 채널을 선택하고 정보 버튼을 클릭하여 off both 개발 빌드 허용 그리고 에뮬레이터 허용.

채널 정보 탭에서 개발 빌드 허용 및 에뮬레이터 허용 설정을 확인하세요.

주의

스크린샷은 설정 위치를 보여주고, 활성화된 스위치도 보여줍니다. 두 스위치를 모두 끄면 개발 빌드나 에뮬레이터가 업데이트를 받지 못하도록 채널 정책을 설정할 수 있습니다.

이 채널 정책은 선택한 빌드 유형만 업데이트를 차단합니다. 프로덕션으로 서명된 물리적 장치들은 채널의 다른 설정에 따라 업데이트를 받을 수 있습니다.

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

개발자 빌드, 에뮬레이터 빌드, 로컬 빌드 모두 기본적으로 안전하게 하려는 팀은 라이브 업데이트 옵트인으로 설정할 수 있습니다. 환경 변수를 통해 라이브 업데이트 확인을 비활성화할 수 있습니다. 아래의 설정은 라이브 업데이트 확인이 수행되지 않는다는 것을 의미합니다. CAPGO_LIVE_UPDATES is exactly 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 Quick Checklist

사용 중인 버전을 증가시킵니다.

1. Section titled “3. Enable Live Updates Only in Native CI Builds” CapacitorUpdater.version 자연 바이너리용으로.
2. 비활성화 개발 빌드 허용 그리고 에뮬레이터 허용 채널에서 테스트하는 빌드 유형에 대해.
3. 로컬로 빌드하지 않고 CAPGO_LIVE_UPDATES.
4. 설정 CAPGO_LIVE_UPDATES=true 직전 npx cap sync 자연 CI 작업에서 라이브 업데이트를 받을 수 있도록.

관련

• 채널 — 채널 라우팅 및 정책.
• 업데이트 동작 — 업데이트가 확인되고 적용되는 시점.
• 버전 목표 context":"Capgo solutions marketing page. Role: Section or page heading. Seen in: page solutions/version-targeting.astro. Message key `solutions_version_targeting_title` (Solutions Version Targeting Title). | Page/area: Capgo solutions marketing page. Role: Short UI label or navigation item. Seen in: page solutions/version-targeting.astro. Message key `solutions_version_targeting` (Solutions Version Targeting)."