메인 콘텐츠로 바로가기
Capgo - Capacitor 앱의 라이브 업데이트 Capgo

__CAPGO_KEEP_6__

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

1. 네이티브 베이스 라인 버전을 업데이트하십시오

제목 ‘1. 네이티브 베이스 라인 버전을 업데이트하십시오’

설정 CapacitorUpdater.version 네이티브 릴리즈에 사용된 버전으로부터 시작하여, 매 네이티브 빌드마다 버전을 증가시키십시오. 새로운 네이티브 베이스 라인은 설치된 바이너리가 이전 버전의 배포와 구별되며, 기본값으로 다운로드된 배포를 제거합니다. resetWhenUpdate: trueWhen testing a new native binary, make sure it starts from the web assets bundled in that binary—not from a previously downloaded live update. Use one or combine the safeguards below.

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 콘솔에서 __CAPGO_KEEP_0__ 앱을 열고,채널 , 사용한 채널을 선택하고, 정보 both 개발 빌드 허용 및 에뮬레이터 허용.

Capgo 채널 정보 탭에서 개발 빌드 허용 및 에뮬레이터 허용 설정을 보여주는 이미지
이 제어 요소들은 채널 정보 탭에 있습니다. 개발 빌드와 에뮬레이터가 웹 자산에 패키징된 채로 유지되도록 하려면 두 설정을 비활성화하세요.

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

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

제목 ‘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

변수를 설정한 후에 실행하십시오. __CAPGO_KEEP_0__이 네이티브 프로젝트를 동기화하는 동안 이 설정을 복사하기 때문입니다. 변수가 없으면 로컬 빌드와 에뮬레이터 빌드는 라이브 업데이트를 체크하지 않습니다. npx cap sync after setting the variable because Capacitor copies this configuration into the native projects during sync. Without the variable, local builds and emulator builds keep autoUpdate: false 버전을 사용하는 것을 증가시킵니다.

네이티브 바이너리

Quick Checklist
  1. Increase the version used by CapacitorUpdater.version for the native binary.
  2. 비활성화 개발 빌드 허용 및 에뮬레이터 허용 채널에서 테스트하는 빌드 유형을 테스트할 때 라이브 업데이트를 받는 원격 CI 작업이 아닌 원본 CI 작업에서만
  3. 채널에서 테스트하는 빌드 유형을 테스트할 때 라이브 업데이트를 받는 원격 CI 작업이 아닌 원본 CI 작업에서만 CAPGO_LIVE_UPDATES.
  4. 채널에서 테스트하는 빌드 유형을 테스트할 때 라이브 업데이트를 받는 원격 CI 작업이 아닌 원본 CI 작업에서만 CAPGO_LIVE_UPDATES=true 채널에서 테스트하는 빌드 유형을 테스트할 때 라이브 업데이트를 받는 원격 CI 작업이 아닌 원본 CI 작업에서만 npx cap sync 관련
채널