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

Это руководство показывает, как настроить среду разработки SDK для развертывания приложений Cordova на устройствах iOS, таких как iPhone и iPad, а также как использовать утилиты командной строки, ориентированные на iOS, в процессе разработки. Вам необходимо установить инструменты SDK независимо от того, хотите ли вы использовать эти утилиты командной строки, ориентированные на платформу, или кроссплатформенный CLI Cordova для разработки. Сравнение этих двух путей разработки можно найти в Обзоре. Подробные сведения о CLI можно найти в Справочнике по Cordova CLI.

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

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

Вы можете протестировать многие функции Cordova с помощью эмулятора iOS, установленного вместе с iOS SDK и Xcode, но вам потребуется реальное устройство для полного тестирования всех функций приложения на устройстве перед отправкой в App Store. Устройство должно иметь не менее iOS 8, минимальную поддерживаемую версию iOS по состоянию на Cordova 4.0.0. Поддерживаемые устройства включают iPhone 4S, iPhone 5, iPhone 5C, iPhone 5S, iPhone 6, iPhone 6 Plus, iPhone 6S, iPhone 6S Plus, iPhone SE, iPad 2, iPad 3, iPad 4, iPad Air, iPad Air 2, iPad Pro, iPad Mini, iPad Mini 2, iPad Mini 3, iPod Touch 5-го поколения и iPod Touch 6-го поколения или более поздних.

Установка требований

Xcode

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

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

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

После установки Xcode для работы Cordova необходимо включить несколько инструментов командной строки. В командной строке выполните:

$ xcode-select --install

Инструменты развертывания

Инструменты ios-deploy — позволяют запускать приложения iOS на устройстве iOS из командной строки.

Для установки выполните следующее из командной строки:

$ npm install -g ios-deploy

Настройка проекта

Установка Xcode в основном настроит все необходимое для начала работы с нативным кодом. Теперь вы сможете создавать и компилировать проект Cordova. Более подробные сведения об установке и использовании CLI см. в руководстве Создание первого приложения.

Развертывание в эмуляторе

Чтобы предварительно просмотреть приложение в эмуляторе iOS:

1. Откройте файл проекта из Xcode и убедитесь, что в левой панели выбран файл .xcodeproj.

2. Выберите приложение hello в панели непосредственно справа.

3. Выберите целевое устройство из меню Схема панели инструментов, например, iPhone 6.0 Simulator, как показано здесь:

1. Нажмите кнопку Запуск, которая появляется в той же панели инструментов слева от Схема. Это скомпилирует, развернет и запустит приложение в эмуляторе. Откроется отдельное приложение эмулятора для отображения приложения:

Одновременно может работать только один эмулятор, поэтому если вы хотите протестировать приложение в другом эмуляторе, необходимо закрыть приложение эмулятора и запустить другой целевой объект в Xcode.

Xcode поставляется с эмуляторами последних версий iPhone и iPad. Более старые версии могут быть доступны в панели Xcode → Preferences → Downloads → Components.

Развертывание на устройстве

Подробные сведения о различных требованиях к развертыванию на устройстве см. в разделе «Запуск приложения на устройствах» в документе Apple О рабочих процессах распространения приложений. Вкратце, вам необходимо выполнить следующие действия перед развертыванием:

1. Создайте Профили профилей в Портале профилей iOS. Вы можете использовать Ассистент создания профилей разработки для создания и установки профиля и сертификата, необходимые Xcode.

2. Убедитесь, что значение параметра Код подписи идентификатора в разделе Подпись кода в параметрах сборки установлено на имя вашего профиля профилей.

Для развертывания на устройстве:

1. Подключите устройство к вашему Mac с помощью USB-кабеля.

2. Выберите имя проекта в раскрывающемся списке Схема окна Xcode.

3. Выберите ваше устройство из раскрывающегося списка Устройство. Если оно подключено через USB, но по-прежнему не отображается, нажмите кнопку Organizer, чтобы устранить любые ошибки.

4. Нажмите кнопку Запустить, чтобы скомпилировать, развернуть и запустить приложение на вашем устройстве.

Подпись приложения

Сначала вы должны ознакомиться со страницей поддержки подписи кода и рабочими процессами распространения приложений.

Использование флагов

Для подписи приложения вам потребуются следующие параметры:

Использование build.json

В качестве альтернативы, вы можете указать их в файле конфигурации сборки (build.json) с помощью аргумента --buildConfig для тех же команд. Вот пример файла конфигурации сборки:

{
    "ios": {
        "debug": {
            "codeSignIdentity": "iPhone Development",
            "provisioningProfile": "926c2bd6-8de9-4c2f-8407-1016d2d12954",
            "developmentTeam": "FG35JLLMXX4A",
            "packageType": "development"
        },
        "release": {
            "codeSignIdentity": "iPhone Distribution",
            "provisioningProfile": "70f699ad-faf1-4adE-8fea-9d84738fb306",
            "developmentTeam": "FG35JLLMXX4A",
            "packageType": "app-store"
        }
    }
}

Флаги сборки Xcode

Если у вас есть специальный случай, когда вам нужно передать дополнительные флаги сборки Xcode, — вы должны использовать один или несколько --buildFlag параметров для передачи этих флагов в xcodebuild. Если вы используете встроенный флаг xcodebuild, будет отображено предупреждение.

cordova build --device --buildFlag="MYSETTING=myvalue" --buildFlag="MY_OTHER_SETTING=othervalue"
cordova run --device --buildFlag="DEVELOPMENT_TEAM=FG35JLLMXX4A" --buildFlag="-scheme TestSchemeFlag"

Отладка

Подробные сведения об инструментах отладки, поставляемых с Xcode, см. в этой статье и этом видео.

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

Проекты Cordova для iOS могут быть открыты в Xcode. Это может быть полезно, если вы хотите использовать встроенные в Xcode инструменты отладки/профилирования или разрабатываете плагины iOS. Обратите внимание, что при открытии проекта в Xcode рекомендуется НЕ редактировать код в IDE. Это приведет к редактированию кода в папке platforms вашего проекта (а не в www), и изменения могут быть перезаписаны. Вместо этого, редактируйте папку www и копируйте изменения, выполнив cordova build.

Разработчики плагинов, желающие редактировать свой нативный код в IDE, должны использовать флаг --link при добавлении своего плагина в проект с помощью cordova plugin add. Это позволит связать файлы таким образом, чтобы изменения в файлах плагина в папке platforms отражались в папке исходного кода вашего плагина (и наоборот).

После добавления платформы ios в ваш проект и компиляции с помощью cordova build, вы можете открыть его в Xcode. Дважды щелкните, чтобы открыть файл ${PROJECT_NAME}/platforms/ios/${PROJECT_NAME}.xcodeproj. Экран должен выглядеть так:

Рабочий процесс, ориентированный на платформу

cordova-ios включает в себя ряд скриптов, которые позволяют использовать платформу без полного Cordova CLI. Этот путь разработки может предоставить вам больший спектр вариантов разработки в определенных ситуациях по сравнению с кроссплатформенным CLI Cordova. Например, вам необходимо использовать инструменты командной строки при развертывании пользовательской Cordova WebView вместе с нативными компонентами. Перед использованием этого пути разработки необходимо настроить среду SDK, как описано в разделе Требования и поддержка выше.

Для каждого из обсуждаемых ниже скриптов см. Справочник по Cordova CLI для получения дополнительной информации об их аргументах и использовании. Каждый скрипт имеет имя, соответствующее соответствующей команде CLI. Например, cordova-ios/bin/create эквивалентно cordova create.

Для начала загрузите пакет cordova-ios из npm или Github.

Чтобы создать проект с помощью этого пакета, выполните скрипт create в папке bin:

$ cordova-ios/bin/create ...

Чтобы запустить приложение, используйте скрипт run в папке bin:

$ cordova-ios/bin/run

Созданный проект будет иметь папку с именем cordova внутри, которая содержит скрипты для проектных команд Cordova (например, run, build, и т.д.). Кроме того, структура проекта будет отличаться от структуры обычного проекта Cordova. В частности, /www перемещается в /assets/www.

Для установки плагинов в этот проект используйте Утилиту Cordova Plugman.

Обновление

См. статью по этой ссылке для получения инструкций по обновлению вашей версии cordova-ios.

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