시작하기

설치 단계와 이 플러그인에 대한 전체 마크다운 가이드를 포함한 설정 프롬프트를 복사하십시오.

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

필요한 것

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

Capacitor로 성공적으로 로컬에서 빌드되는 앱이 있습니다
Node.js 20 이상이 설치되어 있습니다
A Capgo 계정 (무료试用도 시작하기에 충분합니다.)
Capgo에 이미 앱이 등록되어 있습니다 (만약 그렇지 않다면) bunx @capgo/cli@latest app add (앱 서명 인증서를 미리 준비할 필요가 없습니다. — 다음 단계에서 설정할 것입니다.)
서명 인증서를 구성하세요

제목 ‘서명 인증서를 구성하세요’

Capgo needs signing credentials to build and submit your app — but you don’t have to wrangle them by hand. Answer a couple of questions and we’ll point you to the exact command to run:

제목 ‘첫 번째 빌드를 실행하세요’

You need to be authenticated with Capgo to build. If you haven’t already:

bunx @capgo/cli@latest login
# or, in CI, set the token directly:
export CAPGO_TOKEN=your_api_key

If you just ran, you’re already set — the onboarding offers to start a build for you at the end, so your first build may already be on its way. 🎉 build initOtherwise, start a build yourself with

— set build request to whichever you’re building: --platform 터미널 창

bunx @capgo/cli@latest build request com.example.app --platform <android|ios> --build-mode debug

The CLI uploads your project, streams the build logs live in your terminal, and — once your credentials are configured — submits the result to the store automatically.

Section titled “Understanding the Build Process”

__CAPGO_KEEP_0__ Cloud Build process flow diagram

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]

지역 준비 - 프로젝트가 압축되어 (제외하고) node_modules 파일 (.dotfile) 포함하지 않음
업로드 - 압축파일이 안전한 클라우드 스토리지 (Cloudflare R2)에 업로드됩니다.
빌드 실행 - 앱이 전용 인프라에서 빌드됩니다.
로그 스트리밍 - 서버 SENT 이벤트를 통해 실시간 로그가 터미널로 스트리밍됩니다.
자동 정리 - 빌드 아티팩트가 삭제됩니다. (안드로이드: 즉시, iOS: 24시간)

빌드되는 것

Capgo Build only 업로드하는 파일은 최소한의 파일만 필요합니다. to compile your native app. Your full source code never leaves your machine.

Your full source __CAPGO_KEEP_0__는

What Gets Uploaded	Section titled “What Gets Uploaded”
`ios/` 포함 `android/`	설명
`package.json`, `package-lock.json`	The native platform 폴더가
`capacitor.config.*`	Dependency manifest 파일입니다. 및 Capacitor 구성
`resources/`	앱 아이콘, 스플래시 화면
자연스러운 플러그인 code	그것만 `ios/` 또는 `android/` 각 Capacitor 플러그인의 서브 폴더

업로드되지 않은 것들

제외	왜
`node_modules/` (대부분의 경우)	자연스러운 플러그인 code만 포함되며, JS 의존성이 포함되지 않습니다
`src/`	웹 소스 code는 로컬에 남아 있습니다
`dist/`, `www/`, `build/` (root level)	로컬 폴더로 자동 Sync되었습니다. `cap sync`
`.git/`	버전 관리 기록
`.gradle/`, `.idea/`, `.swiftpm/`	빌드 캐시 및 IDE 설정
`.env`, 비밀	업로드되지 않음

당신의 책임

실행하기 전에 bunx @capgo/cli@latest build:

웹 자산을 빌드하세요 - 실행 bun run build (또는 프레임워크의 빌드 명령)
자연스럽게 동기화 - 실행 bunx cap sync 웹 자산을 원시 프로젝트로 복사하기 위해
Commit dependencies - 모든 네이티브 플러그인은 package.json

What Capgo Build Handles

iOS 네이티브 컴파일 (Xcode, Fastlane)
Android 네이티브 컴파일 (Gradle)
Code에 대한 인증 정보로 서명
앱 스토어 제출 (설정済)

다음 단계

첫 번째 빌드를 생성한 후:

iOS 빌드 구성 - 인증서 및 프로파일 설정
안드로이드 빌드 구성 - 키스토어 및 Play Store 설정
문제 해결 - 일반적인 문제와 해결책
CLI 참조 - 완전한 명령어 문서

도움을 필요로 합니까?

확인하세요. 문제 해결 가이드
우리와 함께 참여하세요 __CAPGO_KEEP_0__ 커뮤니티
__CAPGO_KEEP_0__으로 이메일 지원 capgo@capgo.app