Capgo Live Updates

Cap-go/capgo-skills/plugins/capgo-cloud/skills/capgo-live-updates

作者 Cap-go2cfb277a148832bdb1a835b01e4de323687b498b無授權條款72 個星標收錄於 2026年10月9日更新於 2026年10月9日儲存庫今天更新

Complete guide to implementing live updates in Capacitor apps using Capgo. Covers account creation, plugin installation, configuration, update strategies, and CI/CD integration. Use this skill when users want to deploy updates without app store review.

僅含說明DevOps & Cloud

AI 產生的概覽

指導在 Capacitor 應用程式中實作 Capgo 即時更新，涵蓋設定、組態、部署、通道、回復與 CI/CD。

功能: 此技能提供逐步指南，說明如何使用 Capgo 為 Capacitor 應用程式加入無線（OTA）即時更新。內容涵蓋帳號建立、CLI 安裝、外掛設定、capacitor.config.ts 組態、自動與手動更新流程以及事件監聽。它也說明如何透過 CLI 與 CI/CD 流程部署、通道與分階段發布、回復與版本管理、自架、加密與監控。其產出是指南說明與程式碼範例，而非可執行的指令碼。
適用情境: 當使用者想為 Capacitor 應用程式實作即時或 OTA 更新、詢問 Capgo、想跳過應用程式商店審核來更新網頁層、需要快速熱修復，或想進行 A/B 測試與分階段發布時，可使用此技能。
執行需求: 需要一個 Capacitor 應用程式專案、用於 Capgo CLI 與 @capgo/capacitor-updater 外掛的 Node.js 與 npm，以及 Capgo 帳號或 API 金鑰。存取 Capgo 服務與安裝套件需要網路連線。此技能不附指令碼，僅為說明文件。

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

Step 3: Login to Capgo

Or use API key:

Step 4: Initialize Your App

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:

Configuration

Basic Configuration

typescript

// capacitor.config.tsimport 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;

// capacitor.config.tsimport 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

typescript

// capacitor.config.tsplugins: {  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  },},

// capacitor.config.tsplugins: {  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:

typescript

// app.ts - Just notify when readyimport { CapacitorUpdater } from '@capgo/capacitor-updater';
// Tell Capgo the app loaded successfully// This MUST be called within 10 seconds of app startCapacitorUpdater.notifyAppReady();

// app.ts - Just notify when readyimport { CapacitorUpdater } from '@capgo/capacitor-updater';
// Tell Capgo the app loaded successfully// This MUST be called within 10 seconds of app startCapacitorUpdater.notifyAppReady();

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

Manual Updates

For more control:

typescript

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

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

typescript

// update-service.tsimport { 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-service.tsimport { 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

typescript

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();  }}

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

typescript

import { CapacitorUpdater } from '@capgo/capacitor-updater';
// Update downloadedCapacitorUpdater.addListener('updateAvailable', (info) => {  console.log('Update available:', info.bundle.version);});
// Download progressCapacitorUpdater.addListener('downloadProgress', (progress) => {  console.log('Download:', progress.percent, '%');});
// Update failedCapacitorUpdater.addListener('updateFailed', (info) => {  console.error('Update failed:', info.bundle.version);});
// App readyCapacitorUpdater.addListener('appReady', () => {  console.log('App is ready');});

import { CapacitorUpdater } from '@capgo/capacitor-updater';
// Update downloadedCapacitorUpdater.addListener('updateAvailable', (info) => {  console.log('Update available:', info.bundle.version);});
// Download progressCapacitorUpdater.addListener('downloadProgress', (progress) => {  console.log('Download:', progress.percent, '%');});
// Update failedCapacitorUpdater.addListener('updateFailed', (info) => {  console.error('Update failed:', info.bundle.version);});
// App readyCapacitorUpdater.addListener('appReady', () => {  console.log('App is ready');});

Deploying Updates

Deploy via CLI

bash

# Build your web appnpm run build
# Upload to Capgocapgo upload
# Upload to specific channelcapgo upload --channel beta
# Upload with versioncapgo upload --bundle 1.2.3

# Build your web appnpm run build
# Upload to Capgocapgo upload
# Upload to specific channelcapgo upload --channel beta
# Upload with versioncapgo upload --bundle 1.2.3

Deploy via CI/CD

GitHub Actions

yaml

# .github/workflows/deploy.ymlname: 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 }}

# .github/workflows/deploy.ymlname: 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

yaml

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

# .gitlab-ci.ymldeploy:  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

bash

# Create beta channelcapgo channel create beta
# Create staging channelcapgo channel create staging

# Create beta channelcapgo channel create beta
# Create staging channelcapgo channel create staging

Deploy to Channels

bash

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

# Deploy to beta (internal testing)capgo upload --channel beta
# Promote to productioncapgo 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

typescript

// Assign device to channelimport { CapacitorUpdater } from '@capgo/capacitor-updater';
// For beta testersawait CapacitorUpdater.setChannel({ channel: 'beta' });
// For production usersawait CapacitorUpdater.setChannel({ channel: 'production' });

// Assign device to channelimport { CapacitorUpdater } from '@capgo/capacitor-updater';
// For beta testersawait CapacitorUpdater.setChannel({ channel: 'beta' });
// For production usersawait 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

bash

# List available versionscapgo bundle list
# Rollback to specific versioncapgo bundle revert --bundle 1.2.2 --channel production

# List available versionscapgo bundle list
# Rollback to specific versioncapgo bundle revert --bundle 1.2.2 --channel production

In-App Rollback

typescript

// Get list of downloaded bundlesconst bundles = await CapacitorUpdater.list();
// Rollback to built-in versionawait CapacitorUpdater.reset();
// Delete a specific bundleawait CapacitorUpdater.delete({ id: 'bundle-id' });

// Get list of downloaded bundlesconst bundles = await CapacitorUpdater.list();
// Rollback to built-in versionawait CapacitorUpdater.reset();
// Delete a specific bundleawait CapacitorUpdater.delete({ id: 'bundle-id' });

Self-Hosted Option

For enterprise or privacy requirements:

bash

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

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

Configure app to use self-hosted:

typescript

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

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

Security

Encrypted Updates

For sensitive apps, enable encryption:

Configure in app:

typescript

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

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

Code Signing

Verify updates are from trusted source:

Monitoring and Analytics

Dashboard Metrics

In Capgo dashboard, view:

Active devices
Update success rate
Rollback rate
Version distribution
Error logs

Custom Analytics

typescript

// Track custom eventsimport { CapacitorUpdater } from '@capgo/capacitor-updater';
// Get current bundle infoconst current = await CapacitorUpdater.current();console.log('Current version:', current.bundle.version);
// Get download statsconst stats = await CapacitorUpdater.getBuiltinVersion();

// Track custom eventsimport { CapacitorUpdater } from '@capgo/capacitor-updater';
// Get current bundle infoconst current = await CapacitorUpdater.current();console.log('Current version:', current.bundle.version);
// Get download statsconst 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 call notifyAppReady() - 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

來源與署名

來源：Cap-go/capgo-skills位於plugins/capgo-cloud/skills/capgo-live-updates提交2cfb277

授權條款：無授權條款

內容歸原作者所有。SourceWeft 從公開儲存庫中收錄這些內容。

檢舉或申請下架

Capgo Live Updates

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

Security

Encrypted Updates

Code Signing

Monitoring and Analytics

Dashboard Metrics

Custom Analytics

Troubleshooting

Issue: Updates Not Applying

Issue: Rollback Loop

Issue: Slow Downloads

Best Practices

Resources

來源與署名

更多來自 Cap-go/capgo-skills 的技能

Capgo Release Workflows

Capgo Release Management

Capgo Cloud

Capacitor Mcp

Capgo Organization Management

Capgo Cli Usage

更多DevOps & Cloud技能

Playwright Devops

M5 Onboard

Yeet

Runbook

Incident Response

Deploy Checklist