它在周五上线了!快照可在我们的下载页面上获取,但在下载之前,请继续阅读以了解新功能,包括更多使用 Cordova 的方式!
轻量级核心
Cordova 3 引入了新的统一项目结构,并提供非常有限的 API 表面。开发人员现在可以使用他们需要的 API 来组合 Cordova 的版本。过去,Cordova 附带了整个 API 大杂烩,而大多数应用程序只需要其中的一小部分。这导致了社区的混乱,而且往往是不必要的升级。在 Cordova 3 发布后,您将从一个非常轻量级的核心开始,并且只添加您的应用程序所需的 API 表面。显然,这意味着性能的提高,但真正的优势在于维护和升级。我们将继续维护“核心”API,这些 API 是您已经熟悉和喜爱的相同的设备 API。
新的命令行工具
我们非常兴奋地分享两个新的命令行工具:Cordova 和 Plugman。两者都使用 NodeJS
实现,因此通过 npm
分发。cordova
命令行工具已经酝酿了很长时间。它将所有平台统一到单个项目结构中,从而可以轻松地为多个平台维护单个代码库。cordova
工具建立在我们另一个新工具 plugman
的基础上,该工具提供核心和自定义插件的自动发现、安装和删除。
我们已经测试了几个月,但请记住这两个工具都是新的。可能会出现错误,因此,如果您发现错误,或者只是对新功能有想法,请访问我们的 问题跟踪器。
安装 > 下载
首先,确保您已安装 NodeJS,然后只需运行 npm install -g cordova
。从这里开始,它是一个典型的命令行实用程序。从构建一个 iOS 应用程序开始!
cordova create MyFunkyApp
cd MyFunkyApp
cordova platform add ios
cordova emulate ios
Cordova 必须在第一次运行 create
时下载平台文件,因此您创建的第一个应用程序可能会有点慢。只需使用 -d
标志查看进度。例如,cordova -d platform add ios
。也许可以喝杯啤酒放松一下,让它在第一次运行时完成它的工作。
现在让我们添加 Android,cordova platform add android
。是的:就这么简单!
安装插件
如果您直接使用平台项目(通过 Cordova 平台的 bin/create
脚本创建,而不是通过 cordova
工具),则可以单独使用 plugman
。同样,确保您已安装 NodeJS,然后只需运行 npm install -g plugman
。
cd MyFunkyApp
cordova plugin add https://git-wip-us.apache.org/repos/asf/cordova-plugin-geolocation.git
您现在已在您的项目中启用了地理定位!
如果您直接使用原生项目,则可以单独使用 plugman
。同样,确保您已安装 NodeJS,然后只需运行 npm install -g plugman
。
cd MyAndroidProject
plugman --platform android --project . --plugin https://git-wip-us.apache.org/repos/asf/cordova-plugin-geolocation.git
当然,您可以创建自己的插件!(我们非常期待看到您做什么。)您可以通过阅读插件开发指南来了解如何编写插件。我们将来会编写更多关于这方面的文档。同时,您可以查看核心插件来学习很多内容。
升级
我们已经记录了每个平台的升级指南,以帮助您进行过渡。当然,请随时在 freenode 上的 #cordova irc 频道中寻求帮助,或者访问我们的问题跟踪器。
已知问题
请记住,核心插件在新项目中不再默认存在,您必须使用 plugman
或 cordova
手动添加它们。您知道我们定期发布更新,所以您可以期待很快更新,我们将像往常一样为弃用留下一个很大的窗口。此外,请记住这是一个开源项目,所以如果有什么您不喜欢的地方,您可以随时参与并自己修复它!
- 当使用基于
cordova
的项目时,各种原生 IDE 会显示生成的文件。请注意不要编辑它们,否则您可能会在下次运行cordova
时丢失您的工作! - 白名单 (
<access>
标签) 格式在不同平台之间不一致 cordova
还没有“升级”命令。您现在需要删除并重新添加插件/平台。- 并非所有平台都受
cordova
支持。目前 仅支持 iOS、Android、BB10 和 Windows Phone - 插件发现存储库仍在构建中,很快就会推出
非常感谢
感谢所有提交者、测试人员、开发人员和 Cordova 的朋友们,是你们让这一切成为可能!