跳到主要内容
版本:v8

Capacitor 工作流程

使用 Capacitor 进行开发与传统的 Web 应用略有不同。要构建你的 Web 原生 Capacitor 应用程序,你需要完成以下步骤。

构建你的 Web 代码

当你准备好在移动设备上测试你的 Web 应用时,你需要构建你的 Web 应用以用于分发。如果你使用的是像 Create React AppVite 这样的工具,命令是 npm run build;而像 Angular 这样的工具则使用命令 ng build。无论你的命令是什么,你都需要构建你的 Web 代码以用于分发,才能与 Capacitor 一起使用。

将 Web 代码同步到 Capacitor 项目

当你的 Web 代码已构建完成可用于分发后,你需要将 Web 代码推送到 Web 原生 Capacitor 应用程序中。为此,你可以使用 Capacitor CLI 来"同步"你的 Web 代码并安装/更新所需的原生依赖。

要同步你的项目,请运行:

npx cap sync

运行 npx cap sync 会将你已经构建好的 Web 资源包复制到你的 Android 和 iOS 项目中,同时更新 Capacitor 所使用的原生依赖。

你可以阅读我们的文档了解 sync 命令的更多信息,以及查阅 Capacitor CLI 参考文档。

信息

你是否遇到了"找不到 Web 资源目录"的错误?请更新你的 Capacitor 配置文件,使用正确的 webDir

测试你的 Capacitor 应用

将 Web 资源包同步到原生项目后,就可以在移动设备上测试你的应用了。有几种不同的方法可以实现这一点,但最简单的方式是使用内置的 Capacitor CLI 命令。

要在 iOS 设备上运行 Capacitor 应用的调试构建,请运行:

npx cap run ios

同样地,要在 Android 设备上运行调试构建,请运行:

npx cap run android

当你完成迭代和测试后,就可以编译最终的二进制文件以分发到其他移动设备了。

信息

你也可以通过 Xcode 在 iOS 上运行你的应用通过 Android Studio 在 Android 上运行你的应用。两种方式都适用于开发。不妨都试一下,看看你更喜欢哪种方式!

打开你的原生 IDE

如果你希望对原生项目有更多控制,可以使用 Capacitor CLI 快速打开原生 IDE。

在 Xcode 中打开 iOS Capacitor .xcworkspace 项目,请运行:

npx cap open ios

同样地,要在 Android Studio 中打开 Android Capacitor 项目,请运行:

npx cap open android

打开原生项目可以让你完全控制应用程序的原生运行时。你可以创建插件添加自定义原生代码编译你的应用程序以用于发布。

编译你的原生二进制文件

sync 之后,建议你打开目标平台的 IDE:iOS 使用 Xcode,Android 使用 Android Studio,以编译你的原生应用。

或者,要在终端或 CI 环境中编译你的应用,可以使用 cap build 命令来构建原生项目,输出签名后的 AAB、APK 或 IPA 文件,以便分发到设备或最终用户。

npx cap build android

我们还建议使用 FastlaneAppflow 等云构建工具来自动化这些流程。虽然每个应用都有所不同,但我们提供了一个 Capacitor 项目通用发布流程的示例。请阅读我们的 iOSAndroid 发布指南,了解更多关于如何部署到 Apple App Store 或 Google Play Store 的信息。

更新 Capacitor

更新 Capacitor 运行时就像运行 npm install 一样简单。

npm i @capacitor/core @capacitor/ios @capacitor/android
npm i -D @capacitor/cli

更新 Capacitor 时,你需要确保 Core、Android 和 iOS 库的版本相同。Capacitor Core、Android 和 iOS 版本是同时发布的,这意味着如果你同时安装所有库,版本就会保持一致!

信息

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