license: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the “License”); you may not use this file except in compliance with the License. You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
В этом руководстве показано, как изменить Android проекты при обновлении старых версий Cordova. Большинство этих инструкций применимы для проектов, созданных со старым набором средств командной строки, которые предшествуют утилите CLI cordova
. Смотрите раздел “Интерфейс командной строки” для получения информации как обновить версию CLI.
Это конкретные шаги обновления которые необходимо выполнить чтобы использовать существенные изменения в 4.0.0. Во-первых необходимы общие шаги обновления, как показано ниже.
Для проектов-CLI выполните:
bin/обновить путь/к/проекта
Для проектов CLI:
Обновите версию cordova
CLI. Смотрите “Интерфейс командной строки”.
Запустите cordova platform update android
в ваших проектах.
Теперь вся функциональность списка разрешенных ресурсов реализована через плагин. Без плагина ваше приложение более не защищен списком разрешенных ресурсов после обновления до 4.0.0. Cordova имеет два плагина для списка разрешенных ресурсов, которые обеспечивают различные уровни защиты.
Плагин cordova-plugin-whitelist
(рекомендуемый)
cordova plugin add cordova-plugin-crosswalk-webview
Плагин cordova-plugin-legacy-whitelist
cordova plugin add cordova-plugin-legacy-whitelist
По умолчанию ваше приложение будет продолжать использовать системный WebView, предоставляемый устройством. Если вы хотите вместо этого использовать WebView CrossWalk, просто добавьте плагин CrossWalk:
cordova plugin add cordova-plugin-crosswalk-webview
После добавления плагина, ваше приложение получит WebView Crosswalk установленным и правильно настроеным.
Если ваше приложение использовала экрана-заставку, то эта функциональность была перемещена в плагин. Параметры конфигурации для экрана-заставки остались неизменными. Единственный требуемый шаг для обновления это добавление плагина:
cordova plugin add cordova-plugin-splashscreen
Для проектов-CLI выполните:
bin/обновить путь/к/проекта
Для проектов CLI:
Обновите версию cordova
CLI. Смотрите “Интерфейс командной строки”.
Запустите cordova platform update android
в ваших проектах.
Следуйте тем же инструкциям что и для 3.2.0
.
Начиная с 3.3.0, среда выполнения Cordova теперь компилируется как Android библиотека вместо Jar. Это не должно иметь никакого эффекта при использовании из командной строки, но пользователям IDE нужно будет импортировать новые проекты MyProject-CordovaLib
в их рабочее пространство.
Для проектов, которые были созданы с помощью cordova CLI:
Обновите версию cordova
CLI. Смотрите “Интерфейс командной строки”.
Run cordova platform update android
Для проектов, не созданных с помощью cordova CLI выполните:
bin/update <project_path>
Предупреждение: На Android 4.4 - Android 4.4.3, создание элемента ввода input type=“file” не открывает диалоговое окно выбора файла. Это регрессия из Chromium на Android, и проблемы могут быть воспроизведены в автономном браузер Chrome на Android (см. http://code.google.com/p/android/issues/detail?id=62220) предложенное решение заключается в использовании плагинов FileTransfer и File для Android 4.4. Можно прослушивать событие onClick для input type=“file” и затем показывать пользовательский интерфейс средства выбора файлов. Для того, чтобы связать данные формы с загрузки, можно использовать JavaScript для присоединения значений формы к составному запросу POST, что делает FileTransfer.
Для проектов, которые были созданы с помощью cordova CLI:
Обновите версию cordova
CLI. Смотрите “Интерфейс командной строки”.
Run cordova platform update android
Для проектов, не созданных с помощью cordova CLI выполните:
bin/update <project_path>
Создайте новый проект Apache Cordova 3.0.0 используя Cordova CLI, как описано в разделе “Интерфейс командной строки”.
Добавьте ваши платформы в проект Cordova, например: cordova platform add ios
.
Скопируйте содержимое каталога www
в каталог www
проекта Cordova который вы только что создали.
Скопируйте любые платформенные ресурсы из старого проекта в соответствующие каталоги в platforms/android
: это директория где расположен проект cordova-android.
Используйте Сordova CLI для установки необходимых вам плагинов. Обратите внимание что CLI интерпретирует все базовые APIs как плагины, так что они тоже должны быть добавлены. Только плагины для версии 3.0.0 поддерживаются CLI.
Создайте новый проект Apache Cordova Android.
Скопируйте содержимое каталога www
в новый проект.
Скопируйте любые ресурсы платформы Android из каталога res
в новый проект.
Скопируйте любые плагины, которые вы установили из подкаталогов src
в новый проект.
Убедитесь что вы обновили любые устаревшие ссылки <plugin>
из вашего старого файла config.xml
в новое определение в <feature>
.
Обновите ссылки с пакета org.apache.cordova.api
на org.apache.cordova
.
Примечание: все основные API были удалены и должны быть установлены как плагины. Для подробной информации смотрите раздел “Использование Plugman для управления расширениями”.
bin/update <project_path>
.Удалить cordova-2.7.0.jar
из каталога проекта libs
.
Добавить cordova-2.8.0.jar
в каталог проекта libs
.
Если вы используете Eclipse, обновите ваш проект Eclipse и выполните clean.
Скопируйте новый cordova.js
в ваш проект.
Обновите ваш HTML, чтобы использовать новый cordova.js
файл.
Скопируйте res/xml/config.xml
файл в соответствии с framework/res/xml/config.xml
.
Обновите framework/res/xml/config.xml
чтобы иметь одинаковые параметры, как это было ранее.
Скопируйте файлы из bin/templates/cordova
в каталог проекта cordova
.
Удалить cordova-2.6.0.jar
из каталога проекта libs
.
Добавить cordova-2.7.0.jar
в каталог проекта libs
.
Если вы используете Eclipse, обновите ваш проект Eclipse и выполните clean.
Скопируйте новый cordova-2.7.0.js
в ваш проект.
Обновите ваш HTML, чтобы использовать новый cordova-2.7.0.js
файл.
Копия res/xml/config.xml
соответствоватьframework/res/xml/config.xml
.
Обновите framework/res/xml/config.xml
чтобы иметь одинаковые параметры, как это было ранее.
Скопируйте файлы из bin/templates/cordova
в каталог проекта cordova
.
Удалить cordova-2.5.0.jar
из каталога проекта libs
.
Добавить cordova-2.6.0.jar
в каталог проекта libs
.
Если вы используете Eclipse, обновите ваш проект Eclipse и выполните clean.
Скопируйте новый cordova-2.6.0.js
в ваш проект.
Обновить ваш HTML, чтобы использовать новый cordova-2.6.0.js
файл.
Копия res/xml/config.xml
соответствоватьframework/res/xml/config.xml
.
Обновите framework/res/xml/config.xml
чтобы иметь одинаковые параметры, как это было ранее.
Скопируйте файлы из bin/templates/cordova
в каталог проекта cordova
.
Запустите bin/update <project>
из пути проекта, перечисленным в исходном каталоге Cordova.
Удалить cordova-2.4.0.jar
из каталога проекта libs
.
Добавить cordova-2.5.0.jar
в каталог проекта libs
.
Если вы используете Eclipse, обновите ваш проект Eclipse и выполните clean.
Скопируйте новый cordova-2.5.0.js
в ваш проект.
Обновить ваш HTML, чтобы использовать новый cordova-2.5.0.js
файл.
Копия res/xml/config.xml
соответствоватьframework/res/xml/config.xml
.
Обновите framework/res/xml/config.xml
чтобы иметь одинаковые параметры, как это было ранее.
Скопируйте файлы из bin/templates/cordova
в каталог проекта cordova
.
Удалить cordova-2.3.0.jar
из каталога проекта libs
.
Добавить cordova-2.4.0.jar
в каталог проекта libs
.
Если вы используете Eclipse, обновите ваш проект Eclipse и выполните clean.
Скопируйте новый cordova-2.4.0.js
в ваш проект.
Обновить ваш HTML, чтобы использовать новый cordova-2.4.0.js
файл.
Копия res/xml/config.xml
соответствоватьframework/res/xml/config.xml
.
Скопируйте файлы из bin/templates/cordova
в каталог проекта cordova
.
Удалить cordova-2.2.0.jar
из каталога проекта libs
.
Добавить cordova-2.3.0.jar
в каталог проекта libs
.
Если вы используете Eclipse, обновите ваш проект Eclipse и выполните clean.
Скопируйте новый cordova-2.3.0.js
в ваш проект.
Обновить ваш HTML, чтобы использовать новый cordova-2.3.0.js
файл.
Копия res/xml/config.xml
соответствоватьframework/res/xml/config.xml
.
Скопируйте файлы из bin/templates/cordova
в каталог проекта cordova
.
Удалить cordova-2.1.0.jar
из каталога проекта libs
.
Добавить cordova-2.2.0.jar
в каталог проекта libs
.
Если вы используете Eclipse, обновите ваш проект Eclipse и выполните clean.
Скопируйте новый cordova-2.2.0.js
в ваш проект.
Обновить ваш HTML, чтобы использовать новый cordova-2.2.0.js
файл.
Копия res/xml/config.xml
соответствоватьframework/res/xml/config.xml
.
Скопируйте файлы из bin/templates/cordova
в каталог проекта cordova
.
Удалить cordova-2.0.0.jar
из каталога проекта libs
.
Добавить cordova-2.1.0.jar
в каталог проекта libs
.
Если вы используете Eclipse, обновите ваш проект Eclipse и выполните clean.
Скопируйте новый cordova-2.1.0.js
в ваш проект.
Обновить ваш HTML, чтобы использовать новый cordova-2.1.0.js
файл.
Копия res/xml/config.xml
соответствоватьframework/res/xml/config.xml
.
Скопируйте файлы из bin/templates/cordova
в каталог проекта cordova
.
Удалить cordova-1.9.0.jar
из каталога проекта libs
.
Добавить cordova-2.0.0.jar
в каталог проекта libs
.
Если вы используете Eclipse, обновите ваш проект Eclipse и выполните clean.
Скопируйте новый cordova-2.0.0.js
в ваш проект.
Обновить ваш HTML, чтобы использовать новый cordova-2.0.0.js
файл.
Копия res/xml/config.xml
соответствоватьframework/res/xml/config.xml
.
В релизе 2.0.0, файл config.xml
сочетает в себе и заменяет cordova.xml
и plugins.xml
. Старые файлы являются устаревшими и хотя они по-прежнему работают в 2.0.0, перестанут работать в будущих выпусках.
Удалить cordova-1.8.1.jar
из проекта libs
каталог.
Добавить cordova-1.9.0.jar
в каталог проекта libs
.
Если вы используете Eclipse, обновите ваш проект Eclipse и выполните clean.
Скопируйте новый cordova-1.9.0.js
в ваш проект.
Обновите ваш HTML, чтобы использовать новый cordova-1.9.0.js
файл.
Обновите res/xml/plugins.xml
в соответствии с framework/res/xml/plugins.xml
.
Из-за введения CordovaWebView
в релизе 1.9.0, плагины третьих лиц могут не работать. Эти плагины должны получать контекст из CordovaInterface
с помощью getContext()
или getActivity()
. Если вы не являетесь опытным разработчиком Android, пожалуйста, свяжитесь с сопровождающим плагин лицом и добавьте эту задачу в их баг трекер.
Удалить cordova-1.8.1.jar
из проекта libs
каталог.
Добавить cordova-1.8.1.jar
в каталог проекта libs
.
Если вы используете Eclipse, обновите ваш проект Eclipse и выполните clean.
Скопируйте новый cordova-1.8.1.js
в ваш проект.
Обновите ваш HTML, чтобы использовать новый cordova-1.8.1.js
файл.
Обновите res/xml/plugins.xml
в соответствии с framework/res/xml/plugins.xml
.
Удалить cordova-1.7.0.jar
из каталога проекта libs
.
Добавить cordova-1.8.0.jar
в каталог проекта libs
.
Если вы используете Eclipse, обновите ваш проект Eclipse и выполните clean.
Скопируйте новый cordova-1.8.0.js
в ваш проект.
Обновить ваш HTML, чтобы использовать новый cordova-1.8.0.js
файл.
Обновите res/xml/plugins.xml
в соответствии с framework/res/xml/plugins.xml
.
Удалить cordova-1.7.0.jar
из каталога проекта libs
.
Добавить cordova-1.8.0.jar
в каталог проекта libs
.
Если вы используете Eclipse, обновите ваш проект Eclipse и выполните clean.
Скопируйте новый cordova-1.8.0.js
в ваш проект.
Обновить ваш HTML, чтобы использовать новый cordova-1.8.0.js
файл.
Обновите res/xml/plugins.xml
в соответствии с framework/res/xml/plugins.xml
.
Удалить cordova-1.6.1.jar
из каталога проекта libs
.
Добавить cordova-1.7.0.jar
в каталог проекта libs
.
Если вы используете Eclipse, обновите ваш проект Eclipse и выполните clean.
Скопируйте новый cordova-1.7.0.js
в ваш проект.
Обновите res/xml/plugins.xml
в соответствии с framework/res/xml/plugins.xml
.
Удалить cordova-1.6.0.jar
из каталога проекта libs
.
Добавить cordova-1.6.1.jar
в каталог проекта libs
.
Если вы используете Eclipse, обновите ваш проект Eclipse и выполните clean.
Скопируйте новый cordova-1.6.1.js
в ваш проект.
Обновите res/xml/plugins.xml
в соответствии с framework/res/xml/plugins.xml
.
Удалить cordova-1.5.0.jar
из каталога проекта libs
.
Добавить cordova-1.6.0.jar
в каталог проекта libs
.
Если вы используете Eclipse, обновите ваш проект Eclipse и выполните clean.
Скопируйте новый cordova-1.6.0.js
в ваш проект.
Обновите ваш HTML, чтобы использовать новый cordova-1.6.0.js
файл.
Обновите res/xml/plugins.xml
в соответствии с framework/res/xml/plugins.xml
.
Замените res/xml/phonegap.xml
на res/xml/cordova.xml
для соотвествия файлу framework/res/xml/cordova.xml
.
Удалить phonegap-1.4.0.jar
из каталога проекта libs
.
Добавить cordova-1.5.0.jar
в каталог проекта libs
.
Если вы используете Eclipse, обновите ваш проект Eclipse и выполните clean.
Скопируйте новый cordova-1.5.0.js
в ваш проект.
Обновите ваш HTML, чтобы использовать новый cordova-1.5.0.js
файл.
Обновите res/xml/plugins.xml
в соответствии с framework/res/xml/plugins.xml
.
Замените res/xml/phonegap.xml
на res/xml/cordova.xml
для соотвествия файлу framework/res/xml/cordova.xml
.
Удалить phonegap-1.3.0.jar
из каталога проекта libs
.
Добавить phonegap-1.4.0.jar
в каталог проекта libs
.
Если вы используете Eclipse, обновите ваш проект Eclipse и выполните clean.
Скопируйте новый phonegap-1.4.0.js
в ваш проект.
Обновите ваш HTML, чтобы использовать новый файл phonegap-1.4.0.js
.
Обновите res/xml/plugins.xml
в соответствии с framework/res/xml/plugins.xml
.
Обновление res/xml/phonegap.xml
в соответствии c framework/res/xml/phonegap.xml
.
Удалить phonegap-1.2.0.jar
из каталога проекта libs
.
Добавить phonegap-1.3.0.jar
в каталог проекта libs
.
Если вы используете Eclipse, обновите ваш проект Eclipse и выполните clean.
Скопируйте новый phonegap-1.3.0.js
в ваш проект.
Обновите ваш HTML, чтобы использовать новый файл phonegap-1.2.0.js
.
Обновите res/xml/plugins.xml
в соответствии с framework/res/xml/plugins.xml
.
Обновление res/xml/phonegap.xml
в соответствии c framework/res/xml/phonegap.xml
.
Удалить phonegap-1.1.0.jar
из каталога проекта libs
.
Добавить phonegap-1.2.0.jar
в каталог проекта libs
.
Если вы используете Eclipse, обновите ваш проект Eclipse и выполните clean.
Скопируйте новый phonegap-1.2.0.js
в ваш проект.
Обновите ваш HTML, чтобы использовать новый файл phonegap-1.2.0.js
.
Обновите res/xml/plugins.xml
в соответствии с framework/res/xml/plugins.xml
.
Обновление res/xml/phonegap.xml
в соответствии c framework/res/xml/phonegap.xml
.
Удалить phonegap-1.0.0.jar
из каталога проекта libs
.
Добавить phonegap-1.1.0.jar
в каталог проекта libs
.
Если вы используете Eclipse, обновите ваш проект Eclipse и выполните clean.
Скопируйте новый phonegap-1.1.0.js
в ваш проект.
Обновите ваш HTML, чтобы использовать новый файл phonegap-1.1.0.js
.
Обновите res/xml/plugins.xml
в соответствии с framework/res/xml/plugins.xml
.
Удалить phonegap-0.9.6.jar
из каталога проекта libs
.
Добавить phonegap-1.0.0.jar
в каталог проекта libs
.
Если вы используете Eclipse, обновите ваш проект Eclipse и выполните clean.
Скопируйте новый phonegap-1.0.0.js
в ваш проект.
Обновите ваш HTML, чтобы использовать новый файл phonegap-1.0.0.js
.
Обновите res/xml/plugins.xml
в соответствии с framework/res/xml/plugins.xml
.