Capacitor CLI: 移动应用设置指南

想用一个代码库建立 iOS 和 Android 应用吗? Capacitor CLI 简化了流程，让您使用 web 技术创建原生应用。以下是您将要学习的内容：

快速设置: 安装 Capacitor CLI 并在几分钟内初始化您的项目。
平台集成: 使用简单的命令添加 iOS 和 Android 支持。
实时更新: 使用 __CAPGO_KEEP_0__ 实现即时的无线更新。 Capgo : troubleshoot sync 错误或构建失败等问题。
开始的关键步骤：__CAPGO_KEEP_0__

Live Updates: Use __CAPGO_KEEP_0__ for instant over-the-air updates.

安装 Node.js, npm, JDK, Xcode, 和 Android Studio.
运行并初始化您的项目。 npm install @capacitor/core @capacitor/cli 使用
和 npx cap add ios 可选：设置__CAPGO_KEEP_0__用于实时 npx cap add android.
Optional: Set up Capgo for live 应用.

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__ 框架文档网站

Capacitor Framework Documentation Website

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

Node.js

(版本 14 或更高版本) 和 __CAPGO_KEEP_0__ npm
__CAPGO_KEEP_1__ （版本 11 或更新版本）
Xcode （版本 12 或更新版本用于 iOS 构建）
Android Studio （用于 Android 构建）
Capacitor CLI （版本 6 或 7）

可选： 如果您想启用实时更新，请参阅下面的“Capgo 安装指南”。

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 的关键功能

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

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

安装 Capgo

开始使用 Capgo 的步骤如下：

安装 Capgo CLI:
```
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 API 在 capacitor.config.json 并确保您正在目标正确的渠道。

有关平台特定设置的更多详细信息，请重新访问 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文档。

从Capacitor CLI: 项目设置指南继续:

如果您正在使用 Capacitor CLI: 项目设置指南 规划仪表板和API操作时，请将其与 API概述在API概述中了解实现细节：介绍在介绍中了解实现细节： API密钥在API密钥中了解实现细节：设备关于设备的实现细节, 捆绑包关于捆绑包的实现细节,