시작하기

Capgo Cloud Build를 사용하여 몇 분 만에 iOS 또는 Android 네이티브 빌드를 시작하세요.

필요한 것들

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

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

이 단계에서는 서명 인증서를 미리 준비할 필요가 없습니다. 다음 단계에서 설정할 것입니다.

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:

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

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

The CLI uploads the prepared native project and streams build logs live in your terminal. Capgo Build can return a signed artifact or submit it to App Store Connect or Google Play when you configure the appropriate release flow.

빌드 프로세스 이해

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

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 시스템에서 필요로 하는 개인 접근 권한이 있는 단계를 유지하세요: 개인 레지스트리에서 설치, CocoaPods를 SSH를 통해 해결, 커스텀 네이티브 설정, 웹 레이어를 빌드, 그리고 실행 npx cap sync.

그런 다음 Capgo 빌드에 준비된 네이티브 프로젝트를 호출하세요. Capgo은 준비된 프로젝트를 받습니다. ios/ 또는 android/ Bitrise 또는 다른 CI를 사용하여 __CAPGO_KEEP_0__ 빌드는 기존 CI를 대체하지 않습니다. 비트리스 또는 다른 CI 시스템에서 필요로 하는 개인 접근 권한이 있는 단계를 유지하세요: 개인 레지스트리에서 설치, CocoaPods를 SSH를 통해 해결, 커스텀 네이티브 설정, 웹 레이어를 빌드, 그리고 실행

그런 다음 __CAPGO_KEEP_0__ 빌드에 준비된 네이티브 프로젝트를 호출하세요. __CAPGO_KEEP_1__은 준비된 프로젝트를 받습니다.

Capgo Build receives the prepared native project required to compile your app. Your web source code, private dependency installation, and Capacitor sync remain in your CI.

빌드되는 것

포함	설명
ios/ 또는 android/	Capacitor live-update 대안 비교 페이지에서 사용되는 HTML 텍스트 조각
package.json, package-lock.json	Capacitor live-update 대안 비교 페이지에서 사용되는 HTML 텍스트 조각
capacitor.config.*	Capacitor configuration
resources/	Capacitor live-update 대안 비교 페이지에서 사용되는 HTML 텍스트 조각
Native plugin code	Capawesome 비교 페이지에서 사용되는 HTML 텍스트 조각 ios/ 컨설팅 서비스 페이지에서 사용되는 HTML 텍스트 조각 android/ subfolder of each Capacitor plugin

업로드되지 않은 것들

제외된 것들	왜
node_modules/ (대부분의 것)	Only native plugin code is included, not JS dependencies
src/	웹 소스 code는 로컬에 남아 있습니다.
dist/, www/, build/ (루트 레벨)	이미 네이티브 폴더에同步되어 있습니다. cap sync
.git/	버전 관리 기록
.gradle/, .idea/, .swiftpm/	빌드 캐시 및 IDE 설정
.env, 비밀	업로드되지 않았습니다.

주의

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

당신의 책임

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

1. - 비트리스 또는 기존 CI에서 개인 패키지 레지스트리, SSH 기반 코코아팟, 장치 SDK, 확장 및 사용자 지정 네이티브 준비를 해결하십시오. 웹 자산 빌드하기
2. - - Run npm run build (또는 프레임워크의 빌드 명령).
3. Sync to native - Run npx cap sync 컴파일된 웹 자산을 준비된 네이티브 프로젝트에 복사합니다.
4. Request the native build - 준비된 ios/ 또는 android/ 프로젝트를 Capgo Build.

What Capgo Build Handles

• iOS 네이티브 컴파일 (Xcode, Fastlane)
• Android 네이티브 컴파일 (Gradle)
• Code 인증 정보와 함께 서명합니다.
• 선택 사항: 앱 스토어 연결 또는 구글 플레이 제출
• 지원되는 네이티브 빌드 구성 및 환경 변수로 전달되는 자격 증명 값

Capgo 빌드는 CI가 네이티브 프로젝트를 준비한 후에, 네이티브 프로젝트에 대한 접근 권한이 필요하지 않습니다. 자세히 보기 빌드 구성 지원되는 환경 변수 및 저장소 옵션을 참조하십시오.

MDM를 통해 분배되는 키오스크 버전을 위해, 안드로이드 프로젝트/빌드를 APK를 생성하도록 구성하십시오. 빌드를 요청할 때, 구글 플레이 업로드를 피하고 signed output을 받으려면 두 플래그를 함께 사용하십시오:

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

--no-playstore-upload 플레이 스토어 업로드를 막아주며, 시간이 제한된 signed output의 링크를 제공합니다. MDM를 통해 APK를 분배하십시오. --output-upload 다음 단계

역할: Capgo Builder / 네이티브 클라우드 빌드 제품 페이지. 메시지 키: native_build_builder_credit_next (네이티브 빌드 빌더 크레딧 넥스트)

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

• iOS 빌드 구성 - 인증서 및 프로파일 설정
• Android 빌드 구성 - 키스토어 및 Play Store 설정
• 문제 해결 역할: 제목
• 참고: CLI - 완전한 명령어 문서

도움이 필요합니다?

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