设置 CI/CD 流程来 Capacitor 应用

想让iOS和Android应用的发布速度更快，错误率更低吗? CI/CD管道 Capacitor 应用 Capgo.

__CAPGO_KEEP_0__

• 实时更新的自动化 Capacitor apps为什么CI/CD对
• __CAPGO_KEEP_0__应用重要？：: Xcode, Android Studio, CocoaPods和更多的工具。
• Pipeline设置：自动化任务，如 npx cap sync、依赖缓存和平台特定构建。
• 实时更新：Capgo：在发布后启用分阶段发布和回滚保护。

快速设置步骤：

1. 准备环境：为iOS和Android安装所需工具。
2. 配置您的项目: 更新 capacitor.config.ts 安全地管理环境变量。
3. 构建管道: 为两种平台自动安装依赖项、构建和测试。
4. 优化性能: 使用缓存、并行构建和条件工作流。
5. 添加实时更新: 集成 Capgo 以实现安全的 OTA 更新和分阶段发布。

通过 CI/CD，Capacitor 应用程序实现更快、更Smooth 的发布，同时减少错误和手动干预。准备优化您的工作流程？让我们深入！

将您的现有 CI/CD Pipelines 与移动功能集成

准备您的CI/CD环境

一旦您掌握了CI/CD的基本知识，下一步就是设置您的环境。这是可靠自动化的骨干。

工具和软件设置

确保您安装了这些关键工具:

用于iOS开发:

• Xcode 14或更高版本
• Xcode命令行工具
• CocoaPods 用于管理依赖项

用于Android开发:

• Android Studio
• Android SDK 33或以上
• Java 开发工具包 (JDK)

确认您的 Xcode Command Line Tools 已安装，请使用：

xcode-select -p

创建一个 Capacitor 项目

您的 Capacitor 项目需要正确配置以支持 CI/CD 工作流。这个 capacitor.config.ts 文件是设置的核心：

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

这个文件确保您的项目符合 CI/CD 要求。

设置环境变量

安全地管理凭据是将环境设置与 CI/CD pipeline 链接起来的关键部分。

需要定义的关键变量：

• BUILD_ENV: 指定部署阶段（例如， production)
• IOS_SIGNING_IDENTITY: 你的 code 签名证书
• ANDROID_KEYSTORE_PATH: Android Keystore 的路径

为 Android 构建，动态生成一个 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 pipeline

一旦您的环境准备好，就需要设置一个 CI/CD pipeline 来管理你的 Capacitor 应用。这个 pipeline 应该高效地管理两种类型的资源：Web 资产和本地平台构建

安装和更新依赖项

在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构建配置：

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

对于部署，设置平台特定的工件处理：

正确配置后，使用并行构建可以显著减少管道执行时间。

Once your builds are validated and packaged, you’re ready to move on to live updates with Capgo (discussed in the next section).

sbb-itb-f9944d2

添加 Capgo 实时更新

将 Capgo 集成到您的工作流程中可以增强 CI/CD 流程，通过实时更新功能。以下是如何设置它：

Capgo pipeline 配置

首先，在 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 生命周期可以通过自动化的构建和部署过程来包含 更新管理 功能。

下一步，包含上传命令在您的构建步骤之后：

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

For 安全更新，配置验证设置如下：

{
  "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

改进管道性能

专注于三个关键领域可以显著改善管道：

构建速度优化

对于仅限 web 的更改，使用 npx cap sync 可以通过跳过完整的本机重建来节省时间，减少重建时间约 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"
  }
}

这些实践提供了一个坚实的框架，通过以下指标来跟踪和改进管道性能：

• Build time per stage
• 缓存效率（命中/未命中比率）
• Peak resource usage

多环境设置

管理多个环境可以通过使用环境特定的配置来简化。以下是一个示例设置：

您可以使用此脚本动态配置环境：

- 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在开发中的作用

使用CI/CD管道来提高Capacitor应用的工作流效率。根据行业数据，团队可以实现 50-70%的发布周期加速 通过同时进行iOS和Android构建 [3]。通过自动化任务，如依赖项安装和平台同步，减少了部署错误的发生。 40-60% [1][2].

例如，使用Azure DevOps管道的团队已经自动化了顺序构建步骤和Xcode打包。他们还使用了参数化环境来进行开发和生产。这一方法消除了手动Gradle和XcodeCLI操作的需求，确保了每次都能可靠地创建工件。

这些改进为使用Capgo的更新管理提供了基础。

Capgo用于更新管理

Capgo与CI/CD管道无缝整合，能够即时更新，同时保持与应用商店政策的兼容性。更新只会在通过自动化测试门控的管道中部署。

通过结合自动化构建和分阶段发布，团队实现了令人印象深刻的结果： 在 7 天内实现 80% 的用户覆盖率 在一个小时内实现回滚功能。

常见的策略是并行部署多个跟踪。使用自动化构建进行内部测试，而分阶段发布则针对用户群体。这样可以确保更新既快速又安全，且由严格的自动化测试门控支持 [1].

常见问题

如何创建一个 Capacitor 应用程序？

创建一个 Capacitor 应用程序涉及几个简单的步骤：

1. 设置环境：在系统上安装 Node.js 和 npm，然后使用 Ionic CLI 来启动一个新的项目，支持 Capacitor：

   ionic start myApp tabs --capacitor

2. 添加平台支持：添加要目标的平台，如 iOS 或 Android：

   npx cap add ios
   npx cap add android

3. 同步 web code：确保 web code 与原生平台保持一致，运行：

   npx cap sync

同步步骤对于保持应用程序在各个平台上的一致性以及在CI/CD管道中的平滑运行至关重要。有关设置环境的更多详细信息，请参阅工具部分。

继续设置Capacitor应用程序的CI/CD

如果您正在使用 设置Capacitor应用程序的CI/CD 来规划CI/CD自动化，连接它与 Capgo CI/CD 为Capgo CI/CD中的产品工作流程 Capgo 原生构建 为Capgo 原生构建中的产品工作流程 Capgo 集成 为Capgo 集成中的产品工作流程 CI/CD集成 CI/CD 集成的实现细节 GitHub Actions 集成 for the implementation detail in GitHub Actions Integration.