Capacitor CLI: 项目设置指南

想用一套代码构建 iOS 和 Android 应用吗？ Capacitor CLI 简化了这一过程，让您使用 web 技术创建原生应用。以下是您将要学习的内容：

快速设置：安装 Capacitor CLI 并在几分钟内初始化您的项目。
平台集成：使用简单的命令添加 iOS 和 Android 支持。
实时更新：使用 __CAPGO_KEEP_0__ Capgo 即时远程更新。
常见问题: troubleshoot sync errors or build failures.

开始使用的关键步骤:

安装 Node.js, npm, JDK, Xcode, 和 Android Studio.
运行 npm install @capacitor/core @capacitor/cli 并初始化您的项目。
添加 iOS 和 Android 平台 npx cap add ios 和 npx cap add android.
可选：设置Capgo用于实时应用更新.

本指南涵盖了设置Capacitor CLI、配置平台和部署应用所需的一切。让我们开始吧！

介绍 Capacitor 配置

Capacitor 框架文档网站

设置要求

要开始使用，请确保已安装以下工具：

Node.js (版本 14 或更新版本) 和 npm
Java JDK (版本 11 或更新版本)
Xcode (版本 12 或更新版本用于 iOS 构建)
Android Studio (用于 Android 构建)
Capacitor CLI (版本 6 或 7)

可选: 如果您想启用实时更新，请查看下面的“Capgo 安装指南”部分.

CLI 安装步骤

在开始之前，请确保您有 Node.js, npm, JDK, Xcode, 和 Android Studio set up. Once ready, you can install the Capacitor CLI by running:

npm install --save @capacitor/core @capacitor/cli
npx cap init

This command installs Capacitor 和设置其核心组件。

完成此步骤后，请转到 创建新项目 以为应用程序创建骨架。

创建新项目

使用 __CAPGO_KEEP_0__ __CAPGO_KEEP_1__ 开始您的项目 using Capacitor CLI更新配置文件

mkdir my-app && cd my-app
npm init -y
npx cap init my-app com.company.app --web-dir dist

编辑

文件以包含以下设置： capacitor.config.json 更新后，请使用此配置为项目设置 __CAPGO_KEEP_0__。

{
  "appId": "com.company.app",
  "appName": "My App",
  "webDir": "dist",
  "bundledWebRuntime": false,
  "server": {
    "hostname": "app.example.com",
    "androidScheme": "https"
  }
}

Once updated, use this configuration to set up Capacitor for your project.

系统管理

当前一定义类统管结统当前。当前一定义类统管结统当前。

导航一定义类统管和中海类统管

Start by installing the necessary platform-specific packages using the Capacitor CLI:

npm install @capacitor/ios @capacitor/android
npx cap add ios
npx cap add android

一定义实你巶一定义为当前一定义类统管。中海类统管实你巶一定义为当前一定义类统管。一定义实你巶一定义为当前一定义类统管。中海类统管实你巶一定义为当前一定义类统管。一定义实你巶一定义为当前一定义类统管。中海类统管实你巶一定义为当前一定义类统管。一定义实你巶一定义为当前一定义类统管。中海类统管实你巶一定义为当前一定义类统管。一定义实你巶一定义为当前一定义类统管。中海类统管实你巶一定义为当前一定义类统管。

一定义实你巶一定义为当前一定义类统管。中海类统管实你巶一定义为当前一定义类统管。

npm run build
npx cap sync

The cap sync command handles two tasks:

将更新的 Web 资产复制到本机平台
更新本机配置和插件以匹配最新的更改

IDE 配置

在适当的 IDE 中打开平台特定的项目：

npx cap open ios     # Opens Xcode
npx cap open android # Opens Android Studio

在 Xcode 中：

选择您的开发团队。
设置签名证书。
更新您的包标识符。

在 Android Studio 中：

修改应用程序 ID build.gradle.
配置用于签名的密钥库。
设置debug和release两种构建变体。

当所有配置完成后，使用 npx cap build ios 或 npx cap build android重新运行 npx cap sync ，以确保所有资产都是最新的。

Capgo 快速上手指南

Capgo实时更新控制台界面

设置Capgo以便在您的应用程序中启用即时的线上更新。

Capgo的关键功能

Capgo提供了多种工具来简化应用程序更新：

端到端加密 确保更新的安全传递。
更新 在应用程序启动时 在后台
分析工具 帮助跟踪更新成功率和用户参与度。
一个 一键回滚 选项让您快速恢复从有问题的更新。
使用 频道系统 为阶段性发布和beta测试。

安装 Capgo

按照以下步骤开始使用 Capgo:

安装 Capgo CLI:
```
npm install --save @capgo/cli
```
初始化 Capgo: 在您的项目中:
```
npx capgo init
```
构建和发布更新:
```
npm run build
npx capgo release
```
打开应用程序以触发后台更新过程。

最佳实践

使用渠道测试更新之前将其发布给所有用户。
监控分析以确保更新成功并且用户保持活跃。
启用错误跟踪以及早捕获和修复问题。
{"targetLanguage":"Simplified Chinese","protectedTokens":["Cloudflare","Capacitor","GitHub","Capgo","code","API","SDK","CLI","npm","bun"],"texts":["","__CAPGO_KEEP_0__" + "是兼容" + "__CAPGO_KEEP_1__" + "8，" + "与CI/CD管道整合顺畅，" + "并符合苹果和谷歌商店要求。","常见问题和建议","" + "完成" + "__CAPGO_KEEP_0__" + "设置后，" + "您可能会遇到一些常见错误。" + "以下是快速解决方法。","环境设置问题","" + "__CAPGO_KEEP_0__" + "未找到","错误","：命令" + "失败。","解决","：重新运行" + "并尝试再次。"]}

{"targetLanguage":"Simplified Chinese","protectedTokens":["Cloudflare","Capacitor","GitHub","Capgo","code","API","SDK","CLI","npm","bun"],"texts":["","Capgo" + "是兼容" + "Capacitor" + "8，" + "与CI/CD管道整合顺畅，" + "并符合苹果和谷歌商店要求。","常见问题和建议","" + "完成" + "Capgo" + "设置后，" + "您可能会遇到一些常见错误。" + "以下是快速解决方法。","环境设置问题","" + "Capgo" + "未找到","错误","：命令" + "失败。","解决","：重新运行" + "并尝试再次。"]}

{"targetLanguage":"Simplified Chinese","protectedTokens":["Cloudflare","Capacitor","GitHub","Capgo","code","API","SDK","CLI","npm","bun"],"texts":["","__CAPGO_KEEP_0" + "是兼容" + "CAPGO_KEEP_1" + "8，" + "与CI/CD管道整合顺畅，" + "并符合苹果和谷歌商店要求。","常见问题和建议","" + "完成" + "CAPGO_KEEP_0" + "设置后，" + "您可能会遇到一些常见错误。" + "以下是快速解决方法。","环境设置问题","" + "CAPGO_KEEP_0__" + "未找到","错误","：命令" + "失败。","解决","：重新运行" + "并尝试再次。"]}

{"targetLanguage":"Simplified Chinese","protectedTokens":["Cloudflare","Capacitor","GitHub","Capgo","code","API","SDK","CLI","npm","bun"],"texts":["","Capgo" + "是兼容" + "__CAPGO_KEEP_1__" + "8，" + "与CI/CD管道整合顺畅，" + "并符合苹果和谷歌商店要求。","常见问题和建议","" + "完成" + "Capgo" + "设置后，" + "您可能会遇到一些常见错误。" + "以下是快速解决方法。","环境设置问题","" + "Capgo" + "未找到","错误","：命令" + "失败。","解决","：重新运行" + "并尝试再次。"]}

{"targetLanguage":"Simplified Chinese","protectedTokens":["Cloudflare","Capacitor","GitHub","Capgo","code","API","SDK","CLI","npm","bun"],"texts":["","__CAPGO_KEEP_0" + "是兼容" + "CAPGO_KEEP_1" + "8，" + "与CI/CD管道整合顺畅，" + "并符合苹果和谷歌商店要求。","常见问题和建议","" + "完成" + "CAPGO_KEEP_0" + "设置后，" + "您可能会遇到一些常见错误。" + "以下是快速解决方法。","环境设置问题","" + "CAPGO_KEEP_0__" + "未找到","错误","：命令" + "失败。","解决","：重新运行" + "并尝试再次。"]}

{"targetLanguage":"Simplified Chinese","protectedTokens":["Cloudflare","Capacitor","GitHub","Capgo","code","API","SDK","CLI","npm","bun"],"texts":["","CLI" + "是兼容" + "__CAPGO_KEEP_1__" + "8，" + "与CI/CD管道整合顺畅，" + "并符合苹果和谷歌商店要求。","常见问题和建议","" + "完成" + "CLI" + "设置后，" + "您可能会遇到一些常见错误。" + "以下是快速解决方法。","环境设置问题","" + "CLI" + "未找到","错误","：命令" + "失败。","解决","：重新运行" + "并尝试再次。"]} {"targetLanguage":"Simplified Chinese","protectedTokens":["Cloudflare","Capacitor","GitHub","Capgo","code","API","SDK","CLI","npm","bun"],"texts":["","__CAPGO_KEEP_0__" + "是兼容" + "__CAPGO_KEEP_1__" + "8，" + "与CI/CD管道整合顺畅，" + "并符合苹果和谷歌商店要求。","常见问题和建议","" + "完成" + "__CAPGO_KEEP_0__" + "设置后，" + "您可能会遇到一些常见错误。" + "以下是快速解决方法。","环境设置问题","" + "__CAPGO_KEEP_0__" + "未找到","错误","：命令" + "失败。","解决","：重新运行" + "并尝试再次。"]}{"targetLanguage":"Simplified Chinese","protectedTokens":["Cloudflare","Capacitor","GitHub","Capgo","code","API","SDK","CLI","npm","bun"],"texts":["","__CAPGO_KEEP_0__" + "是兼容" + "__CAPGO_KEEP_1__" + "8，" + "与CI/CD管道整合顺畅，" + "并符合苹果和谷歌商店要求。","常见问题和建议","" + "完成" + "__CAPGO_KEEP_0__" + "设置后，" + "您可能会遇到一些常见错误。" + "以下是快速解决方法。","环境设置问题","" + "__CAPGO_KEEP_0__" + "未找到","错误","：命令" + "失败。","解决","：重新运行" + "并尝试再次。"]} npx cap {"targetLanguage":"Simplified Chinese","protectedTokens":["Cloudflare","Capacitor","GitHub","Capgo","code","API","SDK","CLI","npm","bun"],"texts":["","__CAPGO_KEEP_0__" + "是兼容" + "__CAPGO_KEEP_1__" + "8，" + "与CI/CD管道整合顺畅，" + "并符合苹果和谷歌商店要求。","常见问题和建议","" + "完成" + "__CAPGO_KEEP_0__" + "设置后，" + "您可能会遇到一些常见错误。" + "以下是快速解决方法。","环境设置问题","" + "__CAPGO_KEEP_0__" + "未找到","错误","：命令" + "失败。","解决","：重新运行" + "并尝试再次。"]} {"targetLanguage":"Simplified Chinese","protectedTokens":["Cloudflare","Capacitor","GitHub","Capgo","code","API","SDK","CLI","npm","bun"],"texts":["","__CAPGO_KEEP_0__" + "是兼容" + "__CAPGO_KEEP_1__" + "8，" + "与CI/CD管道整合顺畅，" + "并符合苹果和谷歌商店要求。","常见问题和建议","" + "完成" + "__CAPGO_KEEP_0__" + "设置后，" + "您可能会遇到一些常见错误。" + "以下是快速解决方法。","环境设置问题","" + "__CAPGO_KEEP_0__" + "未找到","错误","：命令" + "失败。","解决","：重新运行" + "并尝试再次。"]}{"targetLanguage":"Simplified Chinese","protectedTokens":["Cloudflare","Capacitor","GitHub","Capgo","code","API","SDK","CLI","npm","bun"],"texts":["","__CAPGO_KEEP_0__" + "是兼容" + "__CAPGO_KEEP_1__" + "8，" + "与CI/CD管道整合顺畅，" + "并符合苹果和谷歌商店要求。","常见问题和建议","" + "完成" + "__CAPGO_KEEP_0__" + "设置后，" + "您可能会遇到一些常见错误。" + "以下是快速解决方法。","环境设置问题","" + "__CAPGO_KEEP_0__" + "未找到","错误","：命令" + "失败。","解决","：重新运行" + "并尝试再次。"]} npm install --save @capacitor/cli @capacitor/core {"targetLanguage":"Simplified Chinese","protectedTokens":["Cloudflare","Capacitor","GitHub","Capgo","code","API","SDK","CLI","npm","bun"],"texts":["","__CAPGO_KEEP_0__" + "是兼容" + "__CAPGO_KEEP_1__" + "8，" + "与CI/CD管道整合顺畅，" + "并符合苹果和谷歌商店要求。","常见问题和建议","" + "完成" + "__CAPGO_KEEP_0__" + "设置后，" + "您可能会遇到一些常见错误。" + "以下是快速解决方法。","环境设置问题","" + "__CAPGO_KEEP_0__" + "未找到","错误","：命令" + "失败。","解决","：重新运行" + "并尝试再次。"]}
Node 版本不符 错误: CLI 命令因 Node.js 版本错误而失败。修复: 请按照设置要求安装 Node.js 版本 14 或更高版本。

配置问题

配置不符 错误: capacitor.config.json 的修改没有生效。修复: 确保 appId and webDir 与您的项目匹配的值 package.json 和 Web 构建输出文件夹。
平台同步错误 错误：运行 npx cap sync 导致插件版本冲突的结果修复：更新 @capacitor/android 和 @capacitor/ios 到相同的主要版本，然后重新运行同步命令

构建和部署

签名失败 错误: iOS 或 Android 构建因缺少证书或密钥库而失败。修复: 请遵循 IDE 配置指南。对于 iOS，需要在 Xcode 中添加开发团队。对于 Android，需要在 build.gradle.
未找到 Web 目录 错误: npx cap sync 无法找到 Web 资产。修复: 运行您的 Web 构建命令（例如 npm run build) before syncing the platforms.

Live Update Issues

Capgo 更新失败 错误：生产应用中更新未显示。修复：检查您的 Capgo API 在 capacitor.config.json 和确保您正在目标正确的渠道。

有关平台特定设置的更多详细信息，请参阅平台设置部分。如果您正在使用实时更新，请参阅Capgo 设置指南以获取更多故障排除提示。

概要

设置审查

使用Capacitor CLI启动您的Web应用，设置iOS和Android平台，并可选地包含Capgo进行实时更新。

开始的步骤如下：

使用 Capacitor CLI 初始化您的项目。
设置您的应用程序的包 ID 并定义 Web 输出目录。
添加 iOS 和 Android 平台的支持。
使用以下命令安装并设置 Capgo： npm install --save @capgo/cli && npx capgo init

有关详细的设置说明或故障排除，请参阅官方 Capacitor 和 Capgo 文档。

继续阅读 Capacitor CLI: 项目设置指南

如果您正在使用 Capacitor CLI: 项目设置指南 来规划仪表板和 API 操作，请将其与 API 概述连接，了解 API 概述中的实现细节简介简介中的实现细节 API Keys API Keys中的实现细节设备简介中的实现细节和设备设备和 __CAPGO_KEEP_0__

Capacitor CLI:项目设置指南