Cordova 和 PhoneGap
Apache Cordova(以及 Adobe PhoneGap)创建于 2008 年,是一个开源项目,使 Web 开发者能够使用他们的 HTML、CSS 和 JavaScript 内容为各种移动和桌面平台创建原生应用。
有关 Cordova 的更多历史及其工作原理的更多细节,请参见此处。
为什么创建 Capacitor?
开源领域充满了在旧项目理念基础上构建的新项目,它们做出了如果不彻底改变原始产品就无法实现的实质性改进。Ionic 团队出于技术和政治原因,不想试图将这些根本性改变强行引入 Cordova。
Capacitor 项目的一个好处是 Ionic 团队对技术栈拥有更多控制权。当你使用 Ionic Framework 和 Capacitor 构建应用时,Ionic 团队是原生运行时层、UI 组件以及创建组件的工具链(Stencil)的维护者。这意义重大,因为 Ionic 团队可以更快地修复问题,并提供更一致的技术栈。
Capacitor 和 Cordova 的区别
从本质上讲,Capacitor 和 Cordova 非常相似。两者都管理一个 Web View,并提供一种结构化的方式将原生功能暴露给你的 Web 代码。然而,Capacitor 有一些关键区别,需要以前习惯使用 Cordova 方法的 Web 开发者改变应用开发工作流程。
原生项目管理
Capacitor 将每个平台项目视为源码资产而不是构建时资产。这意味着你需要将 Xcode 和 Android Studio 项目签入源代码管理,并在必要时使用这些 IDE 进行特定平台的配置和构建/测试。
这种方法的改变有几个含义。首先,Capacitor 不使用 config.xml 或类似的自定义配置来管理平台设置。相反,配置更改是通过直接编辑相应平台特定的配置文件来进行的,例如 Android 的 AndroidManifest.xml 和 iOS 的 Info.plist。Capacitor 确实有一些高级配置选项。但这些通常不修改原生功能,而是控制 Capacitor 的工具。
此外,Capacitor 不提供在命令行上构建原生应用的方式。应改用特定平台的工具(或 IDE),这提供了更快、更典型且符合该平台应用开发标准的体验。
虽然这些差异可能会让长期使用 Cordova 的用户感到担忧,但它们有值得注意的好处:
- 通过诸如
config.xml之类的抽象工具来更新和修改原生项目容易出错 ,且是一个不断变化的目标。更熟悉特定平台的工具可以让你更轻松地排查问题。 - 更容易添加应用所需的自定义原生代码,而无需在应用代码库之外构建专用插件。此外,原生团队可以与 Web 团队在同一个项目上协作。
- 由于你"拥有"原生项目,因此更容易创建更引人注目的应用体验,例如在 Web 应用周围添加原生 UI 外壳。
- 随着新移动操作系统版本的发布,原生项目变更的可见性更高,应用的可维护性更好。当 Capacitor 引入重大更改或对原生项目模板应用更改时,团队将发布逐步升级说明,以确保升级过程尽可能顺利。
插件管理
Capacitor 以与 Cordova 不同的方式管理插件。首先,Capacitor 在构建前不会将插件源代码复制到你的应用。相反,所有插件都作为"框架"(在 iOS 上)和"库"(在 Android 上)构建,并使用每个平台的主流依赖管理工具(分别是 CocoaPods 和 Gradle)进行安装。此外,Capacitor 不会修改原生源代码,因此任何必要的原生项目设置都必须手动添加(例如,AndroidManifest.xml 中的权限)。我们认为这种方法更不容易出错,并使开发者更容易在社区中找到针对每个特定平台的帮助。
一个主要区别是插件处理它们需要从 WebView 执行的 JavaScript 代码的方式。Cordova 要求插件附带自己的 JavaScript 并手动调用 exec()。相比之下,Capacitor 根据运行时检测到的原生方法为每个插件注册并导出所有 JavaScript,因此所有插件方法在 WebView 加载后即可使用。这有一个重要的含义:不再需要 deviceready 事件。一旦你 的应用代码加载完成,你就可以开始调用插件方法。
虽然 Capacitor 不要求插件为 iOS 或 Android 提供 JavaScript,但插件通常会在 JavaScript 中包含共享逻辑,这也很容易实现。
最后,Capacitor 对插件作者也有影响。在 iOS 上,Swift 5 被官方支持,甚至推荐用于构建插件(Objective-C 也受支持)。插件不再导出 Plugin.xml 文件;Capacitor 在 iOS 上提供几个简单的宏,在 Android 上提供注解,用于向插件源代码添加元数据,Capacitor 会在运行时读取这些元数据。
CLI/版本管理
与 Cordova 不同,Capacitor 不使用全局 CLI。相反,Capacitor CLI 作为 npm 脚本本地安装到每个项目中。这使得在多个不同应用之间管理 Capacitor 版本变得更加容易。
因此,Capacitor 不是直接从命令行运行,而是通过在应用目录中调用 npx cap 来使用。