Capacitor 앱 CI/CD 설정

iOS 및 Android 앱의 빠른 및 오류 없는 릴리스를 원하신다면? CI/CD pipeline Capacitor __CAPGO_KEEP_0__ 앱은 빌드, 테스트 및 배포를 자동화하여 70%까지 릴리스 시간을 단축하고 60%까지 오류를 줄입니다. 이 안내서에서는 환경 설정부터 라이브 업데이트 자동화까지 모든 것을 다룹니다. Capgo.

중요한 점:

__CAPGO_KEEP_0__ 앱에 CI/CD가 중요한 이유: Capacitor apps필수 도구
__CAPGO_KEEP_0__: Xcode, Android Studio, CocoaPodsiOS 및 Android과 더 많은 플랫폼을 지원합니다.
pipeline 설정: 자동화 작업을 수행하는 것과 같은 npx cap sync의존성 캐싱, 플랫폼별 빌드와 같은
Capgo와 함께 라이브 업데이트: phased rollout과 rollback safeguard를 포함한 post-release 업데이트 활성화.

빠른 설정 단계:

: iOS 및 Android용으로 필요한 도구를 설치하십시오.Prepare your environment for iOS and Android development.
프로젝트를 설정하세요: 업데이트 capacitor.config.ts 보안을 위해 환경 변수를 관리하세요.
빌드 PIPELINE: 양쪽 플랫폼에 대해 의존성 설치, 빌드 및 테스트를 자동화하세요.
성능을 최적화하세요: 캐싱, 병렬 빌드 및 조건부 워크플로우를 사용하세요.
실시간 업데이트 추가: Capgo를 사용하여 안전하고 OTA 업데이트와 phased rollouts를 통합하세요.

CI/CD와 함께 Capacitor 앱은 오류 및 수동 개입을 최소화하면서 빠른 및 smoother 릴리스를 달성합니다. 워크플로우를 최적화하기 위해 준비되셨나요? 함께 들어가 보세요!

기존 CI/CD PIPELINE에 모바일 기능을 통합하세요.

CI/CD 환경 준비

CI/CD의 기본을 이해한 후, 다음 단계는 환경 설정입니다. 이는 신뢰할 수 있는 자동화의 근간입니다.

도구 및 소프트웨어 설정

다음 키 도구가 설치되어 있는지 확인하세요:

iOS 개발을 위한:

Xcode 14 이상
Xcode Command Line Tools
CocoaPods 의존성 관리

Android 개발을 위한:

Android Studio
Android SDK 33 이상
Java Development Kit (JDK)

Xcode Command Line Tools을 설치했는지 확인하려면 다음 명령어를 사용하세요.

xcode-select -p

__CAPGO_KEEP_0 Capacitor CAPGO_KEEP_0__ 프로젝트는 CI/CD 워크플로우에 맞게 설정되어야 합니다. 이 설정의 핵심은 다음과 같습니다.

Capacitor

Your Capacitor project needs to be configured correctly for CI/CD workflows. The capacitor.config.ts 환경 변수 설정

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

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

CI/CD pipeline과 환경 설정을 연결하는 데 필요한 변수:

CI/CD pipeline과 환경 설정을 연결하는 데 필요한 변수:

BUILD_ENV: Specifies the deployment stage (e.g., production)
IOS_SIGNING_IDENTITY: code 인증서를 지정합니다.
ANDROID_KEYSTORE_PATH: 안드로이드 키스토어의 경로

안드로이드 빌드에 대해 CI 프로세스 중에 동적으로 생성하는 local.properties 파일:

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 PIPELINE을 만드는 방법

환경이 준비되면, __CAPGO_KEEP_0__ 앱에 대한 CI/CD PIPELINE을 설정하는 것이 다음 단계입니다. Capacitor app__CAPGO_KEEP_0__

설치 및 업데이트 의존성

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 빌드 설정:

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

테스트 및 배포 단계

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 }}

__CAPGO_KEEP_0__

플랫폼	아티팩트 타입	배포 채널
iOS	.ipa	앱 스토어 연결
Android	.aab	구글 플레이 콘솔

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

빌드가 검증되고 패키징이 완료되면 Capgo (다음 섹션에서 설명)에 대한 라이브 업데이트로 넘어가세요.

sbb-itb-f9944d2

__CAPGO_KEEP_0__ Capgo 실시간 업데이트

Capgo 실시간 업데이트 대시보드 인터페이스

Capgo을 워크플로에 통합하면 CI/CD 프로세스를 향상시켜 릴리스 후 업데이트를 가능하게합니다. 설정 방법은 다음과 같습니다.

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_1__ __CAPGO_KEEP_0__

다음으로, 빌드 단계 뒤에 업로드 명령어를 포함하세요:

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

업데이트를 보안 업데이트를, 다음과 같은 유효성 검사 설정을 구성하세요:

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

Capgo 기능 개요

기능	설명
끝-to-끝 암호화	배포 오류를 크게 줄입니다.
채널 기반 배포	특정 환경에 맞춰 업데이트를 제공합니다.
단계별 롤아웃	__CAPGO_KEEP_0__을 점진적으로 배포하여 업데이트를 분산합니다.

__CAPGO_KEEP_1__

배포 후에 다음 주요 지표를 추적하여 테스트 프로세스를 개선하세요.

__CAPGO_KEEP_2__ 전략

업데이트 배포를 제어하여 점진적으로 업데이트를 분산하세요.

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

__CAPGO_KEEP_3__

업데이트를 모니터링하세요.

__CAPGO_KEEP_4__24시간 내에 40-60%를 목표로 하세요.
__CAPGO_KEEP_5__99.5% 이상을 유지하세요.
__CAPGO_KEEP_6__: __CAPGO_KEEP_0__ms.

시스템이 충분히 안정적이지 않다면, 자동 롤백을 수행하세요.

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

pipeline 성능 향상

pipeline 성능 향상을 위해 3 가지 주요 영역에 집중하면 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 성능을 추적하고 향상하는 데 필요한 메트릭들에 대한坚固한 프레임워크를 제공합니다.

__CAPGO_KEEP_0__
__CAPGO_KEEP_1__
__CAPGO_KEEP_2__

다중 환경 설정

다중 환경을 관리하는 것은 환경에 따라 구성을 사용하여 단순화될 수 있습니다. 예를 들어, 다음과 같은 환경 설정을 사용할 수 있습니다.

환경	구성 파일
개발	`.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와의 채널 기반 배포를 조합하면 환경에 따라 정확한 업데이트를 제공할 수 있습니다. 이로 인해 더 부드러운 롤아웃과 다양한 환경에서 애플리케이션 동작에 대한 더 나은 제어를 가능하게 합니다.

요약

CI/CD의 개발 역할

Capacitor 앱을 위한 CI/CD pipeline을 사용하면 워크플로의 효율성이 크게 향상됩니다. 업계 데이터에 따르면 팀은 동시 iOS 및 Android 빌드를 통해 50-70% 빠른 릴리스 사이클 를 달성할 수 있습니다. [3] 의존성 설치 및 플랫폼 동기화와 같은 작업을 자동화함으로써 배포 오류를 40-60% [1][2].

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

이러한 개선은 Capgo와 함께 업데이트 관리를 위한 스트리밍된 업데이트를 가능하게 합니다.

Capgo 업데이트 관리

Capgo는 CI/CD pipeline과 완벽하게 호환되어 앱 스토어 정책에 대한 준수를 유지하면서 즉각적인 업데이트를 제공합니다. 업데이트는 pipeline에 통합된 자동화된 테스트 게이트를 통과한 후에만 배포됩니다.

자동 빌드와 단계적 롤아웃을 combination하면 팀이 놀라운 결과를 달성할 수 있습니다: 7일 이내 80% 사용자 커버리지 1시간 이내 rollback 기능이 가능합니다.

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

FAQs

Capacitor 앱을 생성하는 방법은?

Building a Capacitor app involves a few straightforward steps:

__CAPGO_KEEP_0__ 앱을 빌드하는 데에는 몇 가지 단순한 단계가 필요합니다.: 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
```
: Node.js와 __CAPGO_KEEP_0__를 시스템에 설치한 후, Ionic __CAPGO_KEEP_1__를 사용하여 __CAPGO_KEEP_2__ 지원을 시작하는 새로운 프로젝트를 생성합니다.플랫폼 지원 추가
```
npx cap add ios
npx cap add android
```
Sync your web code웹 code 동기화하기: code
```
npx cap sync
```

The synchronization step is crucial for keeping your app consistent across platforms and ensuring smooth operation in CI/CD pipelines. For more details on setting up your environment, check out the Tools section.

Capacitor 앱을 위한 CI/CD 설정을 계속하세요.

__CAPGO_KEEP_1__을 사용하고 있다면 Capacitor 앱을 위한 CI/CD 설정 CI/CD 자동화 계획을 위해 연결하세요. Capgo CI/CD Capgo 앱을 위한 CI/CD Capgo 네이티브 빌드 Capgo 네이티브 빌드 Capgo 통합 Capgo 통합 CI/CD 통합 CI/CD 통합 구현 세부 사항에 대해, 그리고 GitHub 액션 통합 CI/CD 통합 구현 세부 사항에 대해 GitHub 액션 통합.

Capacitor 앱을 위한 CI/CD 설정