Capacitor CLI：项目设置指南

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

快速设置: 安装 Capacitor CLI 并在几分钟内初始化您的项目。
平台集成: 使用简单的命令添加 iOS 和 Android 支持。
实时更新: 在首页问题/解决方案部分，角色：标题或页面标题。见于：页面 premium-support.astro。消息键 `ps_help_updates_title` (Ps Help Updates Title)。 Capgo __CAPGO_KEEP_0__
: 在 Capgo 市场网站的 UI 字符串中保留 Capgo 产品/品牌和开发者术语。页面/区域：Capgo 市场网站。角色：网站副本句子。见于：页面 contributing.astro。实时更新

: 即时进行远程更新。

安装 Node.js, npm, JDK Xcode, 和 Android Studio.
运行 npm install @capacitor/core @capacitor/cli 并初始化您的项目。
使用 npx cap add ios 和 npx cap add android.
Optional: 配置Capgo 实时应用更新.

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

介绍 Capacitor 配置

Capacitor 框架文档网站

设置要求

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

Node.js (版本 14 或更高) 和 npm
Java JDK (版本 11 或更新)
Xcode (版本 12 或更新，仅限 iOS 构建)
Android Studio (仅限 Android 构建)
Capacitor CLI 可选：

如果您想启用实时更新，请参阅“ __CAPGO_KEEP_0__ 设置指南“Capgo Setup Guide__CAPGO_KEEP_0__ 安装步骤

CLI __CAPGO_KEEP_1__

在开始之前，请确保您有 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，确保您有 Xcode 14 或更高版本， CocoaPods 1.11 或更高版本，和 macOS 12 或更高版本。对于 Android，您需要 Android Studio Giraffe (2022.3.1+)，JDK 17 或更高版本，和 Gradle 7.5 或更高版本。

安装后，您需要将本机目标更新为与您的 Web 应用程序的更改保持同步。

平台更新

同步您的平台以获取最新的 Web 更改，请按照以下步骤更新您的 Web 应用程序后：

npm run build
npx cap sync

该 cap sync 命令处理两个任务：

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

IDE 配置

打开适当的 IDEs 中的平台特定项目:

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

在 Xcode 中:

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

在 Android Studio 中:

修改应用程序 ID 在 build.gradle.
配置用于签名的密钥库。
设置调试和发布构建变体。

当一切配置好时，使用 npx cap build ios 或 npx cap build android请再次运行 npx cap sync 确保所有资产都处于最新状态。

Capgo Capacitor CLI项目设置指南

Capgo实时更新控制台界面

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

Key Features of Capgo

Capgo实时更新控制台界面

__CAPGO_KEEP_0__功能 __CAPGO_KEEP_0__提供了多种工具来简化应用程序更新:
端到端加密 确保更新的安全传递。 当应用程序启动时。
分析工具 帮助跟踪更新成功率和用户参与度。
A 一个点击回滚
选项让您快速恢复从有问题的更新。使用频道系统

Installing Capgo

Follow these steps to get started with Capgo:

Install the 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 context: Capgo营销网站。角色：短UI标签或导航项。见于：页面trust.astro。消息键 `and` (And)。

到同一主要版本，然后重新运行同步命令。

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

实时更新问题

Capgo 更新失败 错误: 在生产应用程序中更新未出现。修复: 检查您的 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 文档。