跳到主要内容
版本:v3

Capacitor 工作流

使用 Capacitor 工作需要在您的工作流中增加几个关键步骤。

开发并构建您的 Web 应用

Capacitor 将您的 Web 应用转换为每个平台的原生二进制文件。因此,您的大部分工作将包括开发和构建一个以移动端为主的 Web 应用。

您将使用 Capacitor 的插件(例如 Camera)或使用现有 Cordova 插件通过 Capacitor 的 Cordova 兼容性 与底层原生平台进行交互。

要将 Web 应用部署到原生设备,您首先需要将 Web 资源构建到输出目录中。请查阅您的 JavaScript 框架文档以获取确切的命令。对于大多数框架来说,命令是 npm run build

同步您的项目

在以下情况下,您可能希望将 Web 应用与原生项目同步:

  • 当您想要将 Web 资源复制到原生项目中时。
  • 在使用原生 IDE 运行项目之前。
  • 在安装新的 Capacitor 插件之后。
  • 在克隆项目之后。
  • 当您想要为 Capacitor 设置或重新配置原生项目时。
  • 当您想要安装原生依赖项时(例如使用 Gradle 或 CocoaPods)。

要同步项目,请运行:

npx cap sync

如果遇到无法找到 Web 资源目录的错误,您可能需要在 Capacitor 配置 中配置 webDir

了解更多关于 sync 的信息 ›

运行您的项目

有几种方法可以将项目部署到原生设备上,具体取决于您的用例。最常见的方式是使用命令行运行 npx cap run

了解更多关于在 iOS 上运行应用的信息 ›

了解更多关于在 Android 上运行应用的信息 ›

构建您的项目

在构建 Web 资源(例如使用 npm run build)并使用 npx cap sync 将其复制到原生项目后,您就可以构建原生二进制文件了。

Capacitor 没有 "build" 命令。在 sync 之后,建议您打开目标平台的 IDE 来构建原生应用。

对于在命令行或 CI 环境中构建应用,建议您使用目标平台的工具:Android 使用 Gradle,iOS 使用 xcodebuild。第三方工具如 Fastlane 可能会使这个过程更加简单。使用 Appflow 还可以实现云构建等功能。

要了解 Capacitor 的发布流程,请阅读 iOSAndroid 的发布指南。

打开原生 IDE

在以下情况下,您可能希望在原生 IDE(例如 Xcode 和 Android Studio)中打开项目:

  • 当您想使用 IDE 在原生设备上运行项目时。
  • 当您想调试原生 Java/Kotlin 或 Swift/Objective-C 代码时。
  • 当您想在应用的原生侧工作时。
  • 当您想为应用商店编译发布版本时。

了解更多关于在 Xcode 中打开应用的信息 ›

了解更多关于在 Android Studio 中打开应用的信息 ›

更新 Capacitor

要更新 Capacitor Core 和 CLI:

npm install @capacitor/cli
npm install @capacitor/core

要更新您正在使用的一个或多个平台:

npm install @capacitor/ios
npm install @capacitor/android

您可以订阅 Capacitor 仓库 以接收新版本通知。在仓库首页顶部,点击 Watch -> Releases only

钩子

需要介入 Capacitor CLI 命令事件吗?请查看这里的 钩子文档