Capacitor CI/CD Pipeline Setup Guide

想要更快的应用程序更新与最少的努力吗？ 为您的 Capacitor 应用程序自动化构建、测试和部署，节省时间并减少错误。您将实现以下内容：

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

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

设置要求

先决条件

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

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

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

将Appflow与您的CICD管道集成

流水线设置步骤

现在您已经处理了必要的前提条件，时刻准备好配置您的管道触发器和环境设置。

构建触发器和步骤

设置您的CI/CD管道以自动触发基于特定分支活动的构建。以下是如何配置它的步骤：

分支触发器:
- 用于生产构建。 main 用于测试目的。
- 用于开发工作。 staging 构建步骤
- __CAPGO_KEEP_0__ feature/* __CAPGO_KEEP_1__
__CAPGO_KEEP_2__:
- 安装所有必要的依赖项。
- 运行单元测试以确保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 }}

Capgo 的关键功能

Capgo 为 Capacitor 应用带来了以下优势：

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

Capgo 计划和定价

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

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

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

Pipeline 管理

状态跟踪

保持对管道的关注是保持应用程序质量和让用户满意的关键。使用您的 CI/CD 平台设置自动警报以监控:

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

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

指南

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

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

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

平台指南

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

测试版: context: Capgo solutions marketing page. Role: Short UI label or navigation item. Seen in: site header, page solutions/beta-testing.astro. Message key `solutions_beta_testing` (Solutions Beta Testing). 向小型用户组发布更新
验证更改。分阶段发布
: 分段发布更新，以早期发现问题。紧急修复

: 如果出现问题，可以快速回滚更新。

概要

To get started, you’ll need to install the CLI, configure builds and environment variables, secure your secrets, enable monitoring, and deploy updates. This process integrates seamlessly with monitoring and rollback tools, ensuring your app stays online with minimal downtime.

CI/CD Benefits

setup 和结果之间的联系展示了如何通过 Capgo 提高效率：更新可以在仅 24 小时内到达 95% 的用户. 另外，Capgo 的定价从 $12/月. 此外，__CAPGO_KEEP_0__ 的定价比传统服务更具成本优势，后者可以收费超过 $500/月. 目前，Capgo 支持超过 1,900 个生产应用 [1].

继续阅读 Capacitor CI/CD Pipeline Setup Guide

如果您正在使用 __CAPGO_KEEP_0__ CI/CD Pipeline Setup Guide Capacitor CI/CD Pipeline Setup Guide 为了计划 CI/CD 自动化，连接它与 Capgo CI/CD 为产品工作流程在 Capgo CI/CD 中 Capgo 原生构建为产品工作流程在 Capgo 原生构建中 Capgo 集成 for the product workflow in Capgo Integrations, 为产品工作流程在 __CAPGO_KEEP_0__ 集成中 CI/CD 集成 GitHub Actions Integration for the implementation detail in GitHub Actions Integration.