Capacitor CI/CD Pipeline Setup Guide

想要更快地应用程序更新以最少的努力? 为您的 Capacitor 应用程序设置CI/CD pipeline可以自动化构建、测试和部署，节省时间并减少错误。以下是您将实现的内容：

实时更新：立即推送更新，无需等待应用商店延迟。95%的用户在24小时内接收更新。
pipeline必备：自动化构建，根据分支活动触发（main, staging, feature/*并定义独立的环境来区分测试和生产。
Capgo 集成: 使用 Capgo 部署安全、加密的更新、管理更新频道和监控性能。经济实惠的计划: 计划从每月 12 美元开始，带有实时更新、分析和约 15 个本地构建/月。
__CAPGO_KEEP_0__ CI/CD pipeline 简化了工作流程、提高了效率，并确保您的应用程序始终保持最新状态。让我们深入了解细节。设置要求

Capacitor CI/CD pipelines simplify workflows, improve efficiency, and ensure your app stays up-to-date seamlessly. Let’s dive into the details.

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

__CAPGO_KEEP_0__

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

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

将Appflow与您的CICD管道集成

管道设置步骤

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

构建触发器和步骤

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

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

- 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/月（1,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 平台来设置自动警报：

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

__CAPGO_KEEP_0__

文档指南

好的文档使您的团队保持一致，运营流畅。确保您的文档涵盖：

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

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

平台指南

遵循Apple和Android更新政策使用Capgo的渠道系统，以确保顺畅和合规的发布：

测试: 将更新发布到小型用户组以验证更改。
阶段性发布: 分阶段发布更新，以早期捕捉问题。
紧急修复: 快速回滚更新仅需单击鼠标，如果出现问题。

概要

设置步骤概览

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

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 原生构建在Capgo 原生构建中为产品工作流程 Capgo 集成在Capgo 集成中为产品工作流程 CI/CD集成 CI/CD 集成的实现细节，以及 GitHub Actions 集成 CI/CD 集成的实现细节，以及 GitHub Actions 集成