Capacitor 工作流程
使用 Capacitor 进行开发与传统的 Web 应用略有不同。要构建你的 Web 原生 Capacitor 应用程序,你需要完成以下步骤。
构建你的 Web 代码
当你准备好在移动设备上测试你的 Web 应用时,你需要构建你的 Web 应用以用于分发。如果你使用的是像 Create React App 或 Vite 这样的工具,命令是 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
我们还建议使用 Fastlane 或 Appflow 等云构建工具来自动化这些流程。虽然每个应用都有所不同,但我们提供了一个 Capacitor 项目通用发布流程的示例。请阅读我们的 iOS 和 Android 发布指南,了解更多关于如何部署到 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。