Capgo 并且 GitHub GitHub Actions 共同简化应用更新的部署。 Capacitor 集成 __CAPGO_KEEP_0__ Actions
- 节省资金: 将 CI/CD 成本节省至 5 年内最高 $26,100, 相比于 AppFlow.
- 快速更新: 即刻推送更新, 95% 的用户在 24 小时内收到更新。
- 安全部署: 全程加密确保更新安全。
- 流程化工作流: 在您的 GitHub 仓库直接自动化构建和部署。
快速概览
- 需求: GitHub 账户, Capgo 账户 （每月 $12 起），Capacitor 项目， Node.js.
- 设置： 安装 Capgo CLI 与
npx @capgo/cli init，配置 GitHub Actions 使用 YAML 工作流。 - 部署： 使用命令
npx @capgo/cli deploy来 自动化更新. - 测试: 在测试频道（如beta，staging）发布应用之前，测试生产环境。
示例工作流程（YAML):
name: Capgo Deploy
on:
push:
branches:
- main
jobs:
deploy:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v6
- uses: actions/setup-node@v3
with:
node-version: '24'
- name: Install Dependencies
run: npm install
- name: Deploy to Capgo
run: npx @capgo/cli deploy
env:
CAPGO_TOKEN: ${{ secrets.CAPGO_TOKEN }} 此集成确保快速、安全和成本有效的应用程序更新，使其成为适合敏捷开发团队的理想选择。
GitHub GitHub Actions 教程 - 基本概念和CI/CD管道
设置要求
集成Capgo 与GitHub Actions集成涉及设置必要的工具和配置。
所需工具和帐户
确保您已准备好以下帐户和工具：
| 需求 | 目的 | Details |
|---|---|---|
| GitHub 账户 | __CAPGO_KEEP_0__ 账户 | 版本控制 & CI/CD |
| Capgo 账户 | __CAPGO_KEEP_0__ 账户 | 管理实时更新 |
| Capacitor 项目 | __CAPGO_KEEP_0__ 项目 | 应用开发 |
| Node.js | 运行环境 | 推荐使用最新的LTS版本 |
一旦这些准备就绪，您可以继续将Capgo添加到您的项目中，实现自动化的实时更新。
添加 Capgo 将__CAPGO_KEEP_0__添加到您的项目中
在集成Capgo时，需要在您的Capacitor项目中使用其CLI工具安装它。根据马丁·多纳迪厄（Martin Donadieu）的话，他是Capgo的创始人：
“使用 npx 运行 @capgo/cli init” [1]
将__CAPGO_KEEP_0__集成到您的项目中
将GitHub集成到您的项目中，使用其__CAPGO_KEEP_1__工具。根据Martin Donadieu的说法，__CAPGO_KEEP_3__的创始人：
准备您的GitHub仓库以满足与Capgo集成的CI/CD要求。
在添加工作流之前，请确认仓库具有所需的机密、 branch 保护和部署触发器，以支持您的 OTA 发布过程。
定价
- Capgo 计划从每月 12 美元起价。
- 该计划还包括 OTA 更新和每月约 15 个本机构建。
- 额外的构建分钟将按分钟计费，通过积分进行计费。
以下是如何设置您的仓库的步骤：
- 仓库结构: 将您的仓库组织为源 code、资产和配置文件的单独目录，以保持一切清洁和可管理。
- 环境配置: 为开发、测试和生产创建不同的环境，确保正确的访问控制和安全措施。
- 访问管理: 在设置仓库权限时请谨慎 Capgo 与 GitHub Actions 的集成 以确保安全
这些步骤将确保您的项目已准备好使用 GitHub Actions 工作流程，这将在下一节中详细介绍
GitHub Actions 工作流程设置
自动化您的 Capgo 部署 使用 GitHub Actions 来简化您的 CI/CD 流程
创建工作流文件
首先，在仓库的目录中创建一个 YAML 文件。以下是一个示例 .github/workflows 此配置确保了安全且自动化的部署。完成文件设置后，请选择合适的触发器来启动您的工作流
name: Capgo Deploy
on:
push:
branches:
- main
workflow_dispatch:
jobs:
deploy:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v6
- uses: actions/setup-node@v3
with:
node-version: '24'
- name: Install Dependencies
run: npm install
- name: Build App
run: npm run build
- name: Deploy to Capgo
run: npx @capgo/cli deploy
env:
CAPGO_TOKEN: ${{ secrets.CAPGO_TOKEN }}在设置仓库权限时请谨慎
工作流触发选项
GitHub Actions允许您自定义工作流何时运行。以下是触发选项:
| 触发类型 | 使用场景 | Configuration |
|---|---|---|
| 配置 | 在code上发布更改 | 部署于code的更改 |
| 激活__CAPGO_KEEP_0__推送到特定分支 | 手动分发 | 按需更新 |
| 允许您手动启动工作流程 | 定时发布 | 在设定时间间隔内运行部署 |
| 拉取请求 | 测试更新 | 在合并到主分支之前测试更改 |
管理密钥
为了确保安全的部署，您需要正确管理您的密钥。 GitHub Actions 提供了一个加密的密钥管理系统来实现此目的。
设置安全认证的步骤：
-
访问仓库设置
前往您的仓库设置，找到“安全”标签下的“密钥和变量”部分。 -
添加 Capgo 凭证
保存您的Capgo身份验证令牌作为一个仓库密钥。命名它CAPGO_TOKEN. -
在工作流程中引用密钥
在工作流程中使用存储的密钥，引用它们如下:${{ secrets.CAPGO_TOKEN }}.
Capgo命令在工作流程中
一旦您的GitHub Actions环境设置好，您就可以通过将Capgo CLI命令集成到自动部署中
安装Capgo CLI
将以下步骤添加到您的工作流程中以安装Capgo CLI
steps:
- name: Install Capgo CLI
run: npm install -g @capgo/cli
- name: Initialize Capgo
run: npx @capgo/cli initCLI身份验证
安全地使用以下方法验证CLI CAPGO_TOKEN:
- name: Authenticate Capgo CLI
run: npx @capgo/cli login
env:
CAPGO_TOKEN: ${{ secrets.CAPGO_TOKEN }}部署命令
以下是处理构建、版本和部署更新的关键命令
| 命令 | 目的 | 使用示例 |
|---|---|---|
build |
生成 生产就绪包 | npx @capgo/cli build |
deploy |
推送更新到Capgo | npx @capgo/cli deploy |
version |
设置更新的版本 | npx @capgo/cli version 1.2.0 |
为了自动化整个部署流程，请使用命令组合如下：
steps:
- name: Build and Deploy
run: |
npx @capgo/cli build
npx @capgo/cli version ${{ github.ref_name }}
npx @capgo/cli deploy
env:
CAPGO_TOKEN: ${{ secrets.CAPGO_TOKEN }}此设置确保您的更新在工作流运行时自动构建、版本化和部署。GitHub的秘密管理系统在整个过程中保护您的凭证安全。
测试和修复
运行测试工作流
您可以通过使用专门的GitHub测试频道来测试GitHub Actions 工作流。 Capgo 测试频道。 这使您能够在更新发布前验证它们。
- name: Test Build Deployment
run: |
npx @capgo/cli build
npx @capgo/cli deploy --channel beta
env:
CAPGO_TOKEN: ${{ secrets.CAPGO_TOKEN }}Capgo的频道系统有助于您为不同阶段创建独立的部署路径：
| 频道 | 目的 | 目标受众 |
|---|---|---|
| beta | 预发布测试 | 内部团队 |
| 测试环境 | QA验证 | 测试用户 |
| 生产 | 实时部署 | 所有用户 |
错误解决方案
以下是常见的集成问题和解决方法:
1. 身份验证失败
检查CAPGO_TOKEN在GitHub Secrets中。如果它过期，请重新生成它以确保身份验证顺畅。
2. 构建错误
确保您的构建配置与您的部署环境的要求相符。
“我们在生产环境中推出了Capgo OTA更新，覆盖了超过5000名用户。我们看到的操作非常顺畅，几乎所有用户都在分钟内更新到@Capgo。” [1]
3. 版本冲突
坚持语义版本和正确地递增版本以防止在部署期间发生冲突。
维护提示
- 使用 Capgo 分析 监控更新成功率。
- 启用自动回滚功能，更新可能引起问题时。
- 使用渠道选择器测试拉取请求（PR），以获得更好的控制。
- 保持您的工作流程与最新的 Capgo CLI 命令同步。
对于高优先级部署，利用 Capgo 的错误跟踪功能，尽早发现潜在问题。如果出现问题，回滚功能可以快速恢复到稳定版本，减少中断。这些实践将有助于保持您的部署顺利进行，随着您接近生产环境。
结论
关键亮点
Capgo 与 GitHub Actions 的集成简化了部署过程， Capacitor 应用，为开发团队带来了重大好处。全球更新成功率达 82%，95% 的活跃用户在 24 小时内接收到更新 [1], 这个解决方案在效率方面脱颖而出。
以下是一些突出的特点:
- 自动化工作流:通过在GitHub Actions中配置工作流程，无需使用外部CI/CD托管。这一方法可以节省运营成本，相比于像AppFlow这样的替代方案，五年内可以节省约$26,100。 [1].
- 快速部署:可以立即推送更新，绕过应用商店延迟。
- 强大的安全性:端到端加密确保更新安全传递，而Capgo的频道系统允许控制、分阶段的发布。
这些特点为更具定制化的解决方案和改进的性能打下了基础，以下内容将进一步探讨。
高级策略
要充分利用Capgo和GitHub Actions的集成，以下是高级策略:
- 自定义API工作流: 使用 Capgo 的公共 API 来设计符合团队特定需求的部署工作流程。这可以实现白标签体验和与当前工具的无缝集成。 [1].
- 频道发布: 使用 Capgo 的频道功能来实现阶段性和受控的更新，优化您的部署过程。
- 高效性能: 利用 Capgo 的部分更新来减少带宽使用和加速更新。通过在 750 个生产应用程序中交付 23.5 万次更新，系统已经证明了其处理大规模需求的能力。 [1]: 为更好的结果，考虑使用 __CAPGO_KEEP_0__ 的自主托管选项或自定义 __CAPGO_KEEP_1__ 设置。查看早期部分以获取详细的设置和测试指南，以完全实施这些策略。
: Capgo 与 API 动作的集成指南
Keep going from Capgo Integration with GitHub Actions: Guide
: __CAPGO_KEEP_0__ 与 __CAPGO_KEEP_1__ 动作的集成指南 Capgo 与 GitHub 行动的集成指南 : 加密 Encryption 为 __CAPGO_KEEP_0__ 加密实现细节 合规 为 __CAPGO_KEEP_0__ 合规实现细节 Capgo 安全扫描器 为 Capgo 安全扫描器产品工作流 Capgo 安全 为 Capgo 安全产品工作流, 和 Capgo 信任中心 为 Capgo 信任中心产品工作流
