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

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

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

Инструменты Apple®, необходимые для создания приложений iOS, работают только на операционной системе OS X на компьютерах Mac с процессорами Intel. Xcode® 7.0 (минимальная требуемая версия) работает только на OS X версии 10.10.4 (Yosemite) или выше и включает iOS 9 SDK (Software Development Kit). Для отправки приложений в 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. Откройте файл рабочего пространства (platforms/ios/HelloWorld.xcworkspace) из Xcode, или из командной строки:

   $ open ./platforms/ios/HelloWorld.xcworkspace/
   

2. Убедитесь, что проект HelloWorld выбран в левой панели (1).

1. Выберите целевое устройство из меню Схема панели инструментов, например, симулятор iPhone 7 Plus, как показано на рисунке (2).

2. Нажмите кнопку Запустить (3) на той же панели инструментов слева от Схема. Это приведет к сборке, развертыванию и запуску приложения в симуляторе. Откроется отдельное приложение симулятора для отображения приложения:

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Xcode 8 и iOS 10:

{
    "ios": {
        "debug": {
            "codeSignIdentity": "iPhone Developer",
            "developmentTeam": "FG35JLLMXX4A",
            "packageType": "development",
            "buildFlag": [
                "EMBEDDED_CONTENT_CONTAINS_SWIFT = YES",
                "ALWAYS_EMBED_SWIFT_STANDARD_LIBRARIES=NO",
                "LD_RUNPATH_SEARCH_PATHS = \"@executable_path/Frameworks\""
            ]
        },
        "release": {
            "codeSignIdentity": "iPhone Developer",
            "developmentTeam": "FG35JLLMXX4A",
            "packageType": "app-store",
            "buildFlag": [
                "EMBEDDED_CONTENT_CONTAINS_SWIFT = YES",
                "ALWAYS_EMBED_SWIFT_STANDARD_LIBRARIES=NO",
                "LD_RUNPATH_SEARCH_PATHS = \"@executable_path/Frameworks\""
            ]
        }
    }
}

Более ранние версии:

{
    "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, будет показано предупреждение. Вы также можете указать опцию buildFlag в build.json выше (значение ключа buildFlag — строка или массив строк).

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}.xcworkspace или откройте Xcode из вашей терминальной программы:

$ open -a Xcode platforms/ios

Экран должен выглядеть так:

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

cordova-ios содержит ряд скриптов, которые позволяют использовать платформу без полного Cordova CLI. Этот путь разработки может предложить вам больший диапазон вариантов разработки в определенных ситуациях, чем кроссплатформенный cordova CLI. Например, вам необходимо использовать инструменты командной строки при развертывании пользовательского 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.)