Capacitor CI/CD Pipeline 配置指南

想要更快应用更新只需极少的精力？ 为您的应用配置 CI/CD pipeline Capacitor 可以实现构建、测试和部署的自动化，节省时间并减少错误。以下是您将获得的效果：

Capgo Live Updates: 无需等待 App Store 审核，即可即时推送更新。95% 的用户能在 24 小时内收到更新。
Pipeline 核心要素: 根据分支活动自动触发构建 (main, staging, feature/*) 并为 staging 和 production 环境定义独立配置。
Capgo 集成: 使用 Capgo 部署安全且加密的更新，并管理更新通道，并监控性能。
超值方案：方案起步价为 $12/月，包含 Live Update、数据分析以及每月约 15 次 Native Build。

Capacitor CI/CD pipeline 能简化工作流、提升效率，并确保您的应用无缝保持最新。下面我们深入了解一下。

设置要求

前提条件

请确保已安装并配置好以下内容：

Node.js LTS 版本, Capacitor CLI，以及 Git
您首选 CI 平台上的账号（例如 GitHub 操作, GitLab CI，或 Jenkins)
一套 Capgo 账号 用于管理实时更新

准备就绪后，请在您的 CI 平台中定义构建触发器和步骤。

将 Appflow 集成到您的 CICD Pipeline 中

Pipeline 配置步骤

完成前置准备后，接下来需要配置 Pipeline 的触发器和环境设置。

构建触发器与步骤

设置您的 CI/CD pipeline，使其根据特定分支活动自动触发构建。配置方法如下：

分支触发器:
- 使用 main 用于生产环境构建。
- 使用 staging 用于测试目的。
- 使用 feature/* 用于开发工作。
构建步骤:
- 安装所有必要的依赖。
- 运行单元测试以确保 code 的质量。
- 构建应用程序的 Web 资源。
- 为移动端或桌面端平台生成 Native Build。
- 将 build 部署到测试环境以进行进一步验证。

环境设置

为 staging 和 production 分别定义环境配置文件，让配置更有条理、更安全。下面是一个示例配置：

# staging.env
ENVIRONMENT=staging
API_ENDPOINT=https://api-staging.example.com
LIVE_UPDATES_ENABLED=true

# production.env
ENVIRONMENT=production
API_ENDPOINT=https://api.example.com
LIVE_UPDATES_ENABLED=true

对于 API 密钥和证书等敏感数据，请务必安全地存储在 CI 平台的 secrets 管理系统中。这样可确保 pipeline 既能正常工作又安全可靠。

Capgo 集成指南

Capgo Live Update Dashboard 界面

完成 build 和 deploy 阶段的设置后，就可以集成 Capgo 了。这让您可以直接向 App 推送 live updates，绕过 App Store 的审核延迟。

Capgo 配置步骤

准备好 CI/CD pipeline 后，按以下步骤将 Capgo 添加到您的项目中：

首先，安装 Capgo CLI:

npx @capgo/cli init

接下来，请执行以下命令：

构建你的应用: npm install && npm run build
部署更新: npx @capgo/cli deploy
回滚更新: npx @capgo/cli rollback

以下是一个用于部署更新的 GitHub Actions 作业示例：

- name: Deploy to Capgo
  run: |
    npm install @capgo/cli
    npx @capgo/cli deploy
  env:
    CAPGO_TOKEN: ${{ secrets.CAPGO_TOKEN }}

Capgo 的核心特性

Capgo 为 Capacitor 应用带来了诸多优势，包括：

安全高效的更新：通过加密的增量更新减小 Payload 体积，同时确保交付安全。
频道管理: 创建 staging 和 production 通道，以控制更新的发布流程。
数据分析仪表盘: 通过详细的数据洞察，追踪更新成功率并监控用户采用情况。

Capgo 方案与定价

Capgo 提供灵活的方案以满足不同需求：

个人版: $12/月 (1,000 MAU, 2 GB 存储, 50 GB 带宽)
开发者版: $33/月 (10,000 MAU, 5 GB 存储, 500 GB 带宽)
团队版: $83/月 (100,000 MAU, 10 GB 存储, 2,000 GB 带宽)
按需付费起步价为每月 $249，并提供自定义扩展、API 访问权限及自定义域名的多种方案。

目前，Capgo 已支持超过 1,900 款生产环境中的应用，是持续部署的可靠选择。 [1].

Pipeline 管理

状态追踪

密切关注 Pipeline 是保持应用质量和用户满意度的关键。利用您的 CI/CD 平台为以下内容设置自动化告警：

Build 状态与部署进度
更新成功率
用户采用指标
错误报告与 crash logs

将这些告警与清晰的文档相结合，以确保监控顺畅并快速解决问题。

文档指南

完善的文档能确保团队步调一致，并保障业务平稳运行。请确保你的文档涵盖以下内容：

Pipeline 配置：包括 build 触发器、环境变量和安全设置等详细信息。
更新流程：部署步骤、回滚说明以及管理更新通道.
监控设置：如何配置告警、追踪指标并响应问题。
合规指南：特定平台的规则、更新限制及其他要求。

将所有文档纳入版本控制，并在每次 pipeline 变更时更新。包含常见错误的排查步骤，以便在出现问题时节省时间。

平台指南

利用 Capgo 的通道系统遵循 Apple 和 Android 的更新策略，确保发布过程平稳且合规：

Beta 测试: 向小部分用户群体发布更新以验证更改。
分阶段发布: 逐步推送更新，以便及早发现问题。
紧急修复: 如果出现问题，只需点击一下即可快速回滚更新。

总结

配置步骤概览

首先，您需要安装 CLI，配置 build 和环境变量，妥善保管 secrets，启用监控并部署更新。该流程可与监控和回滚工具无缝集成，确保应用保持在线，并将停机时间降到最低。

CI/CD 的优势

配置与结果之间的联系展示了 Capgo 如何提升效率：更新可在 短短 24 小时内覆盖 95% 的用户。此外，Capgo 的价格从 $12/月，相比传统服务具有巨大的成本优势，这些服务收费超过 $500/月。目前，Capgo 已支持超过 1,900 个生产应用 [1].

继续阅读 Capacitor CI/CD Pipeline 设置指南

如果你正在使用 Capacitor CI/CD Pipeline 配置指南 规划 CI/CD 自动化，并将其与 Capgo CI/CD 集成用于 Capgo CI/CD 中的产品工作流， Capgo Native Build 用于 Capgo Native Builds 中的产品工作流， Capgo 集成用于 Capgo 集成中的产品工作流， CI/CD 集成了解 CI/CD 集成的实现细节，以及 GitHub Actions 集成有关 GitHub Actions 集成的实现细节。