添加应用

复制包含安装步骤和该插件完整 Markdown 指南的配置 prompt。

要求

在开始使用 Capgo 之前，请确保您已完成以下准备：

已安装并配置好 Capacitor 应用。了解如何设置 Capacitor
已安装 Node.js 20 或更高版本
具备以下开发环境之一：
- macOS 搭配 Xcode（用于 iOS 开发）和/或 Android Studio（用于 Android 开发）
- Linux 搭配 Android Studio（用于 Android 开发）
- Windows 搭配 Android Studio（用于 Android 开发）

Capgo 简介

只需 3 步即可用上 Live Updates

引导式设置

前往以下网址创建账号 https://capgo.app/register.
使用 Init 命令开始使用
终端窗口
```
npx @capgo/cli@latest init [APIKEY]
```
系统会依次询问你一系列问题。请提供必要回答以完成自动配置。
部署 live update

详细入门指南查看 CLI 入门流程的完整分步指南

部署 live update 了解如何将 live update 部署到你的应用

手动配置

如果 init 命令无法正常工作，您可以手动添加应用。

将 CLI 连接到您的账户：
终端窗口
```
npx @capgo/cli@latest login [APIKEY]
```
使用此命令将应用添加到您的账户：
终端窗口
```
npx @capgo/cli@latest app add [APP_NAME]
```
在您的应用中安装插件：
终端窗口
```
npm i @capgo/capacitor-updater
```

在您的应用中配置插件 capacitor.config

{
  "plugins": {
    CapacitorUpdater: {
      "appId": "Your appID",
      "autoUpdate": "atBackground",
      "version": "1.0.0"
    }
  }
}

查看所有可用选项。如果未提供，系统会自动推断此信息。

请尽早在 App 中调用 init 方法：

import { CapacitorUpdater } from '@capgo/capacitor-updater';
CapacitorUpdater.notifyAppReady();

部署 live update

上述命令（步骤 3）会为 Capacitor 8 安装最新版本 (v8.x)。对于旧版 Capacitor，请使用相应的 npm 标签：

# Capacitor 7
npm i @capgo/capacitor-updater@lts-v7

# Capacitor 6
npm i @capgo/capacitor-updater@lts-v6

# Capacitor 5
npm i @capgo/capacitor-updater@lts-v5

# Capacitor 4
npm i @capgo/capacitor-updater@lts-v4

每个插件的主版本号与 Capacitor 的主版本号一致 (v8 → Capacitor 8, v7 → Capacitor 7, v6 → Capacitor 6, v5 → Capacitor 5, v4 → Capacitor 4)。当最新版本线为 8.3.4，对应的 LTS 版本是 7.3.4 包含相同的特性和 Bug 修复。Updater 每月会接收镜像的 LTS backports，用于 v7/v6/v5; lts-v4 在 Capacitor 4 之外的周期内仍可使用。其他 Capgo 插件可按需进行 backport。

Capgo CLI 主版本号不会需要与插件或 Capacitor 主版本号保持一致 —— 请务必使用 npx @capgo/cli@latest。请参阅 Capgo 版本管理查看完整策略。

从“添加应用”继续

如果你正在使用 添加应用 要规划原生插件工作，请将其与 Capgo 插件目录查看 Capgo 插件目录中的产品工作流， Capgo 提供的 Capacitor 插件查看由 Capgo 提供的 Capacitor 插件中的实现细节，添加或更新插件查看添加或更新插件中的实现细节， Ionic Enterprise 插件替代方案查看 Ionic Enterprise 插件替代方案中的产品工作流，以及 Capgo Native Build 查看 Capgo Native Builds 中的产品工作流。