시작하기

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

필요한 것

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

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

서명 인증서를 구성하세요

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

첫 번째 빌드를 실행하세요

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

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

만약 최근에 build init을 실행했다면, 이미 준비가 되어 있습니다 — 온보딩이 빌드를 시작할 것을 제안하기 때문에, 첫 번째 빌드가 이미 진행 중일 수 있습니다. 🎉

그렇지 않다면 __CAPGO_KEEP_0__을 사용하여 직접 빌드를 시작하세요. build request — 설정 --platform 빌드하고자 하는 것으로 설정:

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

CLI은 준비된 네이티브 프로젝트를 업로드하고 빌드 로그를 실시간으로 터미널에서 스트리밍합니다. Capgo 빌드는 적절한 릴리스 흐름을 구성할 때 signed artifact를 반환하거나 App Store Connect 또는 Google Play로 제출할 수 있습니다.

빌드 프로세스 이해

빌드 명령을 실행할 때 발생하는 일은 다음과 같습니다.

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]

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

Bitrise 또는 다른 CI와 함께 Capgo 빌드를 사용하세요.

Capgo 빌드는 기존 CI를 대체하지 않습니다. 비트리스 또는 다른 CI 시스템에서 개인 접근이 필요한 단계를 유지하세요: 개인 레지스트리에서 설치, SSH를 통해 개인 CocoaPods를 해결, 커스텀 네이티브 설정을 실행, 웹层를 빌드, npx cap sync.

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

What Gets Built

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

What Gets Uploaded

포함	설명
ios/ or android/	빌드 중인 네이티브 플랫폼 폴더
package.json, package-lock.json	의존성 매니페스트
capacitor.config.*	Capacitor 설정
resources/	앱 아이콘, 스플래시 화면
자연스러운 플러그인 code	자연스러운 플러그인만 ios/ 또는 android/ 각 자연스러운 플러그인 Capacitor의 하위 폴더

업로드되지 않은 것들

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

주의

빌드된 웹 자산 (JS, CSS 및 HTML)은 네이티브 프로젝트에 복사된 것만 업로드됩니다. 웹 소스 및 의존성 설치 단계는 CI에서 유지되고, 준비된 네이티브 프로젝트는 바이너리 빌드를 위해 사용되고 나중에 삭제됩니다. npx cap sync 당신의 책임

빌드된 웹 자산 (JS, CSS 및 HTML)은 네이티브 프로젝트에 복사된 것만 업로드됩니다. 웹 소스 및 의존성 설치 단계는 CI에서 유지되고, 준비된 네이티브 프로젝트는 바이너리 빌드를 위해 사용되고 나중에 삭제됩니다.

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

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

제목: Capgo 빌드가 처리하는 일

• Android 네이티브 컴파일 (Gradle)
• __CAPGO_KEEP_0__ 빌드에 사용자 인증 정보로 인증
• Code signing with your credentials
• 네이티브 빌드 구성 및 인증 정보를 환경 변수로 전달하는 지원
• __CAPGO_KEEP_0__ 빌드는 CI가 네이티브 프로젝트를 준비한 후에 사용자 사설 네이티브 레지스트리나 SSH 인증 정보에 접근할 필요가 없습니다. 자세한 내용은

Capgo Build does not need access to your private Nexus registry or SSH credentials once your CI has prepared the native project. See 지원하는 환경 변수 및 저장소 옵션을 참조하세요. or

MDM를 통해 배포되는 키오스크 버전을 위해, Android 프로젝트/빌드를 APK를 생성하도록 구성하십시오. 빌드 요청 시, Google Play를 생략하고 signed 출력을 받기 위해 두 가지 플래그를 사용하십시오:

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

--no-playstore-upload Play Store 업로드를 방지하기 위해, Play 인증 정보가 저장되어 있어도; --output-upload signed 출력에 대한 시간 제한된 링크를 제공합니다. MDM를 통해 그 APK를 배포하십시오.

다음 단계

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

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

도움이 필요합니다.

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