시작하기

Capgo Cloud Build와 함께 시작하여 몇 분 안에 첫 번째 iOS 또는 Android 네이티브 빌드를 생성하세요.

필요한 것

시작하기 전에 다음을 확인하세요:

• Capacitor 앱이 로컬에서 성공적으로 빌드되는지 확인하세요
• Node.js 20 이상이 설치되어야 합니다
• Capgo 계정에 활성 구독이 있는지 확인하세요
• Capgo에 앱이 이미 등록되어 있는지 확인하세요 (아니면) bunx @capgo/cli@latest app add Build 인증 정보가 설정되어 있는지 확인하세요
• (인증서, 키스토어) - 아래 참조 첫 번째 빌드 전에

Section titled “Before Your First Build”

Section titled “Before Your First Build”

__CAPGO_KEEP_0__ __CAPGO_KEEP_1__

__CAPGO_KEEP_2__

__CAPGO_KEEP_3__

1. __CAPGO_KEEP_5__

   __CAPGO_KEEP_6__

   __CAPGO_KEEP_7__

   bunx @capgo/cli@latest build credentials save \
     --platform ios \
     --certificate ./cert.p12 \
     --p12-password "password" \
     --provisioning-profile ./profile.mobileprovision \
     --apple-key ./AuthKey.p8 \
     --apple-key-id "KEY123" \
     --apple-issuer-id "issuer-uuid" \
     --apple-team-id "team-id"

   __CAPGO_KEEP_10__

   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"

   자세한 내용은 전체 인증 정보 안내서 자세한 내용은

2. 로컬 빌드 인증

   먼저 앱이 로컬에서 오류 없이 빌드되는지 확인하세요:

   # Build your web assets
   bun run build
   
   # Sync with Capacitor
   bunx cap sync
   
   # Test local build (optional but recommended)
   bunx cap open ios    # For iOS
   bunx cap open android # For Android

3. Capgo과 인증

   Capgo의 API 키를 설정하세요 (이미 구성된 경우 제외):

   bunx @capgo/cli@latest login

   환경 변수를 설정하세요:

   export CAPGO_TOKEN=your_api_key_here

4. 첫 번째 빌드를 실행하세요

   안드로이드 디버그 빌드를 시작하세요 (테스트를 빠르게):

   bunx @capgo/cli@latest build com.example.app \
     --platform android \
     --build-mode debug

   빌드가 진행되는 동안 실시간 로그를 볼 수 있습니다:

   ✔ Creating build job...
   ✔ Uploading project (15.2 MB)...
   ✔ Build started
   
   📝 Build logs:
   → Installing dependencies...
   → Running Gradle build...
   → Signing APK...
   ✔ Build succeeded in 3m 42s

5. 빌드 상태를 확인하세요

   The CLI will automatically poll and display the build status. Once complete, you’ll see:

   • __CAPGO_KEEP_0__
   • 성공/실패 상태
   • 앱 스토어/플레이 스토어에 제출되었습니다 (인증 정보가 구성된 경우)

빌드 프로세스 이해

빌드 명령어를 실행할 때 발생하는 일

flowchart LR
    A[Your Machine] -->|1. Zip Project| B[Local Temp]
    B -->|2. Upload| C[Capgo Cloud]
    C -->|3. Build| D[Mac Mini Silicon M4 Build Server]
    D -->|4. Logs Stream| A
    D -->|5. Cleanup| E[Auto Delete]

1. 로컬 준비 - 프로젝트가 압축됩니다 (제외하고 점파일) node_modules 업로드
2. - 압축파일이 안전한 클라우드 스토리지 (__CAPGO_KEEP_0__ R2)에 업로드됩니다 - The zip is uploaded to secure cloud storage (Cloudflare R2)
3. 빌드 실행 - __CAPGO_KEEP_0__
4. 로그 스트리밍 - __CAPGO_KEEP_0__
5. 자동 삭제 - __CAPGO_KEEP_0__

빌드 인프라

빌드 실행은 다음 Mac Mini Silicon M4 기기에서 실행됩니다.:

• 10-core M4 CPU (4 성능 코어, 6 효율성 코어)
• 10-core GPU
• 16-core Neural Engine
• 16GB of RAM
• macOS Tahoe 26.2

이 빌드 이미지는 Xcode 26.2, Android Studio 2025 및 .NET 9/.NET 10 SDK 네이티브 빌드 PIPELINE을 지원합니다.

첫 번째 프로덕션 빌드

이 과정을 확인한 후 프로덕션 빌드를 생성하세요.

안드로이드

bunx @capgo/cli@latest build com.example.app \
  --platform android \
  --build-mode release

안드로이드 빌드 구성 iOS.

Android Build Configuration

bunx @capgo/cli@latest build com.example.app \
  --platform ios \
  --build-mode release

iOS 빌드는 서명 인증서와 배포 프로파일이 필요합니다. iOS 빌드 구성.

빌드되는 것

Capgo 빌드에서만 Capgo 업로드 최소한의 파일만 업로드 to compile your native app. Your full source code never leaves your machine.

업로드되는 것

__CAPGO_KEEP_0__ 포함	설명
ios/ 또는 android/	native 플랫폼 폴더
package.json, package-lock.json	의존성 매니페스트
capacitor.config.*	Capacitor 설정
resources/	앱 아이콘, 스플래시 화면
자연 플러그인 code	만 ios/ 또는 android/ 각 Capacitor 플러그인의 sub폴더

업로드되지 않은 것

제외	왜
node_modules/ (대부분)	code라는 네이티브 플러그인만 포함되며, JS 의존성은 포함되지 않습니다.
src/	code라는 웹 소스는 로컬에 유지됩니다.
dist/, www/, build/ (루트 레벨)	__CAPGO_KEEP_0__라는 네이티브 폴더에 이미同步되어 있습니다. cap sync
.git/	버전 관리 기록
.gradle/, .idea/, .swiftpm/	빌드 캐시 및 IDE 설정
.env비밀	업로드되지 않습니다.

주의

빌드한 웹 자산 (JS, CSS, HTML) 은 업로드되지만 bunx cap sync자연 폴더의 일부로 업로드됩니다. 웹 빌드를 빌드할 때 ios/App/App/public/ , android/app/src/main/assets/public/로 복사됩니다. cap sync 그것이 왜

빌드하기 전에

당신의 책임 bunx @capgo/cli@latest build:

1. 웹 자산을 빌드하세요 - 실행 bun run build (또는 프레임워크의 빌드 명령)
2. 자연어로 동기화 - 실행 bunx cap sync 웹 자산을 자연어 프로젝트로 복사
3. 의존성을 커밋하세요 - 모든 자연어 플러그인을 확인하세요 package.json

Capgo 빌드가 처리하는 내용

• 자연어 iOS 컴파일 (Xcode, Fastlane)
• 자연어 안드로이드 컴파일 (Gradle)
• Code Code의 인증 정보로 서명합니다.
• 앱 스토어 제출 (설정된 경우)

구축 시간 및 비용

구축 시간은 시작부터 완료까지 측정됩니다.

• 안드로이드: 일반적으로 3-5분
• iOS: 일반적으로 5-10분
• 인프라: Mac Mini Silicon M4 기기에서 macOS Tahoe 26.2를 실행합니다.

실제 사용한 빌드 시간만 지불합니다. 숨겨진 비용이 없습니다.

일반적인 사용 사례

CI/CD 통합

GitHub 액션 워크플로에 추가하세요:

- uses: oven-sh/setup-bun@v2
  with:
    bun-version: latest

- name: Build native app
  env:
    CAPGO_TOKEN: ${{ secrets.CAPGO_TOKEN }}
  run: |
    bun run build
    bunx cap sync
    bunx @capgo/cli@latest build ${{ secrets.APP_ID }} \
      --platform both \
      --build-mode release

로컬 개발

커밋하기 전에 로컬로 빌드 테스트하세요:

# Quick debug build for testing
bun run build && bunx cap sync
bunx @capgo/cli@latest build com.example.app \
  --platform android \
  --build-mode debug

다중 플랫폼 빌드

두 명령어를 실행하여 양쪽 플랫폼에 빌드합니다:

# iOS build
bunx @capgo/cli@latest build com.example.app \
  --platform ios \
  --build-mode release

# Android build
bunx @capgo/cli@latest build com.example.app \
  --platform android \
  --build-mode release

CI/CD에서 이 명령어를 병렬로 실행하여 빌드 속도를 높일 수 있습니다.

다음 단계

iOS 빌드 구성

• - 인증서 및 프로파일 설정 Android 빌드 구성
• - 키스토어 및 Play Store 설정 다음 단계
• 문제 해결 - 일반적인 문제와 해결 방법
• CLI 참고 자료 - 완전한 명령어 문서화

도움이 필요합니다.

• 확인하세요. 문제 해결 가이드
• 우리 Discord 커뮤니티에 가입하세요. support@__CAPGO_KEEP_0__.app
• email support@capgo.app