OS X 平台指南

本指南将向你展示怎样在OS X电脑上搭建SDK开发环境部署Cordova应用。更多详细的平台相关的信息如下:

上面提到的命令行工具适用于Cordova 3.0之前的版本。当前的版本请查看创建你的第一个App来获取更多信息。

需求和支持

要构建OS X应用需要使用苹果提供的工具,这些工具只能运行在安装了OS X操作系统的基于Intel的Mac设备上。Xcode 6.0是需要安装的最低版本,只能运行在OS X 10.9(Mavericks)及以上.若要提交app到App Store则需要最新版的苹果工具。

你可以使用XCode或者其他IDE(例如JetBrain的 AppCode)来测试所有的Cordova特性。但是你需要在提交到App Store之前使用XCode注册App,要注册你就必须是苹果OS X Developer Program的一员。

安装SDK

下载Xcode有两种方式:

Xcode安装完之后,需要启用一些命令行工具来使Cordova正常运行。打开Xcode菜单,选择PreferencesDownloadsComponents,然后点击Command Line Tools列表之后的Install按钮。

创建新项目

创建你的第一个App已经中已经描述了如果使用cordova来创建一个新项目。例如,在源码目录中:

$ cordova create hello com.example.hello "HelloWorld"
$ cd hello
$ cordova platform add osx
$ cordova prepare              # or "cordova build"

启动app

在你的电脑上运行app:

$ cordova run

然后你应该发现这个示例app出现在一个带边框的窗口之中:

你可以使用cordova run --help命令来查看更多构建和运行选项。

在SDK中打开项目

如果你的项目中添加了osx平台,那么你可以使用Xcode打开它。双击打开hello/platforms/osx/HelloWorld.xcodeproj文件。屏幕会显示如下:

TIP 你也可以在命令行中使用open命令直接打开Xcode项目:

$ open platforms/osx/HelloWorld.xcodeproj

常见问题

弃用警告:当一个API被修改或者被其他API代替,它就会被标识为deprecated。在近期的版本中这个API还能使用,但它最终会被移除。Apache Cordova中存在一些弃用API,当你构建和部署应用的时候Xcode会显示警告信息。

头部缺失:和头部缺失相关的编译错误是由构建位置问题引起的,可以通过配置Xcode参数解决:

  1. 选择 Xcode → Preferences → Locations

  2. Derived Data选项部分,点击Advanced按钮,然后选择Unique作为构建位置,如下:

这是新版Xcode的默认设置,但是从旧版升级的Xcode,配置可能会有所不同。

更多信息请查看苹果官方文档:

  • 用户中心首页提供了一些OS X的资源,包括技术资源,配置门户,分布指南,社区论坛。

  • Xcode用户指南

  • xcode-select命令,可以帮助指定正确的Xcode版本,当安装了多个Xcode的时候。 (Mac®, OS X®, Apple®, Xcode®, App Store℠, iPad®, iPhone®, iPod® and Finder® are Trademarks of Apple Inc.)