Spec-Zone.ru › Cordova 6

Модернизация iOS

Это руководство показывает, как изменить проекты iOS для обновления с более старых версий Cordova. Большинство этих инструкций применимо к проектам, созданным с более ранним набором инструментов командной строки, предшествующих утилите командной строки cordova. Для получения информации об обновлении версии командной строки обратитесь к Интерфейсу командной строки.

ПРИМЕЧАНИЕ: Требуется Xcode 6. В настоящее время для отправки в Apple App Store следует использовать последнюю выпущенную версию iOS SDK, которая включает iOS 8 и поставляется только с Xcode 6.

Обновление проектов 3.6.0 до 4.0.0

Для проектов без использования CLI выполните:

bin/update path/to/project

Для проектов с использованием CLI:

  1. Обновите версию командной строки cordova. См. Интерфейс командной строки.

  2. Выполните cordova platform update ios в ваших существующих проектах.

Обновление проектов 3.3.0 до 3.4.0

Для проектов без использования CLI выполните:

bin/update path/to/project

Для проектов с использованием CLI:

  1. Обновите версию командной строки cordova. См. Интерфейс командной строки.

  2. Выполните cordova platform update ios

Обновление проектов 3.2.0 до 3.3.0

Для проектов без использования CLI выполните:

bin/update path/to/project

Для проектов с использованием CLI:

  1. Обновите версию командной строки cordova. См. Интерфейс командной строки.

  2. Выполните cordova platform update ios

Обновление проектов 3.1.0 до 3.2.0

Для проектов без использования CLI выполните:

bin/update path/to/project

Для проектов с использованием CLI:

  1. Обновите версию командной строки cordova. См. Интерфейс командной строки.

  2. Выполните cordova platform update ios

Обновление проектов 3.0.0 до 3.1.0

Для проектов без использования CLI выполните:

bin/update path/to/project

Для проектов с использованием CLI:

  1. Обновите версию командной строки cordova. См. Интерфейс командной строки.

  2. Выполните cordova platform update ios

Проблемы с iOS 7:

  1. Удалите width=device-width, height=device-height из файла index.html в теге viewport meta. (См. соответствующий баг.)

  2. Обновите свои плагины ядра медиа, захвата медиа и заставки для поддержки iOS 7.

Проблемы с Xcode 5:

  1. Обновите настройки проекта, если Xcode 5 предложит это сделать (в навигаторе проблем).

  2. Обновите настройку Компилятор для C/C++/Objective-C на вкладке Настройки сборки, в разделе Параметры сборки. Выберите По умолчанию компилятор (Apple LLVM 5.0).

Обновление до CLI (3.0.0) с 2.9.0

  1. Создайте новый проект Apache Cordova 3.0.0, используя CLI cordova, как описано в Интерфейсе командной строки.

  2. Добавьте свои платформы в проект cordova, например: cordova platform add ios.

  3. Скопируйте содержимое каталога проекта www в каталог www в корне проекта cordova, который вы только что создали.

  4. Скопируйте или перезапишите любые нативные ресурсы из вашего исходного проекта (Resources, и т.д.), убедившись, что вы добавили все новые файлы в проект .xcodeproj. iOS-проект компилируется внутри каталога platforms\ios.

  5. Скопируйте config.xml в каталог www, и удалите все определения плагинов. Вместо изменения каталога платформы, изменяйте настройки здесь.

  6. Используйте инструмент командной строки cordova CLI для установки необходимых плагинов. Обратите внимание, что CLI обрабатывает все основные API как плагины, поэтому их может потребоваться добавить. Только плагины 3.0.0 совместимы с CLI.

  7. Скомпилируйте и протестируйте.

Обновление проектов 2.9.0 до 3.0.0

  1. Загрузите и распакуйте исходный код Cordova 3.0.0 в постоянное расположение каталога на жестком диске, например в ~/Documents/Cordova-3.0.0.

  2. Закройте Xcode, если оно запущено.

  3. Используя Terminal.app, перейдите в каталог, куда вы поместили загруженный исходный код.

  4. Создайте новый проект, как описано в Руководстве по инструменту командной строки iOS. Вам понадобятся ресурсы из этого нового проекта.

  5. Скопируйте файл www/cordova.js (обратите внимание, что он больше не имеет суффикса версии, версия указана в самом файле в заголовке) из нового проекта в каталог www, и удалите файл www/cordova.js.

  6. Обновите ссылку на скрипт Cordova в файле www/index.html (и в любых других файлах, содержащих эту ссылку) для указания на новый файл cordova.js.

  7. Удалите каталог CordovaLib, и скопируйте каталог CordovaLib из нового проекта в корневой каталог вашего проекта.

ПРИМЕЧАНИЕ: Начиная с Cordova 3.0.0, плагины не устанавливаются предварительно, и вам необходимо использовать утилиту командной строки plugman для их установки самостоятельно. См. Использование Plugman для управления плагинами.

Обновление проектов 2.8.0 до 2.9.0

  1. Загрузите и распакуйте исходный код Cordova 2.9.0 в постоянное расположение каталога на жестком диске, например в ~/Documents/Cordova-2.9.0.

  2. Закройте Xcode, если оно запущено.

  3. Используя Terminal.app, перейдите в каталог, куда вы поместили загруженный исходный код.

  4. Создайте новый проект, как описано в Руководстве по инструменту командной строки iOS. Вам понадобятся ресурсы из этого нового проекта.

  5. Скопируйте файл www/cordova.js (обратите внимание, что он больше не имеет суффикса версии, версия указана в самом файле в заголовке) из нового проекта в каталог www, и удалите файл www/cordova.js.

  6. Обновите ссылку на скрипт Cordova в файле www/index.html (и в любых других файлах, содержащих эту ссылку) для указания на новый файл cordova.js.

  7. Удалите каталог CordovaLib, и скопируйте каталог CordovaLib из нового проекта в корневой каталог вашего проекта.

Обновление проектов 2.7.0 до 2.8.0

  1. Загрузите и распакуйте исходный код Cordova 2.8.0 в постоянное расположение каталога на жестком диске, например в ~/Documents/Cordova-2.8.0.

  2. Закройте Xcode, если оно запущено.

  3. Используя Terminal.app, перейдите в каталог, куда вы поместили загруженный исходный код.

  4. Создайте новый проект, как описано в Руководстве по инструменту командной строки iOS. Вам понадобятся ресурсы из этого нового проекта.

  5. Скопируйте файл www/cordova.js (обратите внимание, что он больше не имеет суффикса версии, версия указана в самом файле в заголовке) из нового проекта в каталог www, и удалите файл www/cordova-2.7.0.js.

  6. Обновите ссылку на скрипт Cordova в файле www/index.html (и в любых других файлах, содержащих эту ссылку) для указания на новый файл cordova.js.

  7. Обновите теги <plugin> в файле config.xml на теги <feature>. Обратите внимание, что существующие теги <plugin> по-прежнему работают, но устарели. Вы можете скопировать эту информацию из файла config.xml для нового проекта. Например:

    <plugins>
    <plugin name="LocalStorage" value="CDVLocalStorage" />
    <!-- other plugins -->
</plugins>

<!-- change to: (note that a <feature> tag is on the same level as <plugins> -->
<feature name="LocalStorage">
    <param name="ios-package" value="CDVLocalStorage" />
</feature>
<!-- other <feature> tags -->

  8. Удалите каталог CordovaLib, и скопируйте каталог CordovaLib из нового проекта в корневой каталог вашего проекта.

  9. Добавьте эти два фреймворка в свой проект:

    OpenAL
ImageIO

  10. Обновите настройки сборки вашего проекта. В разделе Связывание → Другие флаги компоновщика отредактируйте "-Obj-C" на "-ObjC".

  11. Обновите настройки сборки вашего проекта. В разделе Связывание → Другие флаги компоновщика измените "-all_load" на -force\_load ${BUILT\_PRODUCTS\_DIR}/libCordova.a. Вам это нужно будет сделать только в случае проблемы, описанной в данном вопросе.

Обновление проектов 2.6.0 до 2.7.0

  1. Загрузите и распакуйте исходный код Cordova 2.7.0 в постоянное расположение каталога на жестком диске, например в ~/Documents/Cordova-2.7.0.

  2. Закройте Xcode, если оно запущено.

  3. Используя Terminal.app, перейдите в каталог, куда вы поместили загруженный исходный код.

  4. Создайте новый проект, как описано в Руководстве по инструменту командной строки iOS. Вам понадобятся ресурсы из этого нового проекта.

  5. Скопируйте файл www/cordova-2.7.0.js из нового проекта в каталог www, и удалите файл www/cordova-2.6.0.js.

  6. Обновите ссылку на скрипт Cordova в файле www/index.html (и в любых других файлах, содержащих эту ссылку) для указания на новый файл cordova-2.7.0.js.

  7. Обновите (или замените, если вы не изменяли файл) файл AppDelegate.m в соответствии с файлом из нового проекта (см. эту разницу).

  8. В файле config.xml удалите эту строку.

  9. Удалите каталог CordovaLib, и скопируйте каталог CordovaLib из нового проекта в корневой каталог вашего проекта.

Обновление проектов 2.5.0 до 2.6.0

  1. Загрузите и разархивируйте исходный код Cordova 2.6.0 в постоянную директорию на вашем жестком диске, например, в ~/Documents/Cordova-2.6.0.

  2. Закройте Xcode, если оно запущено.

  3. Используя Terminal.app, перейдите в директорию, куда вы поместили загруженный исходный код.

  4. Создайте новый проект, как описано в Руководстве по инструментарию iOS Shell. Вам понадобятся ресурсы из этого нового проекта.

  5. Скопируйте файл www/cordova-2.6.0.js проекта в директорию www, и удалите файл www/cordova-2.5.0.js.

  6. Обновите ссылку на скрипт Cordova в файле www/index.html (а также в любых других файлах, ссылающихся на скрипт), указав новый файл cordova-2.6.0.js.

  7. Обновите (или замените, если вы не изменяли файл) файл AppDelegate.m в соответствии с файлом из нового проекта (см. данную разницу).

  8. В файле config.xml, добавьте эту новую строку.

  9. В файле config.xml, добавьте эту новую строку.

  10. В файле config.xml, UIWebViewBounce был изменён на DisallowOverscroll, и значения по умолчанию отличаются.

  11. В файле config.xml, предпочтение EnableLocation устарело.

  12. Удалите директорию CordovaLib, и скопируйте директорию CordovaLib из нового проекта в корневую директорию вашего проекта.

Обновление проектов 2.4.0 до 2.5.0

  1. Загрузите и разархивируйте исходный код Cordova 2.5.0 в постоянную директорию на вашем жестком диске, например, в ~/Documents/Cordova-2.5.0.

  2. Закройте Xcode, если оно запущено.

  3. Используя Terminal.app, перейдите в директорию, куда вы поместили загруженный исходный код.

  4. Создайте новый проект, как описано в Руководстве по инструментарию iOS Shell. Вам понадобятся ресурсы из этого нового проекта.

  5. Скопируйте файл www/cordova-2.5.0.js из нового проекта в директорию www и удалите файл www/cordova-2.4.0.js.

  6. Обновите ссылку на скрипт Cordova в файле www/index.html (и во всех других файлах, содержащих ссылку на скрипт) на новый файл cordova-2.5.0.js.

  7. Обновите (или замените, если вы не изменяли файл) файл AppDelegate.m в соответствии с файлом из нового проекта (см. данную разницу).

  8. В файле config.xml добавьте эти новые строки.

  9. В файле config.xml, измените корневой элемент, поменяв его с cordova на widget.

  10. В файле config.xml, удалите предпочтение OpenAllWhitelistURLsInWebView.

  11. Удалите директорию cordova, и скопируйте директорию cordova из нового проекта в корневую директорию вашего проекта. В 2.5.0, здесь обновлённые скрипты.

  12. Удалите директорию CordovaLib, и скопируйте директорию CordovaLib из нового проекта в корневую директорию вашего проекта.

Обновление проектов 2.3.0 до 2.4.0

  1. Загрузите и разархивируйте исходный код Cordova 2.4.0 в постоянную директорию на вашем жестком диске, например, в ~/Documents/Cordova-2.4.0.

  2. Закройте Xcode, если оно запущено.

  3. Используя Terminal.app, перейдите в директорию, куда вы поместили загруженный исходный код.

  4. Создайте новый проект, как описано в Руководстве по инструментарию iOS Shell. Вам понадобятся ресурсы из этого нового проекта.

  5. Скопируйте файл www/cordova-2.4.0.js из нового проекта в директорию www, и удалите файл www/cordova-2.3.0.js.

  6. Обновите ссылку на скрипт Cordova в файле www/index.html (и во всех других файлах, содержащих ссылку на скрипт) на новый файл cordova-2.4.0.js.

  7. Обновите (или замените, если вы не изменяли файлы) файл MainViewController.m в соответствии с файлом из нового проекта (см. данную разницу).

  8. Обновите (или замените, если вы не изменяли файл) файл AppDelegate.m в соответствии с файлом из нового проекта (см. данную разницу).

  9. В файле config.xml добавьте эту новую строку.

  10. Удалите директорию cordova, и скопируйте директорию cordova из нового проекта в корневую директорию вашего проекта. В 2.4.0, здесь исправленные скрипты.

  11. Удалите директорию CordovaLib, и скопируйте директорию CordovaLib из нового проекта в корневую директорию вашего проекта.

  12. Добавьте AssetsLibrary.framework как ресурс в свой проект. (См. документацию Apple для получения инструкций).

Обновление проектов 2.2.0 до 2.3.0

  1. Загрузите и разархивируйте исходный код Cordova 2.3.0 в постоянную директорию на вашем жестком диске, например, в ~/Documents/Cordova-2.3.0.

  2. Закройте Xcode, если оно запущено.

  3. Используя Terminal.app, перейдите в директорию, куда вы поместили загруженный исходный код.

  4. Создайте новый проект, как описано в Руководстве по инструментарию iOS Shell. Вам понадобятся ресурсы из этого нового проекта.

  5. Скопируйте файл www/cordova-2.3.0.js из нового проекта в директорию www, и удалите файл www/cordova-2.2.0.js.

  6. Обновите ссылку на скрипт Cordova в файле www/index.html (и во всех других файлах, содержащих ссылку на скрипт) на новый файл cordova-2.3.0.js.

  7. Обновите (или замените, если вы не изменяли файл) MainViewController.m в соответствии с файлом из нового проекта.

  8. Удалите директорию cordova, и скопируйте директорию cordova из нового проекта в корневую директорию вашего проекта. В 2.3.0, здесь новые скрипты.

  9. Удалите директорию CordovaLib, и скопируйте директорию CordovaLib из нового проекта в корневую директорию вашего проекта.

  10. Преобразуйте файл Cordova.plist в config.xml, запустив скрипт bin/cordova\_plist\_to\_config\_xml на вашем файле проекта.

  11. Добавьте плагин InAppBrowser в config.xml, добавив этот тег под <cordova><plugins>: 

    <plugin name="InAppBrowser" value="CDVInAppBrowser" />

  12. Обратите внимание, что плагины Objective-C не добавляются в белый список больше. Для добавления подключений в белый список приложения вам нужно установить заголовок User-Agent подключения к тому же пользовательскому агенту, что и основное Cordova WebView. Вы можете получить его, обратившись к свойству userAgent основного контроллера представления. У основного контроллера представления (CDVViewController) также есть метод URLisAllowed, позволяющий проверить, проходит ли URL проверку в белом списке.

  13. Изменения в API устройства:

    • Для iOS, device.platform ранее возвращал iPhone, iPad или iPod Touch; теперь он возвращает (правильно) iOS.
    • Для iOS, device.name (теперь устарел для всех платформ) ранее возвращал имя устройства пользователя (например, 'iPhone 5 Шазрона'); теперь он возвращает то, что раньше возвращало device.platform: iPhone, iPad или iPod Touch.
    • Для всех платформ есть новое свойство device.model; оно возвращает конкретную модель устройства, например, iPad2,5 (для других платформ оно возвращает то, что раньше возвращало device.name).

Обновление проектов 2.1.0 до 2.2.0

  1. Скачайте и распакуйте исходный код Cordova 2.2.0 в постоянную папку на вашем жестком диске, например, в ~/Documents/Cordova-2.2.0.

  2. Закройте Xcode, если оно запущено.

  3. Используя Terminal.app, перейдите в папку, куда вы поместили загруженный исходный код.

  4. Создайте новый проект, как описано в Руководстве по инструменту командной строки iOS. Вам понадобятся ресурсы из этого нового проекта.

  5. Скопируйте файл www/cordova-2.2.0.js из нового проекта в папку www, и удалите файл www/cordova-2.1.0.js.

  6. Обновите ссылку на скрипт Cordova в файле www/index.html (и всех других файлах, содержащих ссылку на скрипт), чтобы она указывала на новый файл cordova-2.2.0.js.

  7. Обновите (или замените, если вы не изменяли файл) файл MainViewController.m, используя файл из нового проекта:

    • Обновлено → viewWillAppear

  8. Скопируйте папку cordova из нового проекта в корневую папку вашего проекта. В версии 2.2.0 здесь есть обновленный скрипт «emulate».

  9. Далее, обновите ссылку на подпроект CordovaLib. Начиная с Cordova 2.1.0, мы больше не используем переменную CORDOVALIB Xcode для указания местоположения CordovaLib, теперь используется абсолютный путь к файлу.

    1. Запустите Terminal.app
    2. Перейдите в папку, где вы установили Cordova (см. шаг 1), в подпапку bin

    3. Запустите скрипт ниже, где первым параметром является путь к файлу .xcodeproj вашего проекта:

      update_cordova_subproject path/to/your/project/xcodeproj

ПРИМЕЧАНИЕ: В версии 2.2.0 скрипт bin/create копируется в подпроект CordovaLib, в ваш проект. Чтобы настроить всё аналогичным образом, просто скопируйте необходимый CordovaLib в папку проекта и обновите местоположение подпроекта CordovaLib (относительно проекта) в инспекторе файлов Xcode.

Обновление проектов 2.0.0 до 2.1.0

В Cordova 2.1.0, CordovaLib был обновлен для использования автоматического управления ссылками (ARC). Вам не нужно обновлять до ARC, чтобы использовать CordovaLib, но если вы хотите обновить свой проект для использования ARC, используйте мастер миграции Xcode из меню: Редактировать → Переработка → Преобразовать в Objective-C ARC…, снимите выделение с libCordova.a, затем выполните мастер до завершения.

  1. Скачайте и распакуйте исходный код Cordova 2.1.0 в постоянную папку на вашем жестком диске, например, в ~/Documents/Cordova-2.1.0.

  2. Закройте Xcode, если оно запущено.

  3. Используя Terminal.app, перейдите в папку, куда вы поместили загруженный исходный код.

  4. Создайте новый проект, как описано в Руководстве по инструменту командной строки iOS. Вам понадобятся ресурсы из этого нового проекта.

  5. Скопируйте файл www/cordova-2.1.0.js из нового проекта в папку www, и удалите файл www/cordova-2.0.0.js.

  6. Обновите ссылку на скрипт Cordova в файле www/index.html (и всех других файлах, содержащих ссылку на скрипт), чтобы она указывала на новый файл cordova-2.1.0.js.

  7. Обновите (или замените, если вы не изменяли файл) файл AppDelegate.m, используя файл из нового проекта:

    • Изменено → application:didFinishLaunchingWithOptions:
    • Добавлено → application:supportedInterfaceOrientationsForWindow:

  8. Обновите (или замените, если вы не изменяли файл) файл MainViewController.m, используя файл из нового проекта:

    • Добавлено → viewWillAppear

  9. Скопируйте папку cordova из нового проекта в корневую папку вашего проекта. В версии 2.1.0 здесь есть обновленные скрипты, поддерживающие пути с пробелами.

  10. Удалите ссылку на файл VERSION из вашего проекта (не тот, что в CordovaLib).

  11. Далее, обновите ссылку на подпроект CordovaLib. Начиная с Cordova 2.1.0, мы больше не используем переменную CORDOVALIB Xcode для указания местоположения CordovaLib, теперь используется абсолютный путь к файлу.

    1. Запустите Terminal.app
    2. Перейдите в папку, где вы установили Cordova (см. шаг 1), в подпапку bin

    3. Запустите скрипт ниже, где первым параметром является путь к файлу .xcodeproj вашего проекта:

      update_cordova_subproject path/to/your/project/xcodeproj

Обновление проектов 1.9.0 до 2.0.0

  1. Установите Cordova 2.0.0.

  2. Создайте новый проект, как описано в Руководстве по инструменту командной строки iOS. Вам понадобятся ресурсы из этого нового проекта.

  3. Скопируйте файл www/cordova-2.0.0.js из нового проекта в папку www, и удалите файл www/cordova-1.9.0.js.

  4. Обновите ссылку на скрипт Cordova в файле www/index.html (и всех других файлах, содержащих ссылку на скрипт), чтобы она указывала на новый файл cordova-2.0.0.js.

  5. Скопируйте папку cordova из нового проекта в корневую папку вашего проекта (если вам нужны инструменты командной строки проекта).

  6. Добавьте новую запись в Plugins файла Cordova.plist, в группе Файлы поддержки. Ключ — Device, а значение — CDVDevice.

  7. Удалите Cordova.framework.

  8. Удалите verify.sh из группы Файлы поддержки.

  9. Выберите значок проекта в навигаторе проекта, выберите Цель вашего проекта, затем вкладку Настройки сборки.

  10. Поиск Макрос-препроцессора, затем удалите все значения CORDOVA_FRAMEWORK=1.

  11. Найдите папку CordovaLib которая установлена на вашем жестком диске, в подпапке Documents вашей домашней папки.

  12. Найдите файл CordovaLib.xcodeproj в папке CordovaLib, перетащите его в свой проект. Он должен отобразиться как подпроект.

  13. Соберите свой проект, вы должны получить некоторые ошибки, связанные с директивами #import.

  14. Для ошибок #import, замените импорты на основе кавычек в этом формате:

    #import "CDV.h"

    на этот формат с использованием скобок:

    #import <Cordova/CDV.h>

    и удалите любые обертки #ifdef вокруг импортов Cordova. Они больше не нужны (импорты теперь объединены).

  15. Соберите свой проект снова, и у него не должно быть ошибок #import.

  16. Выберите значок проекта в навигаторе проекта, выберите Цель вашего проекта, затем вкладку Фазы сборки.

  17. Разверните фазу Зависимости целей, затем выберите кнопку +.

  18. Выберите цель CordovaLib, затем нажмите кнопку Добавить.

  19. Разверните первую фазу Связать библиотеку с двоичными файлами (она уже должна содержать множество фреймворков), затем выберите кнопку +.

  20. Выберите статическую библиотеку libCordova.a, затем нажмите кнопку Добавить.

  21. Удалите фазу Скрипт запуска.

  22. Выберите значок проекта в навигаторе проекта, выберите Цель вашего проекта, затем вкладку Настройки сборки.

  23. Поиск Другие флаги компоновщика, и добавьте значения -force_load и -Obj-C.

  24. Разверните подпроект CordovaLib.

  25. Найдите файл VERSION, перетащите его в свой основной проект (мы хотим создать ссылку на него, а не копию).

  26. Выберите опцию Создавать группы для добавленных папок, затем нажмите кнопку Готово.

  27. Выберите файл VERSION, который вы только что перетащили на предыдущем шаге.

  28. Нажмите сочетание клавиш Option-Command-1, чтобы показать Инспектор файла (или выберите пункт меню Вид → Инструменты → Показать инспектор файла).

  29. Выберите Относительно CORDOVALIB в раскрывающемся списке Расположение в Инспекторе файла.

  30. Установите в настройках Xcode Настройки Xcode → Местоположения → Данные вывода → Дополнительно… на значение Уникальные, чтобы объединённые заголовки можно было найти.

  31. Выберите значок проекта в навигаторе проекта, выберите Цель, затем вкладку Настройки сборки.

  32. Поиск Пути поиска заголовков. Для этой настройки добавьте три значения, включая кавычки:

    "$(TARGET_BUILD_DIR)/usr/local/lib/include"

"$(OBJROOT)/UninstalledProducts/include"

"$(BUILT_PRODUCTS_DIR)"

  33. Поиск Другие флаги компоновщика. Для этой настройки добавьте это значение:

    -weak_framework CoreFoundation

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

  35. Выберите свой проект в раскрывающемся списке Схема, а затем выберите Имитатор iPhone 5.1.

  36. Нажмите кнопку Запуск.

ПРИМЕЧАНИЕ: Если ваш проект не работает должным образом в симуляторе, обратите внимание на любые ошибки в журнале консоли в Xcode для получения дополнительных сведений.

Обновление проектов 1.8.x до 1.9.0

  1. Установите Cordova 1.9.0.

  2. Создайте новый проект. Вам понадобятся некоторые из ресурсов этого нового проекта.

  3. Скопируйте файл www/cordova-1.9.0.js из нового проекта в папку www, и удалите файл www/cordova-1.8.x.js.

  4. Обновите ссылку на скрипт Cordova в файле www/index.html (и всех других файлах, содержащих ссылку на скрипт), чтобы она указывала на новый файл cordova-1.9.0.js.

ПРИМЕЧАНИЕ: 1.9.0 поддерживает новое значение BackupWebStorage булево Cordova.plist настройки. По умолчанию она включена, поэтому установите её в значение false, чтобы отключить её, особенно на iOS 6. См. Заметки к выпуску: раздел Safari и UIKit

Обновление проектов 1.7.0 до 1.8.x

  1. Установите Cordova 1.8.0.

  2. Создайте новый проект. Вам понадобятся некоторые из ресурсов этого нового проекта.

  3. Скопируйте файл www/cordova-1.8.0.js из нового проекта в папку www, и удалите файл www/cordova-1.7.x.js.

  4. Обновите ссылку на скрипт Cordova в файле www/index.html (и всех других файлах, содержащих ссылку на скрипт), чтобы она указывала на новый файл cordova-1.8.0.js.

Если вы планируете использовать API захвата, вам понадобятся новые ресурсы для iPad с дисплеем Retina:

  1. Скопируйте элемент Resources/Capture.bundle из нового проекта в папку вашего проекта, перезаписав существующий элемент Resources/Capture.bundle.

  2. В вашем проекте выберите элемент Capture.bundle в навигаторе проекта Xcode, нажмите клавишу Delete, затем выберите Удалить ссылку в появившемся диалоговом окне.

  3. Перетащите новый элемент Capture.bundle из шага 1 выше в навигатор проекта в Xcode, затем выберите опцию Создать группы для добавленных папок.

Обновление проектов 1.6.x до 1.7.0

  1. Установите Cordova 1.7.0.

  2. Создайте новый проект. Вам понадобятся некоторые ресурсы из этого нового проекта.

  3. Скопируйте файл www/cordova-1.7.0.js из нового проекта в папку www, и удалите файл www/cordova-1.6.0.js.

  4. Обновите ссылку на скрипт Cordova в файле www/index.html (и во всех других файлах, содержащих эту ссылку), указав на новый файл cordova-1.7.0.js.

Обновление проектов 1.5.0 до 1.6.x

  1. Установите Cordova 1.6.1.

  2. Создайте резервную копию AppDelegate.m, AppDelegate.h, MainViewController.m, MainViewController.h, и Cordova.plist в вашем проекте.

  3. Создайте новый проект. Вам понадобятся некоторые ресурсы из этого нового проекта.

  4. Скопируйте эти файлы из нового проекта в папку вашего проекта, основанного на 1.5.0, заменяя старые файлы (сначала сделайте резервную копию файлов из шага 2 выше):

    AppDelegate.h
AppDelegate.m
MainViewController.h
MainViewController.m
Cordova.plist

  5. Добавьте все новые файлы MainViewController и AppDelegate в свой проект Xcode.

  6. Скопируйте файл www/cordova-1.6.1.js из нового проекта в папку www, и удалите файл www/cordova-1.5.0.js.

  7. Обновите ссылку на скрипт Cordova в файле www/index.html (и во всех других файлах, содержащих эту ссылку), указав на новый файл cordova-1.6.1.js.

  8. Добавьте новый файл Cordova.plist в свой проект. Это необходимо, так как имена основных плагинов службы должны измениться, чтобы соответствовать именам из Android и BlackBerry, для унифицированного файла JavaScript Cordova (cordova-js).

  9. Внесите в новые настройки любые записи Plugins и ExternalHosts, которые вы имели в своей резервной копии Cordova.plist.

  10. Внесите в новые файлы AppDelegate любой специфичный для проекта код, который вы имели в резервной копии AppDelegate.h и AppDelegate.m. Любой код UIWebViewDelegate или CDVCommandDelegate в AppDelegate.m необходимо перенести в MainViewController.m (см. закомментированные разделы в этом файле).

  11. Внесите в новые файлы MainViewController любой специфичный для проекта код, который вы имели в резервной копии MainViewController.h и MainViewController.m.

  12. Нажмите на значок проекта в навигаторе проекта, выберите свой Проект, затем выберите вкладку Настройки сборки.

  13. В поле поиска введите Компилятор для C/C++/Objective-C.

  14. Выберите значение Apple LLVM Compiler 3.1.

Обновление проектов 1.4.x до 1.5.0

  1. Установите Cordova 1.5.0.

  2. Создайте новый проект и запустите его один раз. Вам понадобятся некоторые ресурсы из этого нового проекта.

  3. Скопируйте файл www/cordova-1.5.0.js из нового проекта в папку www, и удалите файл www/phonegap-1.4.x.js.

  4. Обновите ссылку на скрипт Cordova в файле www/index.html (и во всех других файлах, содержащих эту ссылку), указав на новый файл Cordova cordova-1.5.0.js.

  5. Найдите PhoneGap.framework в навигаторе проекта, выберите его.

  6. Нажмите клавишу Delete, чтобы удалить ссылку PhoneGap.framework в навигаторе проекта.

  7. Нажмите комбинацию клавиш Option-Command-A, чтобы открыть окно для добавления файлов в проект (окно Добавить файлы...). Убедитесь, что выбрана опция Создать группы для добавленных папок.

  8. Нажмите комбинацию клавиш Shift-Command-G, чтобы открыть окно для перехода в папку (окно Перейти в папку:).

  9. Введите /Users/Shared/Cordova/Frameworks/Cordova.framework в поле Перейти в папку: и нажмите кнопку Перейти.

  10. Нажмите кнопку Добавить в окне Добавить файлы....

  11. Выберите Cordova.framework в навигаторе проекта.

  12. Нажмите комбинацию клавиш Option-Command-1, чтобы открыть инспектор файла.

  13. Выберите Абсолютный путь в выпадающем списке Расположение в инспекторе файла.

  14. Нажмите комбинацию клавиш Option-Command-A, чтобы открыть окно для добавления файлов в проект (окно Добавить файлы...). Убедитесь, что выбрана опция Создать группы для добавленных папок.

  15. Нажмите комбинацию клавиш Shift-Command-G, чтобы открыть окно для перехода в папку (окно Перейти в папку:).

  16. Введите ~/Documents/CordovaLib/Classes/deprecated в поле Перейти в папку: и нажмите кнопку Перейти.

  17. Нажмите кнопку Добавить в окне Добавить файлы....

  18. В файлах AppDelegate.h, AppDelegate.m, и MainViewController.h замените весь блок #ifdef PHONEGAP_FRAMEWORK на:

    #import "CDVDeprecated.h"

  19. Нажмите на значок проекта в навигаторе проекта, выберите свой Целевой объект, затем выберите вкладку Настройки сборки.

  20. Поиск по Пути поиска фреймворков.

  21. Замените существующее значение на /Users/Shared/Cordova/Frameworks.

  22. Поиск по Макросы препроцессора.

  23. Для первого (соединенного) значения замените значение на CORDOVA_FRAMEWORK=YES.

  24. Выберите вкладку Этапы сборки.

  25. Разверните Скрипт выполнения.

  26. Замените все вхождения PhoneGap на Cordova.

  27. Найдите файл PhoneGap.plist в навигаторе проекта и дважды кликните по имени файла, чтобы перейти в режим редактирования имени.

  28. Переименуйте PhoneGap.plist в Cordova.plist.

  29. Щелкните правой кнопкой мыши по Cordova.plist, выберите Открыть как → Исходный код.

  30. Нажмите Option-Command-F, выберите Заменить из выпадающего меню в левой верхней части окна исходного кода.

  31. Введите com.phonegap в поле Найти и org.apache.cordova в поле Заменить на, затем нажмите кнопку Заменить все.

  32. Введите PG в поле Найти и CDV в поле Заменить на, затем нажмите кнопку Заменить все.

  33. Нажмите Command-B, чтобы выполнить сборку. У вас могут остаться устаревшие элементы, которые можно устранить в будущем (см. CDVDeprecated.h. Например, замените классы в вашем коде, использующие PG*, на CDV*).

Обновление проектов 1.4.0 до 1.4.1

  1. Установите Cordova 1.4.1.

  2. Создайте резервную копию MainViewController.m.

  3. Создайте новый проект. Вам понадобятся некоторые ресурсы из этого нового проекта.

  4. Скопируйте файл MainViewController.m из нового проекта в папку вашего проекта, основанного на 1.4.0, заменяя старый файл (сначала сделайте резервную копию файлов из шага 2 выше).

  5. Добавьте файл MainViewController.m в свой проект Xcode.

  6. Внесите в новый файл любой специфичный для проекта код, который вы имели в резервной копии MainViewController.m.

  7. Обновление файла phonegap-1.4.0.js необязательно, так как в JavaScript между 1.4.0 и 1.4.1 изменений нет.

Обновление проектов 1.3.0 до 1.4.0

  1. Установите Cordova 1.4.0.

  2. Создайте резервную копию AppDelegate.m и AppDelegate.h в вашем проекте.

  3. Создайте новый проект. Вам понадобятся некоторые ресурсы из этого нового проекта.

  4. Скопируйте эти файлы из нового проекта в папку вашего проекта, основанного на 1.3.0, заменяя старые файлы (сначала сделайте резервную копию файлов из шага 2 выше):

    AppDelegate.h
AppDelegate.m
MainViewController.h
MainViewController.m
MainViewController.xib

  5. Добавьте все файлы MainViewController в свой проект Xcode.

  6. Скопируйте файл www/phonegap-1.4.0.js из нового проекта в папку www, и удалите файл www/phonegap-1.3.0.js.

  7. Обновите ссылку на скрипт Cordova в файле www/index.html (и во всех других файлах, содержащих эту ссылку), указав на новый файл phonegap-1.4.0.js.

  8. Добавьте новую запись в Plugins в файле PhoneGap.plist. Ключ — com.phonegap.battery, а значение — PGBattery.

  9. Внесите в новые файлы AppDelegate любой специфичный для проекта код, который вы имели в резервных копиях AppDelegate.h и AppDelegate.m.

Обновление проектов 1.2.0 до 1.3.0

  1. Установите Cordova 1.3.0.

  2. Создайте резервную копию AppDelegate.m и AppDelegate.h в вашем проекте.

  3. Создайте новый проект. Вам понадобятся некоторые ресурсы из этого нового проекта.

  4. Скопируйте эти файлы из нового проекта в папку вашего проекта, основанного на 1.2.0, заменяя старые файлы (сначала сделайте резервную копию файлов из шага 2 выше):

    AppDelegate.h
AppDelegate.m
MainViewController.h
MainViewController.m
MainViewController.xib

  5. Добавьте все файлы MainViewController в свой проект Xcode.

  6. Скопируйте файл www/phonegap-1.3.0.js из нового проекта в папку www, и удалите файл www/phonegap-1.2.0.js.

  7. Обновите ссылку на скрипт Cordova в файле www/index.html (и во всех других файлах, содержащих эту ссылку), указав на новый файл phonegap-1.3.0.js.

  8. Добавьте новую запись в Plugins в файле PhoneGap.plist. Ключ — com.phonegap.battery, а значение — PGBattery.

  9. Внесите в новые файлы AppDelegate любой специфичный для проекта код, который вы имели в резервных копиях AppDelegate.h и AppDelegate.m.

Обновление проектов 1.1.0 до 1.2.0

  1. Установите Cordova 1.2.0.

  2. Создайте резервную копию AppDelegate.m и AppDelegate.h в вашем проекте.

  3. Создайте новый проект. Вам понадобятся некоторые ресурсы из этого нового проекта.

  4. Скопируйте эти файлы из нового проекта в каталог вашего проекта, основанного на версии 1.1.0, на диске, заменяя старые файлы (сначала создайте резервную копию файлов, как указано в шаге 2 выше):

    AppDelegate.h
AppDelegate.m
MainViewController.h
MainViewController.m
MainViewController.xib

  5. Добавьте все файлы MainViewController в свой проект Xcode.

  6. Скопируйте файл www/phonegap-1.2.0.js из нового проекта в каталог www, и удалите файл www/phonegap-1.1.0.js.

  7. Обновите ссылку на скрипт Cordova в файле www/index.html (и любых других файлах, содержащих ссылку на скрипт) на новый файл phonegap-1.2.0.js.

  8. Добавьте новую запись в Plugins в файле PhoneGap.plist. Ключ — com.phonegap.battery, а значение — PGBattery.

  9. Интегрируйте любой код, специфичный для проекта, который у вас есть в резервных копиях AppDelegate.h и AppDelegate.m, в новые файлы AppDelegate.

Обновление проектов 1.0.0 до 1.1.0

  1. Установите Cordova 1.1.0.

  2. Создайте резервную копию AppDelegate.m и AppDelegate.h в вашем проекте.

  3. Создайте новый проект. Вам понадобятся некоторые ресурсы из этого нового проекта.

  4. Скопируйте эти файлы из нового проекта в каталог вашего проекта, основанного на версии 1.0.0, на диске, заменяя старые файлы (сначала создайте резервную копию файлов, как указано в шаге 2 выше):

    AppDelegate.h
AppDelegate.m
MainViewController.h
MainViewController.m
MainViewController.xib

  5. Добавьте все файлы MainViewController в свой проект Xcode.

  6. Скопируйте файл www/phonegap-1.1.0.js из нового проекта в каталог www, и удалите файл www/phonegap-1.0.0.js.

  7. Обновите ссылку на скрипт Cordova в файле www/index.html (и любых других файлах, содержащих ссылку на скрипт) на новый файл phonegap-1.1.0.js.

  8. Добавьте новую запись в Plugins в файле PhoneGap.plist. Ключ — com.phonegap.battery, а значение — PGBattery.

  9. Интегрируйте любой код, специфичный для проекта, который у вас есть в резервных копиях AppDelegate.h и AppDelegate.m, в новые файлы AppDelegate.

Обновление проектов 0.9.6 до 1.0.0

  1. Установите Cordova 1.0.0.

  2. Создайте резервную копию AppDelegate.m и AppDelegate.h в вашем проекте.

  3. Создайте новый проект. Вам понадобятся некоторые ресурсы из этого нового проекта.

  4. Скопируйте эти файлы из нового проекта в каталог вашего проекта, основанного на версии 0.9.6, на диске, заменяя старые файлы (сначала создайте резервную копию файлов, как указано в шаге 2 выше):

    AppDelegate.h
AppDelegate.m
MainViewController.h
MainViewController.m
MainViewController.xib

  5. Добавьте все файлы MainViewController в свой проект Xcode.

  6. Скопируйте файл www/phonegap-1.0.0.js из нового проекта в каталог www, и удалите файл www/phonegap-0.9.6.js.

  7. Обновите ссылку на скрипт Cordova в файле www/index.html (и любых других файлах, содержащих ссылку на скрипт) на новый файл phonegap-1.0.0.js.

  8. Добавьте новую запись в Plugins в файле PhoneGap.plist. Ключ — com.phonegap.battery, а значение — PGBattery.

  9. Интегрируйте любой код, специфичный для проекта, который у вас есть в резервных копиях AppDelegate.h и AppDelegate.m, в новые файлы AppDelegate.

© 2012, 2013, 2015 The Apache Software Foundation
Licensed under the Apache License 2.0.
https://cordova.apache.org/docs/en/6.x/guide/platforms/ios/upgrade.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API