Skip to content
Capgo - Capacitor 앱의 실시간 업데이트 Capgo

설정 옵션

Cloud Build 구성 옵션의 모든 완전한 참조입니다. 이 페이지를 사용하여 CLI 플래그, 환경 변수 또는 인증서 키를 찾으십시오.

구성 순위

구성 순위

모든 빌드 옵션은 여러 가지 방법으로 설정할 수 있습니다. 동일한 옵션이 여러 곳에서 설정될 때, 우선순위가 높은 소스에서 우선순위가 낮은 소스에 이길 때:

예시: 저장된 인증서가 SKIP_BUILD_NUMBER_BUMP=true 그러나 __CAPGO_KEEP_0__ 플래그를 전달 --no-skip-build-number-bump CLI에서 CLI flag이 우선되고 빌드 번호는 자동으로 증가합니다.

iOS 옵션

제목 "iOS 옵션"

Code 서명

제목 "Code 서명"
CLI 플래그환경 변수자격 증명 키기본설명
--build-certificate-base64 <cert>BUILD_CERTIFICATE_BASE64BUILD_CERTIFICATE_BASE64—Base64 인코딩 .p12 분산 인증서
--ios-provisioning-profile <map>CAPGO_IOS_PROVISIONING_MAPCAPGO_IOS_PROVISIONING_MAP—확장 프로파일 path 또는 bundleId=path 배포 프로파일을 반복적으로 사용할 수 있습니다. 다중 대상 앱 (앱 + 확장); 프로파일 이름은 자동으로 추출됩니다.
--p12-password <password>P12_PASSWORDP12_PASSWORD—인증서의 암호가 없는 경우 생략 .p12 앱 스토어 연결 인증

앱 스토어 연결 인증

__CAPGO_KEEP_0__ 플래그
CLI환경 변수인증 키기본설명
--apple-key-id <id>APPLE_KEY_IDAPPLE_KEY_ID—앱 스토어 연결 API 키 ID
--apple-issuer-id <id>APPLE_ISSUER_IDAPPLE_ISSUER_ID—앱 스토어 연결 발급자 ID (UUID)
--apple-key-content <content>APPLE_KEY_CONTENTAPPLE_KEY_CONTENT—Base64 인코딩된 앱 스토어 연결 API 키 (.p8 파일)
--app-store-connect-team-id <id>APP_STORE_CONNECT_TEAM_IDAPP_STORE_CONNECT_TEAM_ID—앱 스토어 연결 팀 ID
앱별 비밀번호 인증 (권장되지 않음)
CLI Flag__CAPGO_KEEP_0__ Flag환경 변수인증 키기본
--apple-id <email>FASTLANE_USERFASTLANE_USER—설명
--apple-app-specific-password <password>FASTLANE_APPLE_APPLICATION_SPECIFIC_PASSWORDFASTLANE_APPLE_APPLICATION_SPECIFIC_PASSWORD—앱을 소유한 계정의 Apple ID 이메일xxxx-xxxx-xxxx-xxxx앱별 비밀번호 ( appleid.apple.com
--apple-app-id <id>APPLE_APP_IDAPPLE_APP_ID—숫자 App Store Connect 앱 ID (예:) 1234567890)

iOS 빌드 설정 섹션

__CAPGO_KEEP_0__ Flag
CLI Flag인증 키기본값Default설명
--ios-scheme <scheme>CAPGO_IOS_SCHEMECAPGO_IOS_SCHEMEAppXcode scheme을 빌드하기 위해
--ios-target <target>CAPGO_IOS_TARGETCAPGO_IOS_TARGETAppXcode 빌드 설정을 읽기 위해
--ios-distribution <mode>CAPGO_IOS_DISTRIBUTIONCAPGO_IOS_DISTRIBUTIONapp_store배포 모드: app_store 또는 ad_hoc

Capacitor live-update 대안 비교 페이지

Appflow 비교/이동 마케팅 복사본

Capawesome 비교 페이지

컨설팅 서비스 페이지
CLI FlagAndroid 옵션Android 옵션 섹션 제목입니다.기본 설정설명
--android-keystore-file <keystore>ANDROID_KEYSTORE_FILEANDROID_KEYSTORE_FILE—Base64 인코딩 키 스토어 파일 (.keystore 또는 .jks)
--keystore-key-alias <alias>KEYSTORE_KEY_ALIASKEYSTORE_KEY_ALIASkey0키 스토어 키 별칭
--keystore-key-password <password>KEYSTORE_KEY_PASSWORDKEYSTORE_KEY_PASSWORD—키 스토어 키 비밀번호 (스토어 비밀번호로 자동 대체)
--keystore-store-password <password>KEYSTORE_STORE_PASSWORDKEYSTORE_STORE_PASSWORD—키 스토어 스토어 비밀번호

구글 플레이 구성

구글 플레이 구성
CLI 플래그환경 변수인증 키기본값설명
--play-config-json <json>PLAY_CONFIG_JSONPLAY_CONFIG_JSON—Base64 인코딩 Google Play 서비스 계정 JSON 키
--android-track <track>PLAY_STORE_TRACKPLAY_STORE_TRACKinternal (또는) production 와 --submit-to-store-review)Google Play 릴리스 트랙 (internal, alpha, beta, production). Forwarded from CI env / CLI into the build runner.
--android-release-status <status>PLAY_STORE_RELEASE_STATUSPLAY_STORE_RELEASE_STATUSdraft CI 환경에서 전달 / __CAPGO_KEEP_0__에서 빌드 러너로 전달됨. completed (또는) --submit-to-store-review)와draft, completed, inProgress, halted선택한 트랙에서 릴리스 상태 ( --submit-to-store-review )

안드로이드 빌드 설정

안드로이드 빌드 설정 섹션
CLI 플래그기본설명
--android-flavor <flavor>—빌드할 제품 맛집 (예: production). 필수 프로젝트에서 여러 맛집이 정의되어 있다면.
--android-track <track>internal이 업로드에 사용할 Google Play 트랙입니다. --submit-to-store-review 트랙이 설정되지 않은 경우 Capgo은 Google Play 릴리스 상태로 기본값을 설정합니다. production.
--android-release-status <status>draft트랙이 설정되지 않은 경우 __CAPGO_KEEP_0__은 Google Play 릴리스 상태로 기본값을 설정합니다. --submit-to-store-review 트랙이 설정되지 않은 경우 Capgo은 Google Play 릴리스 상태로 기본값을 설정합니다. completed.
--in-app-update-priority <0–5>—Google Play 내 앱 업데이트 우선순위 (높을수록 더 급합니다.)
--no-playstore-upload—빌드하고 서명하지만 플레이 스토어 업로드를 건너뛰십시오 (이용하려면) --output-upload).

빌드 제어 옵션

빌드 제어 옵션

이 옵션은 iOS와 Android 빌드 모두에 적용됩니다.

빌드 모드

빌드 모드
CLI 플래그기본설명
--platform <platform>—필수입니다. ios 또는 android
--build-mode <mode>releasedebug 또는 release
--path <path>.프로젝트 디렉토리
--verbosefalseVerbose 빌드 로깅 활성화
--ai-analyticsfalse빌드 실패 시 로그를 Capgo AI로 전송하여 진단 — 자세히 보기 AI 빌드 진단

빌드 번호 관리

빌드 번호 관리
CLI 플래그환경 변수인증 키기본설명
--skip-build-number-bumpSKIP_BUILD_NUMBER_BUMPSKIP_BUILD_NUMBER_BUMPfalse자동 빌드 번호/버전 code 증가를 생략합니다.
--no-skip-build-number-bump———자동 증가를 명시적으로 다시 활성화 (저장된 자격 증명을 덮어쓰세요)

Capgo Cloud Build가 기본적으로 빌드 번호를 자동으로 증가시킵니다:

  • iOS: App Store Connect에서 최신 빌드 번호를 가져와 1을 증가시킵니다.
  • Android: Google Play에서 max를 가져와 1을 증가시킵니다. versionCode 설정된 경우, 빌드는 프로젝트 파일 (Xcode 프로젝트 또는

제목: 출력 업로드 --skip-build-number-bump 업로드 build.gradle).

Output Upload

Section titled “Output Upload”
CLI Flag환경 변수인증 키기본값설명
--output-uploadBUILD_OUTPUT_UPLOAD_ENABLEDBUILD_OUTPUT_UPLOAD_ENABLEDfalseCapgo 저장소에 IPA/APK/AAB 빌드 출력을 업로드합니다. 환경 변수를 통해 설정할 경우 사용 BUILD_OUTPUT_UPLOAD_ENABLED=true.
--no-output-uploadBUILD_OUTPUT_UPLOAD_ENABLED——출력 업로드를 비활성화합니다. 환경 변수를 통해 설정할 경우 사용 BUILD_OUTPUT_UPLOAD_ENABLED=false.
--output-retention <duration>BUILD_OUTPUT_RETENTION_SECONDSBUILD_OUTPUT_RETENTION_SECONDS1h다운로드 링크 활성 시간
--output-record <path>———빌드가 성공적으로 완료된 후, JSON 레코드 (작업 ID, 상태, 다운로드 URL, QR code)를 작성합니다. <path> — 환경 변수를 통해 읽어올 수 있습니다. build last-output.

보존 형식: 인간이 읽을 수 있는 시간 형식 사용 1h, 6h, 2d, 7d. 최소 1시간, 최대 7일입니다. 환경 변수를 통해 설정할 경우 초 단위 (예: 1시간)를 사용하세요. 3600 for 1 hour).

빌드 캐시

빌드 캐시

Capgo은 CocoaPods, Gradle 및 관련 빌드 출력과 같은 컴파일된 네이티브 아티팩트를 저장합니다. 앱당 이러한 빌드 캐시를 사용하면 반복 빌드는 더 빠르게 시작됩니다. 빌드 캐시는 기본적으로 각 앱에 대해 활성화되어 있습니다. __CAPGO_KEEP_0__ 플래그

CLI 필드API fieldDefault설명
--no-cachecache_enabled: false캐시 켜기이 빌드에 대한 캐시 비활성화: restore 생략 그리고 저장하지 마세요
--cache-key <value>cache_key(생략)캐시 분할 (예시 prod, staging캐시를 하나만 사용하는 앱에 대해 생략

CLI 동등 항목: build request 받아들입니다 --no-cache 그리고 --cache-key.

CLI 예시:

터미널 창
# Default: restore/save the shared per-app cache
bunx @capgo/cli@latest build request com.example.app --platform android


# Separate caches per environment
bunx @capgo/cli@latest build request com.example.app --platform android \
  --cache-key=prod


bunx @capgo/cli@latest build request com.example.app --platform android \
  --cache-key=staging \
  --android-flavor staging


# One-off clean build (no restore, no save)
bunx @capgo/cli@latest build request com.example.app --platform ios --no-cache

API / 웹후크 페이로드 (당신의 통합이 Capgo 빌드 직접 호출할 때):

{
  "platform": "android",
  "cache_key": "prod"
}

생략 cache_key 공유 일반 캐시를 위해 cache_key 환경에 따라 분할하기. 설정 "cache_enabled": false 단일 요청에 대해 캐시를 비활성화하기 (같은 것) --no-cache).

빌드가 성공적으로 보이지만 artifact가 잘못된 경우 — 또는 Android AAB가 RC vs 프로덕션을 전환한 후 누락된 경우 — 전용 캐시 키 또는 일회용 빌드를 시도하십시오. 자세히 보기 --no-cache 오류 복구: 잘못된 캐시 복원 인증.

제목이 “인증”인 섹션

__CAPGO_KEEP_0__ 플래그
CLI Flag기본설명__CAPGO_KEEP_0__ __CAPGO_KEEP_1__ 인증을 위한 키
-a, --apikey <key>CAPGO_TOKEN—Capgo API key for authentication
--supa-host <host>——개인 호스팅 전용: 사용자 지정 Supabase 호스트
--supa-anon <key>——개인 호스팅 전용: 사용자 지정 Supabase anon 키

환경 변수 빠른 참조

환경 변수 빠른 참조

CI/CD pipeline에 복사-붙여넣기 가능한 환경 변수입니다. 모든 변수는 선택적입니다. 필요할 때만 설정하세요.

iOS

iOS
터미널 창
# Code signing (required for iOS builds)
BUILD_CERTIFICATE_BASE64="<base64-encoded .p12>"
CAPGO_IOS_PROVISIONING_MAP="<provisioning map generated by the CLI>"
P12_PASSWORD="<certificate password>"


# App Store Connect (required for store submission)
APPLE_KEY_ID="ABC1234567"
APPLE_ISSUER_ID="xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
APPLE_KEY_CONTENT="<base64-encoded .p8 key>"
APP_STORE_CONNECT_TEAM_ID="TEAM123456"


# Alternative to the App Store Connect API key above: Apple ID + app-specific
# password (e.g. when migrating from Ionic Appflow). All three are required.
# FASTLANE_USER="apple-id@example.com"
# FASTLANE_APPLE_APPLICATION_SPECIFIC_PASSWORD="xxxx-xxxx-xxxx-xxxx"
# APPLE_APP_ID="1234567890"


# Optional iOS settings
CAPGO_IOS_SCHEME="App"
CAPGO_IOS_TARGET="App"

Android

Android
터미널 창
# Keystore signing (required for Android builds)
ANDROID_KEYSTORE_FILE="<base64-encoded .keystore>"
KEYSTORE_KEY_ALIAS="my-key-alias"
KEYSTORE_KEY_PASSWORD="<key password>"
KEYSTORE_STORE_PASSWORD="<store password>"


# Google Play (required for store submission)
PLAY_CONFIG_JSON="<base64-encoded service account JSON>"


# Optional Android settings
PLAY_STORE_TRACK="internal"
PLAY_STORE_RELEASE_STATUS="draft"

빌드 제어

‘빌드 제어’ 제목
터미널 창
# Build behavior
SKIP_BUILD_NUMBER_BUMP="true"          # Skip auto-increment
BUILD_OUTPUT_UPLOAD_ENABLED="true"     # Upload IPA/APK/AAB
BUILD_OUTPUT_RETENTION_SECONDS="3600"  # 1 hour download link


# Authentication
CAPGO_TOKEN="your-api-key"

인증 정보 저장소

‘인증 정보 저장소’ 제목

지역 저장소에 인증 정보 저장

‘지역 저장소에 인증 정보 저장’ 제목

플래그나 환경 변수를 매번 전달하는 대신, 인증 정보를 한 번 저장하세요:

터미널 창
# Save iOS credentials
bunx @capgo/cli@latest build credentials save \
  --platform ios \
  --certificate ./dist_cert.p12 \
  --ios-provisioning-profile ./profile.mobileprovision \
  --p12-password "cert-password" \
  --apple-key ./AuthKey.p8 \
  --apple-key-id ABC1234567 \
  --apple-issuer-id xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx \
  --apple-team-id TEAM123456


# Save Android credentials
bunx @capgo/cli@latest build credentials save \
  --platform android \
  --keystore ./release.keystore \
  --keystore-alias my-key \
  --keystore-key-password "key-pass" \
  --keystore-store-password "store-pass" \
  --play-config ./play-service-account.json

저장 위치

Storage Locations
기호Flag위치
Location~/.capgo-credentials/credentials.json사용 사례
--local.capgo-credentials.json Use Case(기본)

(default) 전역 — 모든 프로젝트에 공유 Global — shared across all projects on your machine com.example.myapp), 그래서 단일 인증 파일은 여러 앱의 설정을 충돌 없이 저장할 수 있습니다. 각 앱의 인증 정보는 플랫폼 (ios / android).

터미널 창

클립보드에 복사
예시
# List saved credentials
bunx @capgo/cli@latest build credentials list


# Update a specific option without re-entering everything
bunx @capgo/cli@latest build credentials update --skip-build-number-bump


# Clear saved credentials
bunx @capgo/cli@latest build credentials clear --platform ios

제목 '예시'

Manage Saved Credentials

GitHub Actions

GitHub Actions
name: Build and Submit
on:
  push:
    branches: [main]


jobs:
  build-ios:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v6
      - uses: oven-sh/setup-bun@v2
      - run: bun install
      - run: bunx cap sync ios
      - run: bunx @capgo/cli@latest build request --platform ios
        env:
          CAPGO_TOKEN: ${{ secrets.CAPGO_TOKEN }}
          BUILD_CERTIFICATE_BASE64: ${{ secrets.IOS_CERTIFICATE }}
          CAPGO_IOS_PROVISIONING_MAP: ${{ secrets.CAPGO_IOS_PROVISIONING_MAP }}
          P12_PASSWORD: ${{ secrets.P12_PASSWORD }}
          APPLE_KEY_ID: ${{ secrets.APPLE_KEY_ID }}
          APPLE_ISSUER_ID: ${{ secrets.APPLE_ISSUER_ID }}
          APPLE_KEY_CONTENT: ${{ secrets.APPLE_KEY_CONTENT }}
          APP_STORE_CONNECT_TEAM_ID: ${{ secrets.APP_STORE_CONNECT_TEAM_ID }}


  build-android:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v6
      - uses: oven-sh/setup-bun@v2
      - run: bun install
      - run: bunx cap sync android
      - run: bunx @capgo/cli@latest build request --platform android
        env:
          CAPGO_TOKEN: ${{ secrets.CAPGO_TOKEN }}
          ANDROID_KEYSTORE_FILE: ${{ secrets.ANDROID_KEYSTORE }}
          KEYSTORE_KEY_ALIAS: ${{ secrets.KEYSTORE_ALIAS }}
          KEYSTORE_KEY_PASSWORD: ${{ secrets.KEYSTORE_KEY_PASSWORD }}
          KEYSTORE_STORE_PASSWORD: ${{ secrets.KEYSTORE_STORE_PASSWORD }}
          PLAY_CONFIG_JSON: ${{ secrets.PLAY_CONFIG_JSON }}

CLI 플래그 직접 사용

CLI 플래그 직접 사용
터미널 창
# Build iOS with all options inline
bunx @capgo/cli@latest build request \
  --platform ios \
  --build-mode release \
  --skip-build-number-bump \
  --output-retention 6h \
  --apikey YOUR_API_KEY


# Build Android, skip version bump, no output upload
bunx @capgo/cli@latest build request \
  --platform android \
  --skip-build-number-bump \
  --no-output-upload \
  --apikey YOUR_API_KEY

혼합된 설정

혼합된 설정

CLI 오버라이드와 저장된 자격 증명을 결합:

터미널 창
# Save base credentials once
bunx @capgo/cli@latest build credentials save --platform ios \
  --certificate ./cert.p12 \
  --ios-provisioning-profile ./profile.mobileprovision \
  --output-upload


# Override specific options per-build
bunx @capgo/cli@latest build request --platform ios \
  --skip-build-number-bump \
  --output-retention 2d

저장된 인증 정보는 서명 세부 정보를 제공하며 CLI 플래그는 이 특정 빌드 실행에 대한 빌드 동작을 재정의합니다.