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
Ce guide montre comment modifier des projets Android mise à niveau d‘anciennes versions de Cordova. La plupart de ces instructions s’appliquent aux projets créés avec un ensemble plu d‘outils de ligne de commande qui précèdent le cordova
utilitaire CLI. Voir l’Interface de ligne de commande pour plus d‘informations comment mettre à jour la version de l’interface CLI.
Il y a des mesures spécifiques de mise à niveau indispensable pour tirer parti des changements importants en 4.0.0. Tout d'abord, les étapes de mise à niveau communes sont nécessaires comme ci-dessous.
Pour les projets non-CLI, exécutez :
bin/update path/to/project
Pour les projets de la CLI :
Mise à jour le cordova
version CLI. Voir l'Interface de ligne de commande.
Exécutez cordova platform update android
dans vos projets existants.
Toutes les fonctionnalités de liste blanche sont maintenant implémentée via plugin. Sans un plugin, votre application n'est plus protégée par une liste blanche après mise à niveau vers 4.0.0. Cordova a deux plugins de liste blanche, qui offrent différents niveaux de protection.
Le plugin de cordova-plugin-whitelist
(recommandé)
cordova plugin ajouter cordova-plugin-crosswalk-webview
Le plugin de cordova-plugin-legacy-whitelist
cordova plugin ajouter cordova-plugin-legacy-whitelist
Par défaut, votre application continuera d‘utiliser le système WebView fournie par l’appareil. Si vous souhaitez utiliser le tableau de concordance WebView au lieu de cela, il suffit d'ajouter le plugin de passage pour piétons :
cordova plugin add cordova-plugin-crosswalk-webview
À ajouté le plugin, votre application obtient le passage pour piétons de WebView installé et configuré correctement.
Si votre application, utilisation d'un écran de démarrage, que la fonctionnalité a été transférée à un plugin. Les options de configuration pour les écrans de démarrage sont inchangées. La seule mise à niveau étape nécessaire consiste à ajouter le plugin :
cordova plugin add cordova-plugin-splashscreen
Pour les projets non-CLI, exécutez :
bin/update path/to/project
Pour les projets de la CLI :
Mise à jour le cordova
version CLI. Voir l'Interface de ligne de commande.
Exécutez cordova platform update android
dans vos projets existants.
Suivez les mêmes instructions que pour 3.2.0
.
À partir de 3.3.0, le runtime de Cordova est maintenant compilé comme une bibliothèque Android au lieu d‘un pot. Cela ne devrait avoir aucun effet pour l’utilisation de ligne de commande, mais IDE utilisateurs auront besoin d'importer le projet MyProject-CordovaLib
nouvellement ajouté dans leur espace de travail.
Pour les projets qui ont été créés avec le cordova CLI :
Mise à jour le cordova
version CLI. Voir l'Interface de ligne de commande.
Exécutez cordova platform update android
Pour les projets ne créés pas avec la CLI de cordova, exécutez :
bin/update <project_path>
AVERTISSEMENT : Sur Android 4.4 - 4.4.3 Android, création d‘un fichier d’entrée élément avec type = « file » n‘ouvrira pas la boîte de dialogue Sélecteur. Il s’agit d‘une régression avec Chrome sur Android et le problème peut être reproduit dans le navigateur de Chrome autonome sur Android (voir http://code.google.com/p/android/issues/detail?id=62220) la solution de contournement suggérée est d’utiliser le transfert de fichiers et fichiers plugins pour Android 4.4. Vous pouvez écouter un événement onClick du input type = « file » et ensuite apparaître un sélecteur de fichier UI. Afin de relier les données du formulaire avec le téléchargement, vous pouvez utiliser JavaScript pour fixer des valeurs de formulaire à la requête POST plusieurs partie qui fait du transfert de fichiers.
Pour les projets qui ont été créés avec le cordova CLI :
Mise à jour le cordova
version CLI. Voir l'Interface de ligne de commande.
Exécutez cordova platform update android
Pour les projets ne créés pas avec la CLI de cordova, exécutez :
bin/update <project_path>
Créez un projet Apache Cordova 3.0.0 utilisant le cordova CLI, tel que décrit dans l'Interface de ligne de commande.
Ajouter vos plates-formes le projet cordova, par exemple : cordova platform add android
.
Copiez le contenu du répertoire www
de votre projet dans le répertoire www
à la racine du projet Cordoue que vous venez de créer.
Copiez tout actif natif de votre ancien projet dans les répertoires appropriés sous platforms/android
: ce répertoire est où votre projet cordova-android natif existe.
Utilisez l‘outil CLI de cordova pour installer des plugins dont vous avez besoin. Notez que la CLI gère toutes les principales API comme plugins, donc ils peuvent avoir besoin d’être ajouté. Seulement 3.0.0 plugins sont compatibles avec l'interface CLI.
Créez un nouveau projet Apache Cordova Android.
Copiez le contenu du répertoire www
dans le nouveau projet.
Copiez tout actif Android native du répertoire res
au nouveau projet.
Copier les plug-ins que vous avez installé des src
de sous-répertoires dans le nouveau projet.
Veillez à mettre à niveau tout déconseillé < plugin >
références de votre ancien fichier config.xml
à la nouvelle <feature>
spécification.
Mise à jour toutes les références à l'ensemble de org.apache.cordova.api
pour être org.apache.cordova
.
NOTE : toutes les principales API ont été supprimées et doit être installé comme plugins. S‘il vous plaît voir les Plugman à l’aide à gérer les Plugins Guide pour plus de détails.
bin/update <project_path>
.Retirer cordova-2.7.0.jar
du répertoire libs
du projet.
Cordova-2.8.0.jar
s'ajoute le répertoire du projet libs
.
Si vous utilisez Eclipse, veuillez actualiser votre projet Eclipse et faire un nettoyage.
Copiez le nouveau cordova.js
dans votre projet.
Mettez à jour votre code HTML permettant d'utiliser le nouveau fichier cordova.js
.
Copiez le fichier res/xml/config.xml
pour correspondre à framework/res/xml/config.xml
.
Mise à jour framework/res/xml/config.xml
pour avoir des paramètres similaires comme il l'a fait précédemment.
Copier les fichiers bin/templates/cordova
pour le projet cordova
répertoire.
Retirer cordova-2.6.0.jar
du répertoire libs
du projet.
Cordova-2.7.0.jar
s'ajoute le répertoire du projet libs
.
Si vous utilisez Eclipse, veuillez actualiser votre projet Eclipse et faire un nettoyage.
Copiez le nouveau cordova-2.7.0.js
dans votre projet.
Mettez à jour votre code HTML permettant d'utiliser le nouveau fichier de cordova-2.7.0.js
.
Copie le res/xml/config.xml
faire correspondreframework/res/xml/config.xml
.
Mise à jour framework/res/xml/config.xml
pour avoir des paramètres similaires comme il l'a fait précédemment.
Copier les fichiers bin/templates/cordova
pour le projet cordova
répertoire.
Retirer cordova-2.5.0.jar
du répertoire libs
du projet.
Cordova-2.6.0.jar
s'ajoute le répertoire du projet libs
.
Si vous utilisez Eclipse, veuillez actualiser votre projet Eclipse et faire un nettoyage.
Copiez le nouveau cordova-2.6.0.js
dans votre projet.
Mettre à jour votre code HTML pour utiliser le nouveau cordova-2.6.0.js
fichier.
Copie le res/xml/config.xml
faire correspondreframework/res/xml/config.xml
.
Mise à jour framework/res/xml/config.xml
pour avoir des paramètres similaires comme il l'a fait précédemment.
Copier les fichiers bin/templates/cordova
pour le projet cordova
répertoire.
Exécutez bin/update < projet >
avec le chemin d'accès du projet figurant dans le répertoire Source de Cordova.
Retirer cordova-2.4.0.jar
du répertoire libs
du projet.
Cordova-2.5.0.jar
s'ajoute le répertoire du projet libs
.
Si vous utilisez Eclipse, veuillez actualiser votre projet Eclipse et faire un nettoyage.
Copiez le nouveau cordova-2.5.0.js
dans votre projet.
Mettre à jour votre code HTML pour utiliser le nouveau cordova-2.5.0.js
fichier.
Copie le res/xml/config.xml
faire correspondreframework/res/xml/config.xml
.
Mise à jour framework/res/xml/config.xml
pour avoir des paramètres similaires comme il l'a fait précédemment.
Copier les fichiers bin/templates/cordova
pour le projet cordova
répertoire.
Retirer cordova-2.3.0.jar
du répertoire libs
du projet.
Cordova-2.4.0.jar
s'ajoute le répertoire du projet libs
.
Si vous utilisez Eclipse, veuillez actualiser votre projet Eclipse et faire un nettoyage.
Copiez le nouveau cordova-2.4.0.js
dans votre projet.
Mettre à jour votre code HTML pour utiliser le nouveau cordova-2.4.0.js
fichier.
Copie le res/xml/config.xml
faire correspondreframework/res/xml/config.xml
.
Copier les fichiers bin/templates/cordova
pour le projet cordova
répertoire.
Retirer cordova-2.2.0.jar
du répertoire libs
du projet.
Cordova-2.3.0.jar
s'ajoute le répertoire du projet libs
.
Si vous utilisez Eclipse, veuillez actualiser votre projet Eclipse et faire un nettoyage.
Copiez le nouveau cordova-2.3.0.js
dans votre projet.
Mettre à jour votre code HTML pour utiliser le nouveau cordova-2.3.0.js
fichier.
Copie le res/xml/config.xml
faire correspondreframework/res/xml/config.xml
.
Copier les fichiers bin/templates/cordova
pour le projet cordova
répertoire.
Retirer cordova-2.1.0.jar
du répertoire libs
du projet.
Cordova-2.2.0.jar
s'ajoute le répertoire du projet libs
.
Si vous utilisez Eclipse, veuillez actualiser votre projet Eclipse et faire un nettoyage.
Copiez le nouveau cordova-2.2.0.js
dans votre projet.
Mettre à jour votre code HTML pour utiliser le nouveau cordova-2.2.0.js
fichier.
Copie le res/xml/config.xml
faire correspondreframework/res/xml/config.xml
.
Copier les fichiers bin/templates/cordova
pour le projet cordova
répertoire.
Retirer cordova-2.0.0.jar
du répertoire libs
du projet.
Cordova-2.1.0.jar
s'ajoute le répertoire du projet libs
.
Si vous utilisez Eclipse, veuillez actualiser votre projet Eclipse et faire un nettoyage.
Copiez le nouveau cordova-2.1.0.js
dans votre projet.
Mettre à jour votre code HTML pour utiliser le nouveau cordova-2.1.0.js
fichier.
Copie le res/xml/config.xml
faire correspondreframework/res/xml/config.xml
.
Copier les fichiers bin/templates/cordova
pour le projet cordova
répertoire.
Retirer cordova-1.9.0.jar
du répertoire libs
du projet.
Cordova-2.0.0.jar
s'ajoute le répertoire du projet libs
.
Si vous utilisez Eclipse, veuillez actualiser votre projet Eclipse et faire un nettoyage.
Copiez le nouveau cordova-2.0.0.js
dans votre projet.
Mettre à jour votre code HTML pour utiliser le nouveau cordova-2.0.0.js
fichier.
Copie le res/xml/config.xml
faire correspondreframework/res/xml/config.xml
.
Dans la 2.0.0 version, le fichier config.xml
combine et remplace cordova.xml
et plugins.xml
. Les anciens fichiers sont obsolètes et pendant qu'ils travaillent toujours en 2.0.0, cessera de fonctionner dans une version ultérieure.
Retirer cordova-1.8.0.jar
du répertoire libs
du projet.
Cordova-1.9.0.jar
s'ajoute le répertoire du projet libs
.
Si vous utilisez Eclipse, veuillez actualiser votre projet Eclipse et faire un nettoyage.
Copiez le nouveau cordova-1.9.0.js
dans votre projet.
Mettez à jour votre code HTML permettant d'utiliser le nouveau fichier de cordova-1.9.0.js
.
Mise à jour res/xml/plugins.xml
pour correspondreframework/res/xml/plugins.xml
.
En raison de l‘introduction de la CordovaWebView
dans le 1.9.0 version, plugins tiers peuvent ne pas fonctionner. Ces plugins ont besoin d’obtenir un contexte de l' CordovaInterface
à l‘aide de getContext()
ou getActivity()
. Si vous n’êtes pas un développeur Android expérimenté, veuillez contacter le responsable de plugin et ajouter cette tâche à leur traqueur de bug.
Retirer cordova-1.8.0.jar
du répertoire libs
du projet.
Cordova-1.8.1.jar
s'ajoute le répertoire du projet libs
.
Si vous utilisez Eclipse, veuillez actualiser votre projet Eclipse et faire un nettoyage.
Copiez le nouveau cordova-1.8.1.js
dans votre projet.
Mettez à jour votre code HTML permettant d'utiliser le nouveau fichier de cordova-1.8.1.js
.
Mise à jour res/xml/plugins.xml
pour correspondreframework/res/xml/plugins.xml
.
Retirer cordova-1.7.0.jar
du répertoire libs
du projet.
Cordova-1.8.0.jar
s'ajoute le répertoire du projet libs
.
Si vous utilisez Eclipse, veuillez actualiser votre projet Eclipse et faire un nettoyage.
Copiez le nouveau cordova-1.8.0.js
dans votre projet.
Mettre à jour votre code HTML pour utiliser le nouveau cordova-1.8.0.js
fichier.
Mise à jour res/xml/plugins.xml
pour correspondreframework/res/xml/plugins.xml
.
Retirer cordova-1.7.0.jar
du répertoire libs
du projet.
Cordova-1.8.0.jar
s'ajoute le répertoire du projet libs
.
Si vous utilisez Eclipse, veuillez actualiser votre projet Eclipse et faire un nettoyage.
Copiez le nouveau cordova-1.8.0.js
dans votre projet.
Mettre à jour votre code HTML pour utiliser le nouveau cordova-1.8.0.js
fichier.
Mise à jour res/xml/plugins.xml
pour correspondre framework/res/xml/plugins.xml
.
Retirer cordova-1.6.1.jar
du répertoire libs
du projet.
Cordova-1.7.0.jar
s'ajoute le répertoire du projet libs
.
Si vous utilisez Eclipse, veuillez actualiser votre projet Eclipse et faire un nettoyage.
Copiez le nouveau cordova-1.7.0.js
dans votre projet.
Mise à jour res/xml/plugins.xml
pour correspondreframework/res/xml/plugins.xml
.
Retirer cordova-1.6.0.jar
du répertoire libs
du projet.
Cordova-1.6.1.jar
s'ajoute le répertoire du projet libs
.
Si vous utilisez Eclipse, veuillez actualiser votre projet Eclipse et faire un nettoyage.
Copiez le nouveau cordova-1.6.1.js
dans votre projet.
Mise à jour res/xml/plugins.xml
pour correspondreframework/res/xml/plugins.xml
.
Retirer cordova-1.5.0.jar
du répertoire libs
du projet.
Cordova-1.6.0.jar
s'ajoute le répertoire du projet libs
.
Si vous utilisez Eclipse, veuillez actualiser votre projet Eclipse et faire un nettoyage.
Copiez le nouveau cordova-1.6.0.js
dans votre projet.
Mettez à jour votre code HTML permettant d'utiliser le nouveau fichier de cordova-1.6.0.js
.
Mise à jour res/xml/plugins.xml
pour correspondreframework/res/xml/plugins.xml
.
Remplacez res/xml/phonegap.xml
par res/xml/cordova.xml
pour correspondre à framework/res/xml/cordova.xml
.
Retirer phonegap-1.4.0.jar
du répertoire libs
du projet.
Cordova-1.5.0.jar
s'ajoute le répertoire du projet libs
.
Si vous utilisez Eclipse, veuillez actualiser votre projet Eclipse et faire un nettoyage.
Copiez le nouveau cordova-1.5.0.js
dans votre projet.
Mettez à jour votre code HTML permettant d'utiliser le nouveau fichier de cordova-1.5.0.js
.
Mise à jour res/xml/plugins.xml
pour correspondreframework/res/xml/plugins.xml
.
Remplacez res/xml/phonegap.xml
par res/xml/cordova.xml
pour correspondre à framework/res/xml/cordova.xml
.
Retirer phonegap-1.3.0.jar
du répertoire libs
du projet.
Ajouter phonegap-1.4.0.jar
pour le répertoire du projet libs
.
Si vous utilisez Eclipse, veuillez actualiser votre projet Eclipse et faire un nettoyage.
Copiez le nouveau phonegap-1.4.0.js
dans votre projet.
Mettez à jour votre code HTML permettant d'utiliser le nouveau fichier phonegap-1.4.0.js
.
Mise à jour res/xml/plugins.xml
pour correspondreframework/res/xml/plugins.xml
.
Mise à jour res/xml/phonegap.xml
pour correspondreframework/res/xml/phonegap.xml
.
Retirer phonegap-1.2.0.jar
du répertoire libs
du projet.
Ajouter phonegap-1.3.0.jar
pour le répertoire du projet libs
.
Si vous utilisez Eclipse, veuillez actualiser votre projet Eclipse et faire un nettoyage.
Copiez le nouveau phonegap-1.3.0.js
dans votre projet.
Mettez à jour votre code HTML permettant d'utiliser le nouveau fichier phonegap-1.2.0.js
.
Mise à jour res/xml/plugins.xml
pour correspondreframework/res/xml/plugins.xml
.
Mise à jour res/xml/phonegap.xml
pour correspondreframework/res/xml/phonegap.xml
.
Retirer phonegap-1.1.0.jar
du répertoire libs
du projet.
Ajouter phonegap-1.2.0.jar
pour le répertoire du projet libs
.
Si vous utilisez Eclipse, veuillez actualiser votre projet Eclipse et faire un nettoyage.
Copiez le nouveau phonegap-1.2.0.js
dans votre projet.
Mettez à jour votre code HTML permettant d'utiliser le nouveau fichier phonegap-1.2.0.js
.
Mise à jour res/xml/plugins.xml
pour correspondreframework/res/xml/plugins.xml
.
Mise à jour res/xml/phonegap.xml
pour correspondreframework/res/xml/phonegap.xml
.
Retirer phonegap-1.0.0.jar
du répertoire libs
du projet.
Ajouter phonegap-1.1.0.jar
pour le répertoire du projet libs
.
Si vous utilisez Eclipse, veuillez actualiser votre projet Eclipse et faire un nettoyage.
Copiez le nouveau phonegap-1.1.0.js
dans votre projet.
Mettez à jour votre code HTML permettant d'utiliser le nouveau fichier phonegap-1.1.0.js
.
Mise à jour res/xml/plugins.xml
pour correspondreframework/res/xml/plugins.xml
.
Retirer phonegap-0.9.6.jar
du répertoire libs
du projet.
Ajouter phonegap-1.0.0.jar
pour le répertoire du projet libs
.
Si vous utilisez Eclipse, veuillez actualiser votre projet Eclipse et faire un nettoyage.
Copiez le nouveau phonegap-1.0.0.js
dans votre projet.
Mettez à jour votre code HTML permettant d'utiliser le nouveau fichier phonegap-1.0.0.js
.
Ajouter le res/xml/plugins.xml
pour correspondre à framework/res/xml/plugins.xml
.