Capgo Live Updates：Capacitor应用实时OTA更新，无需应用商店审核

capgo-live-updates by cap-go/capgo-skills

80 周安装量

20 GitHub Stars

GitHub

安装命令

npx skills add https://github.com/cap-go/capgo-skills --skill capgo-live-updates

移动应用部署策略 Capacitor

🇨🇳中文介绍

Capgo Live Updates for Capacitor

无需等待应用商店审核，即刻向您的 Capacitor 应用部署更新。

何时使用此技能

用户想要实时/OTA更新
用户询问关于 Capgo
用户想要跳过应用商店审核
用户需要快速推送热修复
用户想要进行 A/B 测试或分阶段发布

什么是 Capgo？

Capgo 是一个用于 Capacitor 应用的实时更新服务，它允许您：

即时推送 JavaScript/HTML/CSS 更新
跳过 Web 层变更的应用商店审核
自动回滚有问题的更新
通过渠道进行 A/B 测试功能
监控更新分析数据

注意：原生代码变更（Swift/Kotlin/Java）仍需要提交到应用商店。

开始使用

步骤 1：创建 Capgo 账户

访问 https://capgo.app
点击 "Sign Up" 或 "Get Started"
使用 GitHub、Google 或电子邮件注册
选择一个套餐：
- 免费版：1 个应用，每月 500 次更新
- 个人版：$14/月，无限更新
- 团队版：$49/月，团队功能
- 企业版：定制价格

步骤 2：安装 CLI

npm install -g @capgo/cli

广告位招租

在这里展示您的产品或服务

触达数万 AI 开发者，精准高效

联系我们

步骤 3：登录到 Capgo

capgo login
# 打开浏览器进行身份验证

或者使用 API 密钥：

capgo login --apikey YOUR_API_KEY

步骤 4：初始化您的应用

cd your-capacitor-app
capgo init

在 Capgo 仪表板中创建应用
将 @capgo/capacitor-updater 添加到您的项目
配置 capacitor.config.ts
设置您的第一个渠道

步骤 5：安装插件

如果未自动安装：

npm install @capgo/capacitor-updater
npx cap sync

// capacitor.config.ts
import type { CapacitorConfig } from '@capacitor/cli';

const config: CapacitorConfig = {
  appId: 'com.yourapp.id',
  appName: 'Your App',
  webDir: 'dist',
  plugins: {
    CapacitorUpdater: {
      autoUpdate: true,  // 启用自动更新
    },
  },
};

export default config;

// capacitor.config.ts
plugins: {
  CapacitorUpdater: {
    autoUpdate: true,
    // 更新行为
    resetWhenUpdate: true,           // 原生更新时重置为内置版本
    updateUrl: 'https://api.capgo.app/updates', // 默认值
    statsUrl: 'https://api.capgo.app/stats',    // 分析数据

    // 渠道
    defaultChannel: 'production',

    // 更新时间
    periodCheckDelay: 600,           // 每 10 分钟检查一次（秒）
    delayConditionsFail: false,      // 条件失败时不延迟

    // 私有更新（企业版）
    privateKey: 'YOUR_PRIVATE_KEY',  // 用于加密更新
  },
},

自动更新（推荐）

设置 autoUpdate: true，更新将自动进行：

// app.ts - 只需在就绪时通知
import { CapacitorUpdater } from '@capgo/capacitor-updater';

// 告知 Capgo 应用已成功加载
// 必须在应用启动后 10 秒内调用
CapacitorUpdater.notifyAppReady();

重要：务必调用 notifyAppReady()。如果在 10 秒内未调用，Capgo 会认为更新失败并执行回滚。

如需更多控制：

// capacitor.config.ts
plugins: {
  CapacitorUpdater: {
    autoUpdate: false,  // 禁用自动更新
  },
},



// update-service.ts
import { CapacitorUpdater } from '@capgo/capacitor-updater';

class UpdateService {
  async checkForUpdate() {
    // 检查是否有可用更新
    const update = await CapacitorUpdater.getLatest();

    if (!update.url) {
      console.log('没有可用更新');
      return null;
    }

    console.log('有可用更新：', update.version);
    return update;
  }

  async downloadUpdate(update: any) {
    // 下载更新包
    const bundle = await CapacitorUpdater.download({
      url: update.url,
      version: update.version,
    });

    console.log('已下载：', bundle.id);
    return bundle;
  }

  async installUpdate(bundle: any) {
    // 设置为下一个版本（在下次应用启动时生效）
    await CapacitorUpdater.set(bundle);
    console.log('更新将在下次重启时应用');
  }

  async installAndReload(bundle: any) {
    // 设置并立即重新加载
    await CapacitorUpdater.set(bundle);
    await CapacitorUpdater.reload();
  }
}

带用户提示的更新

import { CapacitorUpdater } from '@capgo/capacitor-updater';
import { Dialog } from '@capacitor/dialog';

async function checkUpdate() {
  const update = await CapacitorUpdater.getLatest();

  if (!update.url) return;

  const { value } = await Dialog.confirm({
    title: '有可用更新',
    message: `版本 ${update.version} 已可用。现在更新吗？`,
  });

  if (value) {
    // 显示加载指示器
    showLoading('正在下载更新...');

    const bundle = await CapacitorUpdater.download({
      url: update.url,
      version: update.version,
    });

    hideLoading();

    // 应用并重新加载
    await CapacitorUpdater.set(bundle);
    await CapacitorUpdater.reload();
  }
}

import { CapacitorUpdater } from '@capgo/capacitor-updater';

// 更新已下载
CapacitorUpdater.addListener('updateAvailable', (info) => {
  console.log('有可用更新：', info.bundle.version);
});

// 下载进度
CapacitorUpdater.addListener('downloadProgress', (progress) => {
  console.log('下载进度：', progress.percent, '%');
});

// 更新失败
CapacitorUpdater.addListener('updateFailed', (info) => {
  console.error('更新失败：', info.bundle.version);
});

// 应用就绪
CapacitorUpdater.addListener('appReady', () => {
  console.log('应用已就绪');
});

# 构建您的 Web 应用
npm run build

# 上传到 Capgo
capgo upload

# 上传到特定渠道
capgo upload --channel beta

# 上传指定版本
capgo upload --bundle 1.2.3

# .github/workflows/deploy.yml
name: 部署到 Capgo

on:
  push:
    branches: [main]

jobs:
  deploy:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4

      - uses: actions/setup-node@v4

      - name: 安装依赖
        run: npm install

      - name: 构建
        run: npm run build

      - name: 部署到 Capgo
        run: npx @capgo/cli bundle upload
        env:
          CAPGO_TOKEN: ${{ secrets.CAPGO_TOKEN }}

# .gitlab-ci.yml
deploy:
  stage: deploy
  image: node:20
  script:
    - npm install
    - npm run build
    - npx @capgo/cli bundle upload
  only:
    - main
  variables:
    CAPGO_TOKEN: $CAPGO_TOKEN

渠道与分阶段发布

# 创建 beta 渠道
capgo channel create beta

# 创建 staging 渠道
capgo channel create staging

# 部署到 beta（内部测试）
capgo upload --channel beta

# 推广到生产环境
capgo upload --channel production

在 Capgo 仪表板中：

转到 Channels > production
设置发布百分比（例如，10%）
监控分析数据
逐步增加到 50%，然后 100%

// 将设备分配到渠道
import { CapacitorUpdater } from '@capgo/capacitor-updater';

// 针对 beta 测试者
await CapacitorUpdater.setChannel({ channel: 'beta' });

// 针对生产环境用户
await CapacitorUpdater.setChannel({ channel: 'production' });

回滚与版本管理

如果 notifyAppReady() 在 10 秒内未被调用，Capgo 会自动回滚到之前可用的版本。

# 列出可用版本
capgo bundle list

# 回滚到特定版本
capgo bundle revert --bundle 1.2.2 --channel production

// 获取已下载的包列表
const bundles = await CapacitorUpdater.list();

// 回滚到内置版本
await CapacitorUpdater.reset();

// 删除特定包
await CapacitorUpdater.delete({ id: 'bundle-id' });

针对企业或隐私要求：

# 安装自托管的 Capgo
docker run -d \
  -p 8080:8080 \
  -e DATABASE_URL=postgres://... \
  capgo/capgo-server

配置应用以使用自托管服务：

// capacitor.config.ts
plugins: {
  CapacitorUpdater: {
    autoUpdate: true,
    updateUrl: 'https://your-server.com/updates',
    statsUrl: 'https://your-server.com/stats',
  },
},

对于敏感应用，启用加密：

# 生成密钥对
capgo key create

# 使用加密上传
capgo upload --key-v2

在应用中配置：

// capacitor.config.ts
plugins: {
  CapacitorUpdater: {
    autoUpdate: true,
    privateKey: 'YOUR_PRIVATE_KEY',
  },
},

验证更新来自可信来源：

# 签名包
capgo upload --sign

# 在应用中验证签名
capgo key verify

在 Capgo 仪表板中，查看：

活跃设备
更新成功率
回滚率
版本分布
错误日志

// 跟踪自定义事件
import { CapacitorUpdater } from '@capgo/capacitor-updater';

// 获取当前包信息
const current = await CapacitorUpdater.current();
console.log('当前版本：', current.bundle.version);

// 获取下载统计信息
const stats = await CapacitorUpdater.getBuiltinVersion();

问题：更新未应用

检查是否调用了 notifyAppReady()
验证应用 ID 是否与 Capgo 仪表板匹配
检查渠道分配
查看 Capgo 仪表板日志

问题：回滚循环

应用在 notifyAppReady() 之前崩溃
修复：确保尽早调用 notifyAppReady()
暂时禁用更新以进行调试

问题：下载缓慢

启用增量更新（自动）
优化包大小
使用 CDN（企业版）

务必调用 notifyAppReady() - 应用初始化后第一件事
先在 beta 渠道测试更新 - 切勿将未经测试的更新推送到生产环境
使用语义化版本控制 - 使回滚更容易
监控回滚率 - 高回滚率表示存在质量问题
实现错误边界 - 在回滚前捕获崩溃
保持原生代码稳定 - 原生变更需要应用商店审核

🇺🇸English

Capgo Live Updates for Capacitor

Deploy updates to your Capacitor app instantly without waiting for app store review.

When to Use This Skill

User wants live/OTA updates
User asks about Capgo
User wants to skip app store review
User needs to push hotfixes quickly
User wants A/B testing or staged rollouts

What is Capgo?

Capgo is a live update service for Capacitor apps that lets you:

Push JavaScript/HTML/CSS updates instantly
Skip app store review for web layer changes
Roll back bad updates automatically
A/B test features with channels
Monitor update analytics

Note : Native code changes (Swift/Kotlin/Java) still require app store submission.

Getting Started

Step 1: Create a Capgo Account

Go to https://capgo.app
Click "Sign Up" or "Get Started"
Sign up with GitHub, Google, or email
Choose a plan:
- Free : 1 app, 500 updates/month
- Solo : $14/mo, unlimited updates
- Team : $49/mo, team features
- Enterprise : Custom pricing

Step 2: Install the CLI

npm install -g @capgo/cli

Step 3: Login to Capgo

capgo login
# Opens browser to authenticate

Or use API key:

capgo login --apikey YOUR_API_KEY

Step 4: Initialize Your App

cd your-capacitor-app
capgo init

This will:

Create app in Capgo dashboard
Add @capgo/capacitor-updater to your project
Configure capacitor.config.ts
Set up your first channel

Step 5: Install the Plugin

If not installed automatically:

npm install @capgo/capacitor-updater
npx cap sync

Configuration

Basic Configuration

// capacitor.config.ts
import type { CapacitorConfig } from '@capacitor/cli';

const config: CapacitorConfig = {
  appId: 'com.yourapp.id',
  appName: 'Your App',
  webDir: 'dist',
  plugins: {
    CapacitorUpdater: {
      autoUpdate: true,  // Enable automatic updates
    },
  },
};

export default config;

Advanced Configuration

// capacitor.config.ts
plugins: {
  CapacitorUpdater: {
    autoUpdate: true,
    // Update behavior
    resetWhenUpdate: true,           // Reset to built-in on native update
    updateUrl: 'https://api.capgo.app/updates', // Default
    statsUrl: 'https://api.capgo.app/stats',    // Analytics

    // Channels
    defaultChannel: 'production',

    // Update timing
    periodCheckDelay: 600,           // Check every 10 minutes (seconds)
    delayConditionsFail: false,      // Don't delay on condition fail

    // Private updates (enterprise)
    privateKey: 'YOUR_PRIVATE_KEY',  // For encrypted updates
  },
},

Implementing Updates

Automatic Updates (Recommended)

With autoUpdate: true, updates are automatic:

// app.ts - Just notify when ready
import { CapacitorUpdater } from '@capgo/capacitor-updater';

// Tell Capgo the app loaded successfully
// This MUST be called within 10 seconds of app start
CapacitorUpdater.notifyAppReady();

Important : Always call notifyAppReady(). If not called within 10 seconds, Capgo assumes the update failed and rolls back.

Manual Updates

For more control:

// capacitor.config.ts
plugins: {
  CapacitorUpdater: {
    autoUpdate: false,  // Disable auto updates
  },
},



// update-service.ts
import { CapacitorUpdater } from '@capgo/capacitor-updater';

class UpdateService {
  async checkForUpdate() {
    // Check for available update
    const update = await CapacitorUpdater.getLatest();

    if (!update.url) {
      console.log('No update available');
      return null;
    }

    console.log('Update available:', update.version);
    return update;
  }

  async downloadUpdate(update: any) {
    // Download the update bundle
    const bundle = await CapacitorUpdater.download({
      url: update.url,
      version: update.version,
    });

    console.log('Downloaded:', bundle.id);
    return bundle;
  }

  async installUpdate(bundle: any) {
    // Set as next version (applies on next app start)
    await CapacitorUpdater.set(bundle);
    console.log('Update will apply on next restart');
  }

  async installAndReload(bundle: any) {
    // Set and reload immediately
    await CapacitorUpdater.set(bundle);
    await CapacitorUpdater.reload();
  }
}

Update with User Prompt

import { CapacitorUpdater } from '@capgo/capacitor-updater';
import { Dialog } from '@capacitor/dialog';

async function checkUpdate() {
  const update = await CapacitorUpdater.getLatest();

  if (!update.url) return;

  const { value } = await Dialog.confirm({
    title: 'Update Available',
    message: `Version ${update.version} is available. Update now?`,
  });

  if (value) {
    // Show loading indicator
    showLoading('Downloading update...');

    const bundle = await CapacitorUpdater.download({
      url: update.url,
      version: update.version,
    });

    hideLoading();

    // Apply and reload
    await CapacitorUpdater.set(bundle);
    await CapacitorUpdater.reload();
  }
}

Listen for Update Events

import { CapacitorUpdater } from '@capgo/capacitor-updater';

// Update downloaded
CapacitorUpdater.addListener('updateAvailable', (info) => {
  console.log('Update available:', info.bundle.version);
});

// Download progress
CapacitorUpdater.addListener('downloadProgress', (progress) => {
  console.log('Download:', progress.percent, '%');
});

// Update failed
CapacitorUpdater.addListener('updateFailed', (info) => {
  console.error('Update failed:', info.bundle.version);
});

// App ready
CapacitorUpdater.addListener('appReady', () => {
  console.log('App is ready');
});

Deploying Updates

Deploy via CLI

# Build your web app
npm run build

# Upload to Capgo
capgo upload

# Upload to specific channel
capgo upload --channel beta

# Upload with version
capgo upload --bundle 1.2.3

Deploy via CI/CD

GitHub Actions

# .github/workflows/deploy.yml
name: Deploy to Capgo

on:
  push:
    branches: [main]

jobs:
  deploy:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4

      - uses: actions/setup-node@v4

      - name: Install dependencies
        run: npm install

      - name: Build
        run: npm run build

      - name: Deploy to Capgo
        run: npx @capgo/cli bundle upload
        env:
          CAPGO_TOKEN: ${{ secrets.CAPGO_TOKEN }}

GitLab CI

# .gitlab-ci.yml
deploy:
  stage: deploy
  image: node:20
  script:
    - npm install
    - npm run build
    - npx @capgo/cli bundle upload
  only:
    - main
  variables:
    CAPGO_TOKEN: $CAPGO_TOKEN

Channels and Staged Rollouts

Create Channels

# Create beta channel
capgo channel create beta

# Create staging channel
capgo channel create staging

Deploy to Channels

# Deploy to beta (internal testing)
capgo upload --channel beta

# Promote to production
capgo upload --channel production

Staged Rollout

In Capgo dashboard:

Go to Channels > production
Set rollout percentage (e.g., 10%)
Monitor analytics
Increase to 50%, then 100%

Device-Specific Channels

// Assign device to channel
import { CapacitorUpdater } from '@capgo/capacitor-updater';

// For beta testers
await CapacitorUpdater.setChannel({ channel: 'beta' });

// For production users
await CapacitorUpdater.setChannel({ channel: 'production' });

Rollback and Version Management

Automatic Rollback

If notifyAppReady() isn't called within 10 seconds, Capgo automatically rolls back to the previous working version.

Manual Rollback

# List available versions
capgo bundle list

# Rollback to specific version
capgo bundle revert --bundle 1.2.2 --channel production

In-App Rollback

// Get list of downloaded bundles
const bundles = await CapacitorUpdater.list();

// Rollback to built-in version
await CapacitorUpdater.reset();

// Delete a specific bundle
await CapacitorUpdater.delete({ id: 'bundle-id' });

Self-Hosted Option

For enterprise or privacy requirements:

# Install self-hosted Capgo
docker run -d \
  -p 8080:8080 \
  -e DATABASE_URL=postgres://... \
  capgo/capgo-server

Configure app to use self-hosted:

// capacitor.config.ts
plugins: {
  CapacitorUpdater: {
    autoUpdate: true,
    updateUrl: 'https://your-server.com/updates',
    statsUrl: 'https://your-server.com/stats',
  },
},

Security

Encrypted Updates

For sensitive apps, enable encryption:

# Generate key pair
capgo key create

# Upload with encryption
capgo upload --key-v2

Configure in app:

// capacitor.config.ts
plugins: {
  CapacitorUpdater: {
    autoUpdate: true,
    privateKey: 'YOUR_PRIVATE_KEY',
  },
},

Code Signing

Verify updates are from trusted source:

# Sign bundle
capgo upload --sign

# Verify signature in app
capgo key verify

Monitoring and Analytics

Dashboard Metrics

In Capgo dashboard, view:

Active devices
Update success rate
Rollback rate
Version distribution
Error logs

Custom Analytics

// Track custom events
import { CapacitorUpdater } from '@capgo/capacitor-updater';

// Get current bundle info
const current = await CapacitorUpdater.current();
console.log('Current version:', current.bundle.version);

// Get download stats
const stats = await CapacitorUpdater.getBuiltinVersion();

Troubleshooting

Issue: Updates Not Applying

Check notifyAppReady() is called
Verify app ID matches Capgo dashboard
Check channel assignment
Review Capgo dashboard logs

Issue: Rollback Loop

App crashes before notifyAppReady()
Fix: Ensure notifyAppReady() is called early
Temporarily disable updates to debug

Issue: Slow Downloads

Enable delta updates (automatic)
Optimize bundle size
Use CDN (enterprise)

Best Practices

Always callnotifyAppReady() - First thing after app initializes
Test updates on beta channel first - Never push untested to production
Use semantic versioning - Makes rollback easier
Monitor rollback rate - High rate indicates quality issues
Implement error boundary - Catch crashes before rollback
Keep native code stable - Native changes need app store

Resources

Capgo Documentation: https://capgo.app/docs
Capgo Dashboard: https://web.capgo.app
Plugin GitHub: https://github.com/Cap-go/capacitor-updater
Discord Community: https://discord.gg/capgo

Weekly Installs

Repository

cap-go/capgo-skills

GitHub Stars

First Seen

Feb 6, 2026

Security Audits

Gen Agent Trust HubPass SocketPass SnykFail

Installed on

gemini-cli78

opencode77

codex75

github-copilot74

kimi-cli72

amp71

Sentry React Native SDK 设置指南：React Native/Expo 错误监控、性能追踪与回放

433 周安装

Capgo Live Updates：Capacitor应用实时OTA更新，无需应用商店审核

🇨🇳中文介绍

Capgo Live Updates for Capacitor

何时使用此技能

什么是 Capgo？

开始使用

步骤 1：创建 Capgo 账户

步骤 2：安装 CLI

相关 Skills

步骤 3：登录到 Capgo

步骤 4：初始化您的应用

步骤 5：安装插件

配置

基本配置

高级配置

实现更新

自动更新（推荐）

手动更新

带用户提示的更新

监听更新事件

部署更新

通过 CLI 部署

通过 CI/CD 部署

GitHub Actions

GitLab CI

渠道与分阶段发布

创建渠道

部署到渠道

分阶段发布

设备特定渠道

回滚与版本管理

自动回滚

手动回滚

应用内回滚

自托管选项

安全性

加密更新

代码签名

监控与分析

仪表板指标

自定义分析

故障排除

问题：更新未应用

问题：回滚循环

问题：下载缓慢

最佳实践

资源

🇺🇸English

Capgo Live Updates for Capacitor

When to Use This Skill

What is Capgo?

Getting Started

Step 1: Create a Capgo Account

Step 2: Install the CLI

Step 3: Login to Capgo

Step 4: Initialize Your App

Step 5: Install the Plugin

Configuration

Basic Configuration

Advanced Configuration

Implementing Updates

Automatic Updates (Recommended)

Manual Updates

Update with User Prompt

Listen for Update Events

Deploying Updates

Deploy via CLI

Deploy via CI/CD

GitHub Actions

GitLab CI

Channels and Staged Rollouts

Create Channels

Deploy to Channels

Staged Rollout

Device-Specific Channels

Rollback and Version Management

Automatic Rollback

Manual Rollback

In-App Rollback

Self-Hosted Option