시작하기

설치 단계와 이 플러그인의 전체 마크다운 가이드를 포함한 설정 명령어를 복사하세요.

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

필요한 것

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

Capacitor 앱이 로컬에서 성공적으로 빌드되도록 하세요
Node.js 20 이상이 설치되어야 합니다
Capgo 계정이 필요합니다 (무료试用도 충분합니다)
Capgo에 앱이 이미 등록되어 있는지 확인하세요 (아래 명령어를 실행하세요) npx @capgo/cli@latest app add if not
(이미 서명 인증서를 준비할 필요가 없습니다 — 다음 단계에서 설정할 것입니다.)

서명 인증서를 설정하세요

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

첫 번째 빌드를 실행하세요

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

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

인증이 필요합니다. 이미 인증을 하지 않았다면: build init터미널 창

자신이 직접 빌드를 시작하세요 build request 빌드를 시작하려면: --platform —

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

CLI은 준비된 네이티브 프로젝트를 업로드하고 빌드 로그를 실시간으로 터미널에 스트리밍합니다. Capgo 빌드는 적절한 릴리스 플로우를 구성할 때 서명된 아티팩트를 반환하거나 앱 스토어 커넥트 또는 구글 플레이에 제출할 수 있습니다.

빌드 프로세스 이해

빌드 명령어를 실행하면 다음과 같은 과정이 수행됩니다:

flowchart LR
    A[Your CI] -->|1. Prepare Native Project| B[Prepared iOS / Android Project]
    B -->|2. Upload| C[Capgo Build]
    C -->|3. Compile and Sign| D[Dedicated Build Infrastructure]
    D -->|4. Stream Logs| E[Your Terminal]
    D -->|Return Signed Artifact or Store Delivery| F[Output]
    D -->|5. Clean Temporary Project Data| G[Cleanup]

CI에서 준비 - 웹层 빌드, 개인 의존성 해결, 완료된 자산을 네이티브 프로젝트에 동기화합니다.
업로드 - 준비된 네이티브 프로젝트는 안전한 클라우드 스토리지에 업로드됩니다.
빌드 실행 - Capgo는 전용 인프라에서 네이티브 프로젝트를 컴파일하고 서명합니다.
로그 스트리밍 - 실시간 로그는 Server-Sent Events를 통해 터미널에 스트리밍됩니다.
정리 - 빌드 환경과 임시 프로젝트 데이터는 빌드 후 정리됩니다. 선택한 아티팩트 및 스토어 전달 옵션에 따라 출력 보존이 달라집니다.

Bitrise 또는 다른 CI를 사용하여 Capgo 빌드

Bitrise 또는 다른 CI를 사용하여 Capgo 빌드가 기존 CI를 대체하지 않습니다. Bitrise 또는 다른 CI 시스템에서 필요로 하는 개인 접근 권한이 있는 단계를 유지하세요: 개인 레지스트리에서 설치, SSH를 통해 개인 CocoaPods를 해결, 커스텀 네이티브 설정, 웹 레이어를 빌드, 그리고 npx cap sync.

그 다음 Capgo 빌드를 준비된 네이티브 프로젝트와 호출하세요. Capgo이 준비된 프로젝트를 받고 ios/ 또는 android/ 프로젝트를 컴파일하고 서명하기 위해 필요하지 않기 때문에 __CAPGO_KEEP_0__ 빌드는 개인 Nexus, CocoaPods SSH, 또는 웹 빌드 인증서가 필요하지 않습니다. 컴파일된 웹 자산은 이미 준비된 네이티브 프로젝트 내에 있습니다; 빌드에 사용되며 소스 저장소로 유지되지 않습니다.

빌드되는 것

Capgo 빌드는 컴파일을 위해 필요한 준비된 네이티브 프로젝트를 받습니다. code 웹 소스, 개인 의존성 설치, 그리고 Capacitor 동기화는 CI에서 유지됩니다.

업로드되는 것

포함	설명
`ios/` 또는 `android/`	Capgo에서 사용하는 네이티브 플랫폼 폴더
`package.json`, `package-lock.json`	의존성 매니페스트
`capacitor.config.*`	Capacitor 설정
`resources/`	앱 아이콘, 스플래시 화면
네이티브 플러그인 code	만 해당하는 `ios/` 또는 `android/` 각 Capacitor 플러그인의 하위 폴더

업로드되지 않은 항목

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

당신의 책임

CI에서 준비하기 npx @capgo/cli@latest build request:

- 비트라이즈나 기존 CI에서 개인 패키지 레지스트리, SSH 기반 코코아팟, 장치 SDK, 확장 및 커스텀 네이티브 준비를 해결하세요. 웹 자산 빌드하기
- (또는 프레임워크의 빌드 명령을) 실행하세요. 네이티브 동기화 npm run build Section titled “Your Responsibilities”
Note - 실행 npx cap sync 컴파일된 웹 자산을 준비된 네이티브 프로젝트에 복사하세요.
네이티브 빌드를 요청하세요. - 준비된 ios/ 또는 android/ 프로젝트를 Capgo 빌드합니다.

프로젝트를 Capgo 빌드하세요.

제목: __CAPGO_KEEP_0__ 빌드가 처리하는 내용
iOS 네이티브 컴파일 (Xcode, Fastlane)
Code 사용자 인증서로 서명합니다.
__CAPGO_KEEP_0__ 인증서에 대한 인증서 등록입니다. (인증서 등록을 위해 사용자 인증서를 등록하세요.)
자연스러운 네이티브 빌드 구성 및 자격 증명 값이 환경 변수로 전달됩니다.

Capgo 빌드는 CI가 네이티브 프로젝트를 준비한 후에 개인 Nexus 레지스트리 또는 SSH 자격 증명을 액세스할 필요가 없습니다. 자세한 내용은 빌드 구성 에서 지원되는 환경 변수 및 저장 옵션을 참조하십시오.

MDM를 통해 분배되는 키오스크 플래버를 위해 Android 프로젝트/빌드를 APK를 생성하도록 구성합니다. 빌드를 요청할 때 Google Play를 생략하고 서명된 출력을 받으려면 두 플래그를 모두 사용하십시오:

npx @capgo/cli@latest build request YOUR_APP_ID --platform android --no-playstore-upload --output-upload

--no-playstore-upload 업로드를 막습니다. (even if Play credentials are saved; -> saved Play credentials) --output-upload Play Store 업로드를 방지하기 위해 Play 자격 증명이 저장되어도 됩니다.

다음 단계

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

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