본문으로 건너뛰기
Capgo - Capacitor 앱의 라이브 업데이트 Capgo

네이티브 빌드에 라이브 업데이트를 사용하지 않고 테스트

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

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

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. 에뮬레이터 및 개발 빌드 업데이트를 콘솔에서 차단하세요

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

Capgo 콘솔에서 앱을 열고, 채널, 채널을 선택한 다음 정보 탭. 켜기 끄기 둘 다 개발용 빌드 허용 그리고 에뮬레이터 허용.

Capgo 채널 정보 탭에서 개발용 빌드 허용 및 에뮬레이터 허용 설정
이 설정은 채널 정보 탭에 있습니다. 둘 다의 설정을 비활성화하여 개발 빌드 및 에뮬레이터가 웹 자산에 포함된 채널에서 업데이트를 받지 않도록 합니다.

이 채널 정책은 선택한 빌드 유형만 업데이트를 배포하는 것을 차단합니다. 물리적 장치에 생산자 인증서가 있는 채널은 다른 설정에 따라 업데이트를 받을 수 있습니다.

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

제목: 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 빠른 체크리스트

제목: 빠른 체크리스트

3. 네이티브 CI 빌드에서만 라이브 업데이트 활성화
  1. 최신 버전을 사용하세요. CapacitorUpdater.version 자연적인 바이너리용으로
  2. 비활성화 개발 빌드를 허용 그리고 에뮬레이터를 허용 채널에서 테스트할 때 빌드 유형
  3. 로컬에서 빌드하지 않기 CAPGO_LIVE_UPDATES.
  4. 설정 CAPGO_LIVE_UPDATES=true 직접만들기 npx cap sync 직접만들기 전
관련된 섹션