Setting Up CI/CD for Capacitor Apps

iOS 및 Android 앱 릴리스를 더 빠르게, 오류가 없는 상태로 하시려면? CI/CD PIPELINE Capacitor Capacitor 앱을 위한 CI/CD 설정 Capgo.

앱을 자동화하여 빌드, 테스트 및 배포, 70%까지 릴리즈 시간을 단축하고 60%까지 오류를 줄입니다. 이 가이드는 환경 설정부터 라이브 업데이트를 자동화하는 방법까지 모든 것을 다룹니다.

__CAPGO_KEEP_0__ Capacitor appsCapacitor 앱
: 78%까지 빌드 속도를 높이고 60%까지 스토어 거부를 줄입니다.: 필수 도구, Xcode, Android StudioCocoaPods, 그리고 더 많은 것들.
Pipeline 설정: 자동화된 작업들 npx cap sync, 의존성 캐싱 및 플랫폼별 빌드.
Live updates with Capgo: 릴리스 후 업데이트를 위한 단계적 롤아웃 및 롤백 보장 기능을 활성화합니다.

빠른 설정 단계:

환경 준비: iOS 및 Android용 필요한 도구를 설치합니다.
프로젝트 구성: capacitor.config.ts 환경 변수를 안전하게 업데이트
및 관리합니다. CI/CD를 사용하여 __CAPGO_KEEP_0__ 앱을 위한 자동화된 의존성 설치, 빌드 및 테스트를両 플랫폼에 적용합니다.
성능 최적화: 캐싱, 병렬 빌드 및 조건부 워크플로우를 사용하여 성능을 최적화합니다.
실시간 업데이트 추가: Capgo를 사용하여 안전하고 OTA 업데이트를 위한 단계적 롤아웃을 지원합니다.

CI/CD를 사용하면 Capacitor 앱이 더 빠르고 smoother한 릴리즈를 제공하며 오류 및 수동 개입을 최소화합니다. 워크플로우를 최적화하려면 준비가 되셨나요? 시작해 보세요!

CI/CD Pipelines에 모바일 기능을 통합하세요

CI/CD 환경 준비

CI/CD의 기본적인 개념을 이해한 후, 환경 설정을 시작합니다. 이는 신뢰할 수 있는 자동화의 근간입니다.

도구 및 소프트웨어 설정

다음과 같은 주요 도구가 설치되어야 합니다:

For iOS Development:

Xcode 14 or __NEWER__
Xcode Command Line __TOOLS__
CocoaPods for managing __DEPENDENCIES__

For Android Development:

Android Studio
Android SDK 33 or __ABOVE__
Java Development Kit (JDK)

To confirm your Xcode Command Line __TOOLS__ are installed, use:

xcode-select -p

Creating a __CAPGO_KEEP_1__ Capacitor 프로젝트

Capacitor 프레임워크 문서

Capacitor 프로젝트는 CI/CD 워크플로우를 위해 올바르게 구성되어야 합니다. 이 설정의 핵심은 capacitor.config.ts 이 파일은 프로젝트가 CI/CD 요구 사항과 일치하도록 보장합니다.

const config: CapacitorConfig = {
  appId: 'com.example.app',
  webDir: 'build',
  ios: { 
    scheme: 'MyApp'
  }
}

환경 변수 설정

환경 변수를 안전하게 관리하는 것은 CI/CD pipeline과 환경 설정을 연결하는 데 중요한 부분입니다.

정의해야 할 키 변수:

: 배포 단계를 지정합니다 (예:

BUILD_ENV: __CAPGO_KEEP_0__ 서명 인증서 production)
IOS_SIGNING_IDENTITY: Your code signing certificate
ANDROID_KEYSTORE_PATH안드로이드 빌드의 경우 동적으로 키스토어를 생성합니다.

__CAPGO_KEEP_0__ local.properties 파일을 CI 프로세스 중에:

echo "sdk.dir=$ANDROID_SDK_ROOT" > android/local.properties

iOS 빌드와 작업할 때, CI 플랫폼이 macOS agent를 지원하는지 확인하세요.

환경이 준비되었는지 확인하려면:

node --version | grep "v16" && xcodebuild -version | grep "Xcode 14" || exit 1

키 및 자격 증명 관리를 적절하게 하여 앱 스토어 거부의 가능성을 낮추세요. 이에 대한 통계는 이전에 언급되었습니다. [1].

CI/CD PIPE라인 만들기

__CAPGO_KEEP_0__ 앱에 대한 CI/CD PIPE라인을 설정하는 다음 단계입니다. Capacitor이 PIPE라인은 웹 자산과 네이티브 플랫폼 빌드를 효율적으로 관리해야 합니다.

의존성 설치 및 업데이트

CI/CD 환경에서 의존성 관리는 엄격한 버전 관리가 필요합니다. 깨끗한 설치 프로세스를 시작하세요:

npm install --ignore-scripts
npm install @capacitor/cli

빌드 속도를 높이려면 의존성 캐싱을 사용하세요. 예를 들어, Azure DevOps 사용자는 이 설정으로 빌드 시간이 40-60% 향상되었습니다:

- task: Cache@2
  inputs:
    key: 'npm | "$(Agent.OS)" | package-lock.json'
    path: |
      node_modules
      android/.gradle
      ios/Pods

iOS 및 Android 빌드 설정

이것은 iOS 및 Android 플랫폼을 위한 빌드 설정 방법입니다.

iOS 빌드 설정:

steps:
  - task: InstallAppleCertificate@2
    inputs:
      certSecureFile: 'certificate.p12'
      certPwd: $(P12_PASSWORD)
  - script: |
      xcodebuild -workspace ios/App/App.xcworkspace -scheme App -configuration Release -archivePath ios/App/App.xcarchive archive

Android 빌드 설정:

cd android
./gradlew bundleRelease

테스트 및 배포 단계

플랫폼 테스트를 매트릭스 전략을 사용하여 병렬로 실행합니다.

test:
  steps:
    - run: npm run test:unit
    - run: npm run test:e2e
    - name: Run Platform Tests
      matrix:
        platform: [ios, android]
      run: npm run test:${{ matrix.platform }}

배포 시 플랫폼별 아티팩트 처리를 설정합니다.

플랫폼	아티팩트 유형	배포 채널
iOS	iOS	애플 스토어 연결
안드로이드	Android APK	구글 플레이 콘솔

병렬 빌드 설정이 올바르게 구성되면 pipeline 실행 시간을 크게 줄일 수 있습니다.

Capgo (다음 섹션에서 설명하는 것과 같이)으로 빌드가 검증되고 패키징되면 라이브 업데이트로 넘어가세요.

sbb-itb-f9944d2

추가 Capgo 라이브 업데이트를 위해

Capgo 라이브 업데이트스 데스크톱 인터페이스

Capgo

Capgo PIPELINE CONFIGURATION

첫 번째로, pipeline 환경에서 Capgo CLI 을 설치합니다.

steps:
  - name: Install Capgo CLI
    run: npm install -g @capgo/cli
  - name: Configure Authentication
    env:
      CAPGO_KEY: ${{ secrets.CAPGO_API_KEY }}

이 추가로 CI/CD 라이프 사이클을 확장하여 업데이트 관리를 자동화 빌드 및 배포 프로세스에 통합합니다. 다음으로, 빌드 단계 후 업로드 명령을 포함하세요: 업데이트를 위한 보안을 위해, 다음과 같은 유효성 검사 설정을 구성하세요:

__CAPGO_KEEP_0__

- name: Upload Update
  run: |
    capgo upload --api-key $CAPGO_KEY --bundle ./build/app-release.apk
    capgo deploy v${VERSION} --channel production

__CAPGO_KEEP_1__ __CAPGO_KEEP_0____CAPGO_KEEP_1__

{
  "verification": {
    "checksum": "strict",
    "certificatePinning": true,
    "updateTimeout": 500
  }
}

Capgo 기능 개요

기능	설명
전체 암호화	배포 오류를 크게 줄입니다.
채널 기반 배포	특정 환경에 맞춰 업데이트를 조정합니다.
단계별 배포	업데이트를 점진적으로 배포합니다.

OTA 업데이트 지침

배포 후에 다음 주요 지표를 추적하여 테스트 프로세스를 향상하세요:

단계별 배포 전략

업데이트 배포를 제어하는 데 사용하는 스테이지 롤아웃을 사용하십시오:

- name: Staged Rollout
  run: |
    capgo deploy v1.2.3 --group "beta-users" --rollout 10%
    capgo deploy v1.2.3 --rollout 50%

업데이트 모니터링

이러한 지표를 주시하십시오:

수용률: 첫 24시간 내에 40-60%를 목표로 하십시오.
오류 없는 세션: 99.5% 이상 유지하십시오.
인증 시간: 500ms 이하로 유지하십시오.

오류가 허용 가능한 수준을 초과하면 롤백을 자동화하십시오:

- name: Rollback Check
  run: |
    if [ $(capgo stats --version v1.2.3 --metric crashes) -gt 2 ]; then
      capgo rollback --channel production
    fi

pipeline 성능 향상

pipeline 성능 향상에 기여하는 세 가지 주요 영역에 집중하면 pipeline 성능이 눈에 띄게 향상될 수 있습니다:

속도 최적화

웹 전용 변경 사항의 경우, npx cap sync 전체 네이티브 재빌드 Skip을 통해 시간을 절약할 수 있으며, 재빌드 시간이 약 40% 감소할 수 있습니다. 이 방법을 사용하여 조건부 빌드를 구현하는 방법은 다음과 같습니다.

- name: Build Strategy
  run: |
    [ "$WEB_ONLY" = true ] && npx cap sync || (./gradlew assembleRelease && xcodebuild ...)

이 방법은 필요하지 않은 구성 요소만 재빌드하도록 하여 프로세스를 단순화합니다.

버전 관리 자동화

버전 및 빌드 번호를 동적으로 설정하기 위해 다음 스크립트를 사용하여 버전 관리를 자동화할 수 있습니다.

- name: Set Version
  run: |
    VERSION=$(node -p "require('./package.json').version")
    BUILD_NUMBER=$GITHUB_RUN_NUMBER
    echo "APP_VERSION=${VERSION}" >> $GITHUB_ENV
    echo "BUILD_ID=${BUILD_NUMBER}" >> $GITHUB_ENV

또한 이 구성으로 자동화된 의미론적 버전 관리를 설정할 수 있습니다.

{
  "scripts": {
    "version": "standard-version",
    "build:prod": "npm version patch && ionic build --prod"
  }
}

이러한 방법은_PIPELINE 성능을 추적하고 개선하기 위한 지표인 다음과 같은 것들을 제공합니다.

빌드 시간
캐시 효율성 (Hit/miss 비율)
Peak 리소스 사용량

다중 환경 설정

다중 환경을 관리하는 것은 환경별로 구분된 설정을 사용하여 단순화할 수 있습니다. 예를 들어, 다음과 같은 설정을 사용할 수 있습니다:

환경	설정 파일
개발	`.env.dev`
스테이징	`.env.staging`
운영	보안 보관함

이 스크립트를 사용하여 환경을 동적으로 구성할 수 있습니다:

- name: Configure Environment
  env:
    API_KEY: ${{ secrets.ENV_SPECIFIC_API_KEY }}
    BUNDLE_ID: ${{ parameters.bundleId }}
  run: |
    echo "ENVIRONMENT=${{ parameters.environment }}" >> $GITHUB_ENV
    echo "API_ENDPOINT=${{ parameters.apiUrl }}" >> $GITHUB_ENV

이 설정을 Capgo의 채널 기반 배포와 pair하면 환경별로 정확한 업데이트를 제공하고, 더 나은 애플리케이션 동작을 위해 smoother 롤아웃을 제공할 수 있습니다.

요약

개발의 역할

Capacitor 앱을 위한 CI/CD pipeline을 사용하면 workflow의 효율성이 크게 향상됩니다. 업계 데이터에 따르면, 팀은 50-70% 빠른 릴리스 주기 iOS와 Android 빌드가 동시에 진행되기 때문에 [3]. 의존성 설치 및 플랫폼 동기화와 같은 작업을 자동화하면 배포 오류를 줄일 수 있습니다. 40-60% [1][2].

예를 들어, Azure DevOps pipeline을 사용하는 팀은 순차적인 빌드 단계와 Xcode 패키징과 같은 자동화된 프로세스를 사용합니다. 또한 개발 및 프로덕션 환경에 대한 매개 변수화된 환경을 사용합니다. 이 접근 방식은 Gradle 및 Xcode CLI 작업의 수동 작업이 필요하지 않도록 하여, 매번 신뢰할 수 있는 아티팩트 생성을 보장합니다.

These improvements lay the groundwork for streamlined update management when paired with Capgo.

Capgo for Update Management

Capgo works seamlessly with CI/CD pipelines to deliver instant updates while staying compliant with app store policies. Updates are only deployed after passing automated testing gates built into the pipeline.

자동화된 빌드와 phased rollouts를结合하면 팀이 다음과 같은 놀라운 결과를 달성할 수 있습니다: 7일 이내에 80%의 사용자 커버리지 1시간 이내의 롤백 기능

병렬 배포 트랙을 실행하는 일반적인 전략을 사용합니다. 자동화된 빌드는 내부 테스트를 위해 사용되며, phased rollouts는 사용자 세그먼트를 대상으로합니다. 이로써 업데이트는 빠르고 안전하며, 엄격한 자동화된 테스트 게이트에 의해 뒷받침됩니다. [1].

FAQ

How to create a Capacitor app?

Building a Capacitor app involves a few straightforward steps:

환경 설정: Install Node.js and npm on your system. Then, use the Ionic CLI to start a new project with Capacitor support:
```
ionic start myApp tabs --capacitor
```
플랫폼 지원 추가: iOS 또는 Android과 같은 목표 플랫폼을 추가하세요.
```
npx cap add ios
npx cap add android
```
Sync your web code: Ensure your web code is aligned with the native platforms by running:
```
npx cap sync
```

동기화 단계는 플랫폼 간 일관성을 유지하고 CI/CD PIPELINE에서 smooth한 작동을 보장하기 위해 중요합니다. 환경 설정에 대한 자세한 내용은 Tools 섹션을 참조하세요.

Keep going from Setting Up CI/CD for Capacitor Apps

Capgo 앱을 위한 CI/CD 설정 Setting Up CI/CD for Capacitor Apps CI/CD 자동화 계획을 세우기 위해 연결하세요. Capgo CI/CD Capgo CI/CD를 위한 제품 워크플로우 Capgo 네이티브 빌드 Capgo 네이티브 빌드를 위한 제품 워크플로우 Capgo 통합 Capgo 통합을 위한 제품 워크플로우 CI/CD 통합 CI/CD 통합을 위한 구현 세부 정보 GitHub 액션 통합 GitHub 액션 통합을 위한 구현 세부 정보