Spec-Zone.ru › Cordova 9

Обновление iOS

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

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

Обновление проектов 4.x

cordova platform rm ios
cordova platform add ios

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

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

bin/update path/to/project

Для проектов с CLI:

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

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

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

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

bin/update path/to/project

Для проектов с CLI:

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

  2. Запустите cordova platform update ios

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

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

bin/update path/to/project

Для проектов с CLI:

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

  2. Запустите cordova platform update ios

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

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

bin/update path/to/project

Для проектов с CLI:

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

  2. Запустите cordova platform update ios

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

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

bin/update path/to/project

Для проектов с CLI:

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

  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, как описано в Интерфейсе командной строки.

  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 в соответствии с файлом из нового проекта (см. этот diff).

  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 в соответствии с файлом из нового проекта (см. этот diff).

  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 подключения к тому же 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 Shell. Вам потребуются ресурсы из этого нового проекта.

  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 Shell. Вам потребуются ресурсы из этого нового проекта.

  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 Shell. Вам потребуются ресурсы из этого нового проекта.

  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, в группе Supporting Files. Ключ - Device, а значение - CDVDevice.

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

  8. Удалите verify.sh из группы Supporting Files.

  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 Capture, вам понадобятся новые ресурсы для 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. Интегрируйте любые настройки, записи Плагины и ExternalHosts, которые у вас были в резервной копии Cordova.plist, в новый файл Cordova.plist.

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

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

  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.h и AppDelegate.m в новые файлы AppDelegate.

Обновление проектов 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.h и AppDelegate.m в новые файлы AppDelegate.

Обновление проектов 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/9.x/guide/platforms/ios/upgrade.html

Spec-Zone.ru

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