想用一个代码库来建立 iOS 和 Android 应用吗? Capacitor CLI 简化了流程，让您使用 web 技术创建原生应用。以下是您将要学习的内容：
- 快速设置: 安装 Capacitor CLI 并在几分钟内初始化您的项目。
- 平台集成: 使用简单的命令添加 iOS 和 Android 支持。
- 实时更新: 使用 __CAPGO_KEEP_0__ 实现即时的无线更新。 Capgo : troubleshoot sync 错误或构建失败等问题。
- 开始的关键步骤：__CAPGO_KEEP_0__
__CAPGO_KEEP_1__
- 安装 Node.js, npm, JDK, Xcode, 和 Android Studio.
- 运行
npm install @capacitor/core @capacitor/cli并初始化您的项目。 - 使用
npx cap add ios和npx cap add android. - 可选：设置Capgo用于实时 应用程序更新.
This guide covers everything you need to set up Capacitor CLI, configure platforms, and deploy your app. Let’s dive in!
介绍 Capacitor __CAPGO_KEEP_0__ 框架文档网站
开始之前，请确保已安装以下工具:
Node.js
- (版本 14 或更高) 和 __CAPGO_KEEP_0__ npm
- __CAPGO_KEEP_1__ (version 11 or newer)
- Xcode (version 12 or newer for iOS builds)
- Android Studio (for Android builds)
- Capacitor CLI (version 6 or 7)
Optional: 如果您想启用实时更新，请参阅以下“Capgo Capgo设置指南” below.
CLI 安装步骤
在开始之前，请确保您已经安装了 Node.js, npm, JDK, Xcode，和 Android Studio 设置好。准备好后，您可以通过运行以下命令来安装Capacitor CLI：
npm install --save @capacitor/core @capacitor/cli
npx cap init该命令将安装Capacitor并设置其核心组件。
完成此步骤后，请转到 创建新项目 来为您的应用程序搭建基础结构。
创建一个新项目
开始使用您的项目 使用 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 文件以包含以下设置：
{
"appId": "com.company.app",
"appName": "My App",
"webDir": "dist",
"bundledWebRuntime": false,
"server": {
"hostname": "app.example.com",
"androidScheme": "https"
}
}更新后，使用此配置文件为您的项目设置 Capacitor。
平台设置
现在项目骨架已经完成，是时候设置 iOS 和 Android 目标了。
添加 iOS 和 Android
首先使用 Capacitor CLI 安装必要的平台特定包
npm install @capacitor/ios @capacitor/android
npx cap add ios
npx cap add android确保您有 iOS 14 或更高版本的 Xcode、CocoaPods 1.11 或更高版本，以及 macOS 12 或更高版本。 CocoaPods 1.11 或更高版本 对于 Android，需要 Android Studio Giraffe（2022.3.1+）、JDK 17 或更高版本，以及 Gradle 7.5 或更高版本。 Gradle
7.5 或更高版本
安装后，您需要将本机目标更新为与您的 Web 应用程序的更改保持同步。
平台更新
npm run build
npx cap sync同步您的平台以获取最新的 Web 更改，请按照以下步骤更新您的 Web 应用程序后： cap sync 命令处理两个任务：
- 将更新的 Web 资产复制到本机平台
- 更新本机配置和插件以匹配最新的更改
IDE 配置
打开适当的 IDEs 中的平台特定项目：
npx cap open ios # Opens Xcode
npx cap open android # Opens Android Studio在 Xcode 中：
- 选择您的开发团队。
- 设置签名证书。
- 更新您的包标识符。
在 Android Studio 中：
- 修改应用程序 ID 在
build.gradle. - 配置用于签名的.keystore 文件。
- 设置 debug 和 release 构建变体。
当一切配置好时，使用 npx cap build ios 或 npx cap build android. 不要忘记重新运行 npx cap sync 以确保所有资产都处于最新状态。
Capgo 设置指南
设置 Capgo 以启用实时的线上更新功能。
Capgo 的关键功能
Capgo 提供了多种工具来简化应用程序更新：
- 端到端加密 确保更新的安全传递。
- 更新 在后台运行 应用启动时。
- 分析工具 帮助跟踪更新成功率和用户参与度。
- A 一个单击回滚 选项让您快速恢复从有问题的更新。
- 使用 渠道系统 进行分阶段发布和测试。
安装 Capgo
按照以下步骤开始使用 Capgo:
-
npm install --save @capgo/cli -
初始化 Capgo 在您的项目中：
npx capgo init -
构建和发布更新：
npm run build npx capgo release -
打开应用程序以触发后台更新过程。
最佳实践
- 使用渠道来测试更新之前将其推送给所有用户。
- 监控分析以确保更新成功并且用户保持活跃。
- 启用错误跟踪以及早捕获和修复问题。
- 保持回滚功能以快速解决任何问题。
Capgo 兼容 Capacitor 8，集成CI/CD管道，符合苹果和谷歌商店要求。
常见问题和提示
完成平台和Capgo设置后，您可能会遇到一些常见错误。以下是快速解决它们的方法。
环境设置问题
-
CLI 未找到 错误: 命令
npx cap失败。 修复: 运行npm install --save @capacitor/cli @capacitor/core并再次尝试。 -
Node 版本不符 错误: CLI 命令由于 Node.js 版本错误而失败。 修复: 安装 Node.js 版本 14 或更高版本，详见设置要求。
配置问题
-
配置不匹配 错误: 修改
capacitor.config.json不会生效。 修复: 确保appId和webDir与项目的package.json和 Web 构建输出目录匹配。 -
平台同步错误 错误: 运行
npx cap sync会导致插件版本冲突。 修复: 更新@capacitor/android和@capacitor/ios到相同的主要版本号，然后重新运行同步命令。
构建和部署
-
构建签名失败 错误: iOS 或 Android 构建因缺少证书或密钥库而失败。 修复:
build.gradle. -
请遵循IDE设置指南。对于iOS，添加您的开发团队在Xcode中。对于Android，配置keystore在 Web目录未找到:
npx cap sync错误 无法找到Web资源。修复npm run build: 运行您的Web构建命令（例如
)之前同步平台。
- Capgo Update Failures
__CAPGO_KEEP_0__ 更新失败错误
: 在生产应用程序中更新没有出现。: 检查一下 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概述中的实现细节在 __CAPGO_KEEP_0__概述 了解实现细节的介绍 API密钥 了解API密钥中的实现细节, 设备 为设备的实现细节，和 捆绑包 为捆绑包的实现细节，。
