Руководство по платформе 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, что требует регистрации как разработчика 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.)