Capacitor CI/CD Pipeline Setup Guide

想要更快的应用程序更新轻松实现? 为您的 Capacitor __CAPGO_KEEP_0__

实时更新: 立即推送更新，无需等待应用商店延迟。95% 的用户在 24 小时内接收更新。
管道必备: 根据 branch 活动 (main, staging, feature/*) 自动触发构建，并为生产和测试环境定义单独的环境。
Capgo 集成: 使用 Capgo 部署安全、加密的更新，并管理更新频道, 监控性能。
经济实惠的计划: 每月 12 美元起的计划，实时更新、分析和每月 15 个原生构建。

Capacitor CI/CD pipeline 简化了工作流程、提高效率，并确保您的应用程序始终保持最新状态。让我们深入了解。

设置要求

前置条件

确保您已安装并配置以下内容:

Node.js 长期支持, Capacitor CLI, 和 Git
在您偏好的CI平台 (例如 GitHub Actions, GitLab CI, 或者 Jenkins)
A Capgo 账户 用于管理实时更新

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

将Appflow与您的CICD管道集成

Pipeline 配置步骤

现在您已经处理了必要的前提条件，接下来是配置管道触发器和环境设置。

构建触发器和步骤

配置 CI/CD pipeline 以自动触发基于特定分支活动的构建。以下是如何配置它：

分支触发器:
- 用于生产构建。 main 用于测试目的。
- 用于开发工作。 staging 构建步骤
- Use __CAPGO_KEEP_0__ for development work. feature/* Use __CAPGO_KEEP_0__ for testing purposes.
Use __CAPGO_KEEP_0__ for production builds.:
- 安装所有必要的依赖项。
- 运行单元测试以确保code质量。
- 为应用程序构建 Web 资产。
- 为移动或桌面平台生成原生二进制文件。
- 将构建部署到测试环境中进行进一步验证。

环境设置

为生产和测试环境定义单独的环境配置文件，以保持组织和安全。以下是一个示例设置：

# 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 平台的密钥管理系统中。这确保了管道保持功能和安全。

Capgo 集成指南

Capgo实时更新控制台界面

一旦您设置了构建和部署阶段，就可以将Capgo集成到应用程序中。这使您能够直接将实时更新推送到应用程序，绕过应用商店审批延迟。

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

Key Features of Capgo

Capgo brings several benefits to Capacitor apps, including:

安全和高效的更新: 加密、差异更新减少了负载大小，同时确保安全传输。
频道管理: 创建测试和生产频道来控制更新的发布方式。
分析仪表板: 跟踪更新成功率并使用详细的见解监控用户采用。

Capgo 计划和定价

Capgo 提供灵活的计划来满足不同需求:

SOLO: $12/月 (10,000 MAU, 2 GB 存储, 50 GB 带宽)
MAKER: $33/月 (10,000 MAU, 5 GB 存储, 500 GB 带宽)
TEAM: $83/月 (100,000 MAU, 10 GB 存储, 2,000 GB 流量)
PAYG: 从 $249/月开始，支持自定义缩放、 API 访问和自定义域名。

目前，Capgo 已经支持超过 1,900 个应用程序的生产环境，使其成为连续部署的可靠选择。 [1].

管道管理

状态跟踪

监控管道对于保持应用程序质量和让用户满意至关重要。使用您的 CI/CD 平台设置自动警报：

构建状态和部署进度
更新成功率
用户采用度指标
错误报告和崩溃日志

将这些警报与清晰的文档结合起来，以确保smooth监控和快速问题解决。

文档指南

好的文档使您的团队保持在同一页面，并且您的运营保持顺畅。确保您的文档涵盖：

管道配置: 构建触发器、环境变量和安全设置等详细信息。
更新程序: 部署步骤、回滚指南和管理更新频道.
监控设置: 如何配置警报、跟踪指标并响应问题。
合规指南: 平台特定的规则、更新限制和其他要求。

将所有文档存储在版本控制中，并在管道更改时更新它。包括常见错误的故障排除步骤，以节省时间，当问题出现时。

平台指南

使用Capgo的频道系统遵循苹果和安卓的更新政策，确保更新顺畅且符合要求：

Beta测试: 将更新发布到小型用户组以验证更改。
分阶段发布: 分段发布更新，以早期捕获问题。
紧急修复: 如果出现问题，可以快速回滚更新。

概要

设置步骤概览

开始之前，您需要安装CLI，配置构建和环境变量，安全您的机密，启用监控，并部署更新。该过程与监控和回滚工具无缝集成，确保您的应用始终在线，降低停机时间。

CI/CD Benefits

Capgo 提高了效率：更新可以在 24 小时内到达 95% 的用户 __CAPGO_KEEP_0__ 的定价从 $12/月开始相比于遗留服务可能高达 $500/月的费用，Capgo 提供了巨大的成本优势 __CAPGO_KEEP_0__ 目前支持超过 1,900 个生产应用作者： 马丁·多纳迪乌. Currently, Capgo supports more than CI/CD Benefits [1].

Capacitor CI/CD管道设置指南