Руководство по платформе OS X

Это руководство показывает, как настроить среду разработки SDK для развертывания приложений Cordova на компьютерах с ОС OS X. Для получения более подробной информации по конкретной платформе см.:

• Настройка OS X
• Плагины OS X

Инструменты командной строки выше относятся к версиям до Cordova 3.0. Для получения информации о текущем интерфейсе см. Интерфейс командной строки.

Требования и поддержка

Инструменты Apple®, необходимые для создания приложений OS X, работают только на операционной системе OS X на компьютерах Mac с процессорами Intel. Xcode® 6.0 (минимальная требуемая версия) работает только на OS X версии 10.9 (Mavericks) или выше и включает SDK OS X (пакет разработки программного обеспечения). Для отправки приложений в App Store℠ требуется использование последних версий инструментов Apple.

Вы можете протестировать все функции Cordova, используя XCode или любой другой IDE, такой как AppCode от JetBrain, но для подписания перед отправкой в App Store необходимо использовать XCode. Для подписания приложений вы также должны быть членом программы Разработчика OS X Apple.

Установка SDK

Есть два способа загрузить Xcode:

• из App Store, доступного по поиску «Xcode» в приложении App Store.

• с сайта Apple Developer Downloads, что требует регистрации как разработчика Apple.

После установки Xcode необходимо включить несколько инструментов командной строки для работы Cordova. В меню Xcode выберите Настройки, а затем вкладку Загрузки. В панели Компоненты нажмите кнопку Установить рядом с элементом Инструменты командной строки.

Создание нового проекта

Используйте утилиту cordova для настройки нового проекта, как описано в разделе Интерфейс командной строки Cordova по адресу Интерфейс командной строки. Например, в каталоге исходного кода:

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

Запуск приложения

Для запуска приложения на вашем рабочем столе:

$ cordova run

И вы должны увидеть окно с примерами приложения с рамками:

Вы также можете использовать cordova run --help, чтобы увидеть дополнительные параметры сборки и запуска.

Открытие проекта в SDK

После добавления платформы osx к вашему проекту вы можете открыть его в Xcode. Дважды щелкните, чтобы открыть файл hello/platforms/osx/HelloWorld.xcodeproj. Экран должен выглядеть так:

СОВЕТ Вы также можете использовать команду open для открытия проекта Xcode непосредственно из командной строки:

$ open platforms/osx/HelloWorld.xcodeproj

Общие проблемы

Предупреждения о устаревании: Когда интерфейс программирования приложений (API) изменяется или заменяется другим API, он помечается как устаревший. API всё ещё работает в ближайшем будущем, но в конечном итоге будет удалён. Некоторые из этих устаревших интерфейсов отражены в Apache Cordova, и Xcode выдаёт предупреждения об них при сборке и развертывании приложения.

Отсутствующие заголовки: Ошибки компиляции, связанные с отсутствием заголовков, возникают из-за проблем с расположением сборки и могут быть исправлены через настройки Xcode:

1. Выберите Xcode → Настройки → Местоположения.

2. В разделе Данные сборки нажмите кнопку Дополнительно и выберите Уникальное в качестве Расположения сборки, как показано здесь:

Это значение по умолчанию для новой установки Xcode, но оно может быть установлено по-другому после обновления с более старой версии Xcode.

Для получения дополнительной информации ознакомьтесь с документацией Apple:

• Главная страница центра участников содержит ссылки на различные технические ресурсы OS X, включая технические ресурсы, портал подготовки, руководства по распространению и форумы сообщества.

• Руководство пользователя Xcode

• Команда xcode-select, которая помогает указать правильную версию Xcode, если установлено несколько версий.

(Mac®, OS X®, Apple®, Xcode®, App Store℠, iPad®, iPhone®, iPod® и Finder® — товарные знаки Apple Inc.)