Skip to content
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로 이동하여 채널, 사용 중인 채널을 선택하고 정보 탭을 열고 both 개발 빌드 허용 을 both 시뮬레이터 허용.

Capgo 채널 정보 탭에서 Allow development build 및 Allow Emulators 설정을 보입니다.
이 설정은 채널 정보 탭에 있습니다. 두 설정을 모두 비활성화하여 개발 빌드 및 에뮬레이터가 웹 자산에 묶여 있는 것을 유지하세요.

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

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

제목 '3. 네이티브 CI 빌드에서만 라이브 업데이트를 활성화하세요'

개발, 에뮬레이터 및 로컬 빌드를 기본적으로 안전하게 유지하고자 하는 팀은 환경 변수를 통해 라이브 업데이트를 옵트인하도록 하세요. 아래의 config는 업데이트를 확인하지 않는다는 것을 나타냅니다. 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 와

라이브 업데이트 확인을 하지 않는다.

빠른 체크리스트
  1. 빠른 체크리스트 제목 CapacitorUpdater.version 사용 중인 버전을 증가시켜
  2. 네이티브 바이너리에 비활성화 개발 빌드 허용 와 채널에서 테스트하는 빌드 유형에 대해 알림을 받을 때.
  3. 로컬에서 빌드하지 않고 CAPGO_LIVE_UPDATES.
  4. 설정 CAPGO_LIVE_UPDATES=true 라이브 업데이트만 받기 전 npx cap sync 라이브 업데이트만 받을 수 있는 CI 작업
제목이 “관련”인 섹션