想用一个代码库来构建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)
可选： 如果您想启用实时更新，请参阅下面的“Capgo Capgo设置指南” below.
CLI Capgo安装步骤
在开始之前，请确保您已经 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该命令安装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 设备上安装了 Xcode 14 或更高版本、CocoaPods 1.11 或更新版本，以及 macOS 12 或更高版本。对于 Android 设备，您需要 Android Studio Giraffe (2022.3.1+)、JDK 17 或更高版本，以及 Gradle 7.5 或更高版本。 CocoaPods 1.11 或更新版本 确保 Android 设备上安装了 Android Studio Giraffe (2022.3.1+)、JDK 17 或更高版本，以及 Gradle 7.5 或更高版本。 更新本地目标以反映您的 Web 应用程序的更改。
平台更新
同步您的平台以反映最新的 Web 更改，请按照以下步骤更新您的 Web 应用程序后：
该命令处理两个任务：
npm run build
npx cap sync将更新的 Web 资产复制到本机平台 cap sync 更新本机配置和插件以匹配最新的更改
- 将更新的 Web 资产复制到本机平台
- 更新本机配置和插件以匹配最新的更改
IDE 配置
打开适当的 IDE 中的平台特定项目:
npx cap open ios # Opens Xcode
npx cap open android # Opens Android Studio在 Xcode 中:
- 选择您的开发团队。
- 设置签名证书。
- 更新您的包标识符。
在 Android Studio 中:
- 修改应用程序 ID 在
build.gradle. - 配置用于签名的 keystore。
- 设置调试和发布构建变体。
当一切配置好后，使用 npx cap build ios 或 npx cap build android. 不要忘记重新运行以确保所有资产都是最新的。 npx cap sync __CAPGO_KEEP_0__
Capgo __CAPGO_KEEP_0__ Live Update Dashboard Interface
Set up Capgo to enable instant over-the-air updates for your app.
Key Features of Capgo
Capgo offers several tools to streamline app updates:
- 确保更新的安全传递。 更新
- 在后台运行 在后台 当应用程序启动时。
- Analytics工具 帮助跟踪更新成功率和用户参与度。
- A 一个点击回滚 选项让您快速从有问题的更新中恢复。
- 使用 渠道系统 进行分阶段发布和beta测试。
安装Capgo
以下是开始使用Capgo:的步骤。
-
npm install --save @capgo/cli -
初始化 Capgo 在您的项目中:
npx capgo init -
构建和发布更新:
npm run build npx capgo release -
打开应用程序以触发后台更新过程。
最佳实践
- 使用渠道测试更新之前将其推送给所有用户。
- 监控分析以确保更新成功并且用户保持活跃。
- 启用错误跟踪以及早捕获和修复问题。
- 保持回滚功能以快速解决任何问题。
Capgo 与 Capacitor 8 兼容，集成 CI/CD pipeline 流程并符合苹果和谷歌商店要求。
常见问题和提示
完成平台和 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 构建因缺少证书或密钥库而失败。 修复:按照IDE的设置指南进行操作。对于iOS，需要在Xcode中添加开发团队。对于Android，需要在keystore中配置
build.gradle. -
Web目录未找到 错误:
npx cap sync无法找到Web资源。 修复:在同步平台之前，运行您的Web构建命令（例如npm run build)
实时更新问题
有关平台特定设置的更多详细信息，请重新访问 Platform Setup 部分。如果您正在使用实时更新，请参阅 Capgo Setup Guide 以获取更多故障排除提示。
概要
设置审查
使用 Capacitor CLI 启动您的 Web 应用，设置 iOS 和 Android 平台，并可选地包含 Capgo 以支持实时更新。
以下是如何开始：
- 使用 Capacitor CLI 初始化您的项目。
- 设置应用的包 ID 并定义 Web 输出目录。
- 添加 iOS 和 Android 平台支持。
- 使用以下命令安装并设置 Capgo:
npm install --save @capgo/cli && npx capgo init
详细的设置说明或解决方案，请参阅官方 Capacitor 和 Capgo 文档。
