Capacitor CLI: 项目设置指南

想用一个代码库来构建 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__ 框架文档网站

Capacitor Framework Documentation Website

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

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 并设置其核心组件。

完成此步骤后，请转到 Creating a New Project 来为您的应用程序创建一个新项目。

创建一个新项目

开始使用您的项目使用 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 更新本机配置和插件以匹配最新的更改

更新
命令处理两个任务：

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 设置指南

Capgo 实时更新控制台界面

设置 Capgo 以启用对应用程序的即时、无线更新功能。

Capgo 的主要功能

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

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

安装 Capgo

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

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

最佳实践

使用渠道来测试更新之前将其发布给所有用户。
监控分析以确保更新成功并用户保持活跃。
启用错误跟踪以及早捕获和修复问题。
保持回滚功能以快速解决任何问题。

Capgo 兼容 Capacitor 8，集成顺畅的 CI/CD pipeline，并符合 Apple 和 Google 商店要求。

常见问题和提示

完成平台和 Capgo 设置后，您可能会遇到一些常见错误。以下是快速解决它们的方法。

环境设置问题

CLI 未找到 错误: 命令 npx cap 执行失败。修复: 运行 npm install --save @capacitor/cli @capacitor/core 并再次尝试。
Node.js 版本不符 错误: 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)

实时更新问题

Capgo更新失败 错误:更新未出现在生产应用程序中。修复: Double-check your 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密钥在API密钥中了解实现细节设备关于设备的实现细节捆绑包关于捆绑包的实现细节