__CAPGO_KEEP_1__
Capgo - Live Updates for Capacitor Apps Capgo

시작하기

Get started with Capgo Cloud Build and create your first iOS or Android native build in minutes.

__CAPGO_KEEP_0__ Cloud Build를 사용하여 몇 분 안에 첫 번째 iOS 또는 Android 네이티브 빌드를 시작하세요.

Section titled “What You’ll Need”

Before you begin, ensure you have:

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

서명 인증서를 구성하십시오

Section titled “서명 인증서를 구성하십시오”

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

첫 번째 빌드를 실행하십시오

Run your first build

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.

빌드 프로세스 이해

“빌드 프로세스 이해” 섹션

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

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

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.jsonCapacitor live-update 대안 비교 페이지에서 사용되는 HTML 텍스트 조각
capacitor.config.*Capacitor configuration
resources/Capacitor live-update 대안 비교 페이지에서 사용되는 HTML 텍스트 조각
Native plugin codeCapawesome 비교 페이지에서 사용되는 HTML 텍스트 조각 ios/ 컨설팅 서비스 페이지에서 사용되는 HTML 텍스트 조각 android/ subfolder of each Capacitor plugin

업로드되지 않은 것들

업로드되지 않은 것들
제외왜
node_modules/ (대부분)Only native plugin code is included, not JS dependencies
src/Your web source code stays local
dist/, www/, build/ (루트 레벨)버전 관리 히스토리와 Native 폴더에 동기화 cap sync
.git/버전 관리 히스토리
.gradle/, .idea/, .swiftpm/빌드 캐시 및 IDE 설정
.env, 비밀업로드되지 않았습니다.

준비

준비

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

  1. Bitrise 또는 기존 CI에서 - 개인 패키지 레지스트리, SSH 기반 CocoaPods, 장치 SDK, 확장 및 비트리스트 또는 기존 CI에서 사용하는 모든 커스텀 네이티브 준비를 해결하십시오.
  2. 웹 자산 빌드 - npm run build (또는 프레임워크의 빌드 명령어).
  3. 자연스럽게 동기화 - 실행 npx cap sync 컴파일된 웹 자산을 준비된 네이티브 프로젝트에 복사합니다.
  4. 네이티브 빌드를 요청하세요 - 준비된 프로젝트를 보냅니다. ios/ 또는 android/ 프로젝트를 Capgo 빌드합니다.

Capgo 빌드가 처리하는 내용입니다.

Capgo 빌드가 처리하는 내용입니다.
  • iOS 네이티브 컴파일 (Xcode, Fastlane)
  • 안드로이드 네이티브 컴파일 (Gradle)
  • Code Code
  • App Store Connect 또는 Google Play 제출 (선택)
  • 지원되는 네이티브 빌드 구성 및 자격 증명이 환경 변수로 전달되는 값

Capgo __CAPGO_KEEP_0__ 빌드 구성

지원되는 환경 변수 및 저장소 옵션을 참조하십시오.

MDM를 통해 분배되는 키오스크 버전을 위해, Android 프로젝트/빌드를 APK를 생성하도록 구성하십시오. 빌드 요청 시, Google Play 업로드를 피하고 signed output을 받으려면 두 플래그를 함께 사용하십시오:
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를 분배하십시오. 다음 단계

다음 단계

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

- 일반적인 문제와 해결책

__CAPGO_KEEP_0__ 참조서적입니다. (Capgo 참조서적입니다.)