Руководство по инструментам командной строки iOS

В этом руководстве показано, как использовать Кордова в набор инструментов по центру платформы shell для разработки приложений для iOS. Этот путь разработки, описанный в разделе "Введение", может предложить вам больший спектр вариантов разработки чем кросс платформенный инструмент CLI, описанные в разделе "Интерфейс командной строки". Например вам нужно использовать инструменты оболочки при развертывании настраиваемого Cordova WebView наряду с собственными компонентами. Перед тем как использовать какой то путь разработки, сначала необходимо настроить среду SDK, как описано в разделе "Руководство для платформы iOS". Эти инструменты полагаются на командной строки средства Xcode таких как xcode-select иxcodebuild.

Чтобы включить инструменты оболочки для iOS, скачайте Cordova с cordova.apache.org. Загружаемый файл содержит отдельные архивы для каждой платформы. Разверните каждый вы хотите настроить таргетинг, ios в данном случае. Соответствующие инструменты обычно доступны в профиле верхнего уровня bin каталог, в противном случае консультироваться файл README для получения более подробной направлениях.

Эти инструменты позволяют создавать, строить и запускать приложения для iOS. За информаций о дополнительных интерфейсах командной строки которые позволяют встраивать возможности плагинов среди разных платформ, смотрите раздел "Использование Plugman для управления расширениями". Смотрите раздел "Плагины приложения" для детальной информации о том как разрабатывать плагины.

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

Запустите команду create, указав существующий путь к проекту, идентификатор пакета в стиле обратного формата доменных имен и отображаемое имя приложения.

    $ ./path/to/cordova-ios/bin/create /path/to/my_new_project com.example.project_name ProjectName

Построение проекта

    $ /path/to/my_new_project/cordova/build

Запустить приложение на эмуляторе

    $ /path/to/my_new_project/cordova/run --emulator

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

    $ /path/to/my_new_project/cordova/run --device

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

Вы можете узнать больше о подписании, распространение приложений для iOS, создание сертификата и подготовке профиля на сайте Библиотека разработчика iOS.

Чтобы подписать приложение в Cordova, вам необходимо следующее:

• Подпись кода (--codeSignIdentity): С помощью XCode можно создать новую подпись iOS, и добавить ее в Вашу связку ключей. Тип подписи кода - как правило распространение или разработка, должны быть определены здесь.

• Профиль подготовки (--provisioningProfile): Используя Apple Member Center вы можете создать профиль подготовки. Скачать профиль подготовки на компьютер и запустить его в XCode чтобы его зарегистрировать. Он копируется в это расположение на вашем Mac: ~/Library/MobileDevice/Provisioning\ Profiles/. При его открытии в текстовом редакторе, вы можете найти идентификатор UUID, который должен быть указан здесь.

• Правила ресурсов для подписывания кода (--codeSignResourceRules) (необязательно): позволяет указать пользовательские правила подписания ресурсов.

Эти параметры могут быть заданы с помощью аргументов командной строки указанных выше для построения или запуска скриптов:

    $ /path/to/my_new_project/cordova/build --codeSignIdentity="iPhone Distribtion" --provisioningProfile="926c2bd6-8de9-4c2f-8407-1016d2d12954" 

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

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

Существует также поддержка смешивания и комбинирования аргументов командной строки и параметров в файле build.json. Значения из аргументов командной строки будет получить приоритет.

Ведение журнала

    $ /path/to/my_new_project/cordova/log