시작하기

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

필요한 것

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

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

서명 인증서를 구성하세요

Capgo는 앱을 빌드하고 제출하기 위해 서명 인증서가 필요하지만, 수동으로 관리할 필요는 없습니다. 몇 가지 질문에 답변하고 정확한 명령어를 알려드리겠습니다:

첫 번째 빌드를 실행하세요

Capgo에 인증되어야 빌드를 할 수 있습니다. 만약 이미 인증하지 않았다면:

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

최근에 실행한 경우 build init, 당신은 이미 준비되어 있습니다 — 온보딩은 당신이 시작할 수 있도록 빌드에 대한 제안을 제공하기 때문에, 당신의 첫 번째 빌드는 이미 진행 중일 수 있습니다. 🎉

그렇지 않다면, build request — --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.

The __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. __CAPGO_KEEP_0__ Cloud Build 프로세스 흐름 다이어그램 - 프로젝트는 압축 (제외: node_modules 업로드
2. - zip 파일은 안전한 클라우드 스토리지 (__CAPGO_KEEP_0__ R2)에 업로드됩니다. - The zip is uploaded to secure cloud storage (Cloudflare R2)
3. - 앱은 전용 인프라에서 빌드됩니다. 로그 스트리밍
4. - 서버 전송 이벤트를 통해 실시간 로그가 터미널로 스트리밍됩니다. 자동 정리
5. - 빌드 아티팩트는 삭제됩니다 (안드로이드: 즉시, iOS: 24시간) 빌드되는 것

What Gets Built

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

__CAPGO_KEEP_0__는 절대

Section titled “What Gets Uploaded”	Included
ios/ Description android/	or
package.json, package-lock.json	The native platform 폴더가
capacitor.config.*	Capacitor configuration
resources/	__CAPGO_KEEP_0__ 설정파일입니다. App icons, splash screens
자연스러운 플러그인 code	그것만 ios/ 또는 android/ 각 Capacitor 플러그인의 서브 폴더

업로드되지 않은 것들

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

주의

빌드된 웹 자산 (JS, CSS, HTML) 는 네이티브 폴더에 업로드되지만, 빌드 시 bunx cap sync또는 ios/App/App/public/ or android/app/src/main/assets/public/. 그 이유는 빌드하기 전에 실행해야 하기 때문입니다. cap sync 빌드하기 전에 실행해야 합니다.

당신의 책임

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

1. 웹 자산 빌드하기 - 실행하기 (또는 프레임워크의 빌드 명령) bun run build - 실행하기
2. 웹 자산을 네이티브 프로젝트로 복사하기 - 실행하기 bunx cap sync 의존성을 커밋하기
3. targetLanguage - 모든 네이티브 플러그인은 package.json

What Capgo Build Handles

• 네이티브 iOS 컴파일 (Xcode, Fastlane)
• 네이티브 Android 컴파일 (Gradle)
• Code 인증서와 프로파일을 사용한 인증
• 앱 스토어 제출 (설정된 경우)

다음 단계

이제 첫 번째 빌드를 생성했습니다:

• iOS 빌드 구성 - 인증서와 프로파일을 설정하세요
• Android 빌드 설정 - 키스토어 및 Play Store 설정
• 문제 해결 - 일반적인 문제와 해결책
• CLI 참고 자료 - 완전한 명령어 문서화

도움이 필요합니다.

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