도움이 필요하세요
이 플러그인의 설치 단계와 전체 마크다운 가이드를 포함한 설정 명령어를 복사하세요.
Capgo Cloud Build를 사용하여 몇 분 만에 iOS 또는 Android 네이티브 빌드를 생성하세요.
Before you begin, ensure you have:
- A Capacitor 앱이 로컬에서 성공적으로 빌드되는 앱
- Node.js 20 이상이 설치되어야 합니다.
- Capgo 계정이 필요합니다 (무료试用도 시작하기에 충분합니다)
- 앱이 이미 Capgo에 등록되어 있는지 확인하세요 (아래 명령어를 실행하세요)
npx @capgo/cli@latest app addif not) - (이미 서명 인증서를 준비할 필요가 없습니다 — 다음 단계에서 설정할 것입니다.)
서명 인증서를 설정하세요
Section titled “서명 인증서를 설정하세요”Capgo은 앱을 빌드하고 제출하기 위해 서명 인증서가 필요하지만, 수동으로 관리할 필요는 없습니다. 몇 가지 질문에 답변하고, 정확한 명령어를 실행할 수 있도록 가르쳐 드리겠습니다:
첫 번째 빌드를 실행하세요
Run your first buildCapgo에 인증되어야 빌드를 할 수 있습니다. 이미 인증을 하지 않았다면:
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 debugThe 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]
- CI에서 준비 - 웹层를 빌드하고, 개인 의존성을 해결하고, 완료된 자산을 네이티브 프로젝트에 동기화합니다.
- 업로드 - 준비된 네이티브 프로젝트는 안전한 클라우드 스토리지로 업로드됩니다.
- 빌드 실행 - Capgo는 전용 인프라에서 네이티브 프로젝트를 컴파일하고 서명합니다.
- 로그 스트리밍 - 실시간 로그는 Server-Sent Events를 통해 터미널에 스트리밍됩니다.
- 정리 - 빌드 환경과 임시 프로젝트 데이터는 빌드 후에 정리됩니다. 출력 보존은 선택한 아티팩트 및 스토어-배송 옵션에 따라 달라집니다.
Use Capgo Bitrise 또는 다른 CI와 함께 빌드
Bitrise 또는 다른 CI와 함께 Capgo 빌드 사용Capgo 빌드는 기존 CI를 대체하지 않습니다. 비트리스 또는 다른 CI 시스템에서 필요로 하는 개인 접근 권한이 있는 단계를 유지하세요: 개인 레지스트리에서 설치, SSH를 통해 개인 CocoaPods를 해결, 커스텀 네이티브 설정, 웹 레이어를 빌드, 그리고 실행 npx cap sync.
그런 다음 Capgo 빌드에 준비된 네이티브 프로젝트를 호출하세요. Capgo이 준비된 프로젝트를 받습니다. ios/ 또는 android/ Capacitor live-update 대안
Appflow 대안
Capawesome 대안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.
Appflow 플러그인 또는
업로드되는 항목에 대한 섹션 제목| 포함 | 설명 |
|---|---|
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/ (대부분의 것) | 자연 플러그인만 code 포함되어 있으며, JS 의존성은 포함되지 않습니다. |
src/ | 웹 소스 code는 로컬에 유지됩니다. |
dist/, www/, build/ (루트 레벨) | 이미 네이티브 폴더에同步된 버전 제어 기록 cap sync |
.git/ | 빌드 캐시 및 IDE 설정 |
.gradle/, .idea/, .swiftpm/ | , 비밀 |
.env, secrets | 업로드되지 않은 항목 |
빌드하기 전에
CI에서 준비하기- 비트라이즈나 기존 CI에서 npx @capgo/cli@latest build request:
- - 비공개 패키지 레지스트리, SSH 기반 코코아팟, 장치 SDK, 확장 및 사용자 정의 네이티브 준비 - 웹 자산 빌드하기
- - Run
npm run build또는 (또는 framework의 빌드 명령어). - Sync to native - Run
npx cap syncnative 프로젝트에 컴파일된 웹 자산을 복사합니다. - native 빌드를 요청하세요 - 준비된
ios/또는android/project to Capgo Build.
프로젝트를 Capgo Build.
Capgo Build가 처리하는 내용- __CAPGO_KEEP_0__ Build가 처리하는 내용
- iOS native 컴파일 (Xcode, Fastlane)
- Code Code
- App Store Connect 또는 Google Play 제출 (선택)
- 지원되는 네이티브 빌드 구성 및 자격 증명이 환경 변수로 전달되는 값
Capgo __CAPGO_KEEP_0__ 빌드 구성
지원되는 환경 변수 및 저장소 옵션을 참조하십시오.
npx @capgo/cli@latest build request YOUR_APP_ID --platform android --no-playstore-upload --output-upload--no-playstore-upload 클립보드 복사 --output-upload Play Store 업로드를 막아도 Play 자격 증명이 저장되어도.
시간 제한된 signed output의 링크를 제공합니다. MDM를 통해 그 APK를 분배하십시오.
다음 단계첫 번째 빌드를 생성했습니다:
- iOS 빌드 구성 - 인증서 및 프로파일 설정
- Android 빌드 구성 - 키스토어 및 Play Store 설정
- 문제 해결 역할: 제목 / 섹션 제목. 페이지: 지원 정책. 메시지 키 `support_policy_troubleshooting_title` (지원 정책 문제 해결 제목).
- CLI Reference __CAPGO_KEEP_0__ 참조
- 완전한 명령어 문서
도움이 필요하세요?- 체크하기 문제 해결 가이드
- 우리 Discord 커뮤니티에 가입하세요 이메일 지원
- support@__CAPGO_KEEP_0__.app support@capgo.app