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 BlackBerry 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.
Pour les projets non-CLI, exécutez :
bin/mise à jour chemin/de/projet
Pour les projets de la CLI :
Mise à jour le cordova version CLI. Voir l'Interface de ligne de commande.
Exécutez cordova platform update blackberry dans vos projets existants.
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écutezcordova platform update blackberry
Pour les projets ne créés pas avec la CLI de cordova, exécutez :
bin/mise à jour < project_path >
Créez un projet Apache Cordova 3.1.0 utilisant le cordova CLI, tel que décrit dans l'Interface de ligne de commande.
Ajoutez vos plates-formes cordova au projet, par exemple :cordova platform add blackberry10.
Copiez le contenu du projet original www Répertoire de la www répertoire à la racine du projet Cordoue vous venez de créer.
Copier ou écraser tout actif natif de votre projet d'origine ( Resources , etc..)
Copie le config.xml fichier dans le www répertoire et supprimer les définitions de n'importe quel plugin. Vous devez modifier les paramètres ICIS plutôt que dans le répertoire de la plate-forme.
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é. Uniquement les plugins marqué 3.0.0 et ci-dessus sont compatibles avec l'interface CLI.
Générer et tester.
Veuillez noter que la CLI prend en charge la plate-forme BlackBerry10 exclusivement. Pour PlayBook et BBOS, s'il vous plaît voir Cordova version 2.9.0 et en dessous.
Créez un projet Apache Cordova 3.0.0 utilisant le cordova CLI, tel que décrit dans l'Interface de ligne de commande.
Ajoutez vos plates-formes cordova au projet, par exemple :cordova platform add blackberry10.
Copiez le contenu du projet original www Répertoire de la www répertoire à la racine du projet Cordoue vous venez de créer.
Copier ou écraser tout actif natif de votre projet d'origine ( Resources , etc..)
Copie le config.xml fichier dans le www répertoire et supprimer les définitions de n'importe quel plugin. Vous devez modifier les paramètres ICIS plutôt que dans le répertoire de la plate-forme.
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.
Générer et tester.
Pour BlackBerry 10 :
Téléchargez et extrayez la source Cordova 2.9.0 vers un emplacement de répertoire permanent sur votre disque dur, par exemple à~/Cordova-2.9.0.
Quittez tous les outils SDK en cours d'exécution : Eclipse, Momentics et autres.
Naviguez jusqu‘au répertoire où vous avez mis la source téléchargé ci-dessus, à l’aide d'un unix comme terminal : Terminal.app, Cygwin, Bash, etc..
Créez un nouveau projet, comme décrit dans BlackBerry Shell Tool Guide. Cela devient la maison de votre projet mis à jour.
Copiez votre source de projets de l'ancien projet /www répertoire vers du nouveau projet /www répertoire.
Mettre à jour la référence de script Cordova dans le www/index.html fichier (et tous les autres fichiers qui contiennent la référence de script) pour pointer vers le nouveau cordova.js fichier.
Pour BlackBerryOS/Playbook :
Téléchargez et extrayez la source Cordova 2.9.0 vers un emplacement de répertoire permanent sur votre disque dur, par exemple à~/Cordova-2.9.0.
Quittez tous les outils SDK en cours d'exécution : Eclipse, Momentics et autres.
Naviguez jusqu‘au répertoire où vous avez mis la source téléchargé ci-dessus, à l’aide d'un unix comme terminal : Terminal.app, Cygwin, Bash, etc..
Créez un nouveau projet, comme décrit dans iOS Shell Tool Guide. Vous avez besoin de l'actif de ce nouveau projet.
Copie le www/cordova.js fichier à partir du nouveau projet dans le www répertoire et supprimer le www/cordova.js fichier.
Mettre à jour la référence de script Cordova dans le www/index.html fichier (et tous les autres fichiers qui contiennent la référence de script) pour pointer vers le nouveau cordova.js fichier.
Copie le native répertoire du nouveau projet dans le projet existant, en écrasant l'ancienne native répertoire.
Copie le lib répertoire du nouveau projet dans le projet existant, en écrasant l'ancienne lib répertoire.
Copie le cordova répertoire du nouveau projet dans le projet existant, en écrasant l'ancienne cordova répertoire.
BlackBerry 10 utilise les nouveaux outils CLI et gère la base API comme plugins. Les instructions de migrent votre projet pour un nouveau projet, plutôt que de mettre à jour un projet existant, en raison de la complexité de la mise à jour d‘un ancien projet. Aussi remarque que la js cordova script file s’appelle maintenant « cordova.js » et ne contienne plus une chaîne de version.
Téléchargez et extrayez la source Cordova 2.8.0 vers un emplacement de répertoire permanent sur votre disque dur, par exemple à~/Cordova-2.8.0.
Quittez tous les outils SDK en cours d'exécution : Eclipse, Momentics et autres.
Naviguez jusqu‘au répertoire où vous avez mis la source téléchargé ci-dessus, à l’aide d'un unix comme terminal : Terminal.app, Cygwin, Bash, etc..
Créez un nouveau projet, comme décrit dans BlackBerry Shell Tool Guide. Cela devient la maison de votre projet mis à jour.
Copiez votre source de projets de l'ancien projet /www répertoire vers du nouveau projet /www répertoire.
Mettre à jour la référence de script Cordova dans le www/index.html fichier (et tous les autres fichiers qui contiennent la référence de script) pour pointer vers le nouveau cordova.js fichier.
Pour BlackBerryOS/Playbook :
Téléchargez et extrayez la source Cordova 2.8.0 vers un emplacement de répertoire permanent sur votre disque dur, par exemple à~/Cordova-2.8.0.
Quittez tous les outils SDK en cours d'exécution : Eclipse, Momentics et autres.
Naviguez jusqu‘au répertoire où vous avez mis la source téléchargé ci-dessus, à l’aide d'un unix comme terminal : Terminal.app, Cygwin, Bash, etc..
Créez un nouveau projet, comme décrit dans iOS Shell Tool Guide. Vous avez besoin de l'actif de ce nouveau projet.
Copie le www/cordova.js fichier à partir du nouveau projet dans le www répertoire et supprimer le www/cordova.js fichier.
Mettre à jour la référence de script Cordova dans le www/index.html fichier (et tous les autres fichiers qui contiennent la référence de script) pour pointer vers le nouveau cordova.js fichier.
Copie le native répertoire du nouveau projet dans le projet existant, en écrasant l'ancienne native répertoire.
Copie le lib répertoire du nouveau projet dans le projet existant, en écrasant l'ancienne lib répertoire.
Copie le cordova répertoire du nouveau projet dans le projet existant, en écrasant l'ancienne cordova répertoire.
Téléchargez et extrayez la source Cordova 2.7.0 vers un emplacement de répertoire permanent sur votre disque dur, par exemple à~/Cordova-2.7.0.
Quittez tous les outils SDK en cours d'exécution : Eclipse, Momentics et autres.
Naviguez jusqu‘au répertoire où vous avez mis la source téléchargé ci-dessus, à l’aide d'un unix comme terminal : Terminal.app, Cygwin, Bash, etc..
Créez un nouveau projet, comme décrit dans BlackBerry Shell Tool Guide. Vous avez besoin de l'actif de ce nouveau projet.
Copie le www/cordova-2.7.0.js fichier à partir du nouveau projet dans le www répertoire et supprimer le www/cordova-2.6.0.js fichier.
Mettre à jour la référence de script Cordova dans le www/index.html fichier (et tous les autres fichiers qui contiennent la référence de script) pour pointer vers le nouveau cordova-2.7.0.js fichier.
Copie le native répertoire du nouveau projet dans le projet existant, en écrasant l'ancienne native répertoire.
Copie le lib répertoire du nouveau projet dans le projet existant, en écrasant l'ancienne lib répertoire.
Copie le cordova répertoire du nouveau projet dans le projet existant, en écrasant l'ancienne cordova répertoire.
Mise à jour le répertoire de téléchargement PhoneGap :
Il est recommandé que vous téléchargez une nouvelle copie de tout le répertoire.
Cependant, Voici les nouvelles pièces nécessaires pour la mise à jour au coup par coup :
Mise à jour le fichier cordova.blackberry.js dans le Phonegap-2.6.0/lib/blackberry/javascript répertoire.
Mise à jour le ext , ext-air , et ext-qnx dans le Phonegap-2.6.0/lib/blackberry/framework répertoire.
Mise à jour le build.xml de fichiers dans le Phonegap-2.6.0/lib/blackberry répertoire.
Mise à jour le Phonegap-2.6.0/lib/blackberry/bin répertoire.
Mise à jour le VERSION de fichiers dans le Phonegap-2.6.0/lib/blackberry répertoire.
Mise à jour de l‘exemple / répertoire ou la migration d’un existant du projet :
Ouvert le www répertoire, qui contient l'application.
Retirer et mettre à jour le fichier .jar dans le ext/ répertoire.
Mise à jour le contenu de la ext-air/ répertoire.
Mise à jour le contenu de la ext-qnx/ répertoire.
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.
Mise à jour le répertoire de téléchargement PhoneGap :
Il est recommandé que vous téléchargez une nouvelle copie de tout le répertoire.
Cependant, Voici les nouvelles pièces nécessaires pour la mise à jour au coup par coup :
Mise à jour le fichier cordova.blackberry.js dans le Phonegap-2.5.0/lib/blackberry/javascript répertoire.
Mise à jour le ext , ext-air , et ext-qnx dans le Phonegap-2.5.0/lib/blackberry/framework répertoire.
Mise à jour le build.xml de fichiers dans le Phonegap-2.5.0/lib/blackberry répertoire.
Mise à jour le Phonegap-2.5.0/lib/blackberry/bin répertoire.
Mise à jour le VERSION de fichiers dans le Phonegap-2.5.0/lib/blackberry répertoire.
Mise à jour de l‘exemple / répertoire ou la migration d’un existant du projet :
Ouvert le www répertoire, qui contient l'application.
Retirer et mettre à jour le fichier .jar dans le ext/ répertoire.
Mise à jour le contenu de la ext-air/ répertoire.
Mise à jour le contenu de la ext-qnx/ répertoire.
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.
Mise à jour juste le www répertoire :
Ouvert le www répertoire, qui contient l'application.
Retirer et mettre à jour le fichier .jar dans le ext/ répertoire.
Mise à jour le contenu de la ext-air/ répertoire.
Copiez le nouveau cordova-2.4.0.js dans votre projet.
playbook/ répertoire.qnx/ répertoire.Mettre à jour votre code HTML pour utiliser le nouveau cordova-2.4.0.js fichier.
Mise à jour le répertoire de l'exemple (c.-à-d., mise à jour grâce aux outils de fourmi) :
Ouvert le sample/lib/ répertoire.
Mise à jour le fichier .jar dans le cordova.2.3.0/ext/ répertoire.
Mise à jour le contenu de la cordova.2.3.0/ext-air/ répertoire.
Mise à jour le contenu de la cordova.2.3.0/ext-qnx/ répertoire.
Mise à jour le fichier .js dans le cordova.2.3.0/javascript/ répertoire.
Ouvert le sample/lib/ répertoire et renommez le cordova.2.3.0/ Répertoire decordova.2.4.0/.
Type ant blackberry build ou ant playbook build pour mettre à jour le www répertoire avec mise à jour Cordova.
Ouvert le www répertoire et mettre à jour votre code HTML pour utiliser le nouveau cordova-2.4.0.js fichier.
Mise à jour juste le www répertoire :
Ouvert le www répertoire, qui contient l'application.
Retirer et mettre à jour le fichier .jar dans le ext/ répertoire.
Mise à jour le contenu de la ext-air/ répertoire.
Copiez le nouveau cordova-2.3.0.js dans votre projet.
playbook/ répertoire.qnx/ répertoire.Mettre à jour votre code HTML pour utiliser le nouveau cordova-2.3.0.js fichier.
Mise à jour le répertoire de l'exemple (c.-à-d., mise à jour grâce aux outils de fourmi) :
Ouvert le sample/lib/ répertoire.
Mise à jour le fichier .jar dans le cordova.2.2.0/ext/ répertoire.
Mise à jour le contenu de la cordova.2.2.0/ext-air/ répertoire.
Mise à jour le contenu de la cordova.2.2.0/ext-qnx/ répertoire.
Mise à jour le fichier .js dans le cordova.2.2.0/javascript/ répertoire.
Ouvert le sample/lib/ répertoire et renommez le cordova.2.2.0/ Répertoire decordova.2.3.0/.
Type ant blackberry build ou ant playbook build pour mettre à jour le www répertoire avec mise à jour Cordova.
Ouvert le www répertoire et mettre à jour votre code HTML pour utiliser le nouveau cordova-2.3.0.js fichier.
Mise à jour de tout le répertoire www :
Ouvert le www répertoire, qui contient l'application.
Retirer et mettre à jour le fichier .jar dans le ext/ répertoire.
Mise à jour le contenu de la ext-air/ répertoire.
Copiez le nouveau cordova-2.2.0.js dans votre projet.
playbook/ répertoire.qnx/ répertoire.Mettre à jour votre code HTML pour utiliser le nouveau cordova-2.2.0.js fichier.
Mise à jour le répertoire de l'exemple (c.-à-d., mise à jour grâce aux outils de fourmi) :
Ouvert le sample/lib/ répertoire.
Mise à jour le fichier .jar dans le cordova.2.1.0/ext/ répertoire.
Mise à jour le contenu de la cordova.2.1.0/ext-air/ répertoire.
Mise à jour le contenu de la cordova.2.1.0/ext-qnx/ répertoire.
Mise à jour le fichier .js dans le cordova.2.1.0/javascript/ répertoire.
Ouvert le sample/lib/ répertoire et renommez le cordova.2.1.0/ Répertoire decordova.2.2.0/.
Type ant blackberry build ou ant playbook build pour mettre à jour le www répertoire avec mise à jour Cordova.
Ouvert le www répertoire et mettre à jour votre code HTML pour utiliser le nouveau cordova-2.2.0.js fichier.
Mise à jour juste le www répertoire :
Ouvert le www répertoire, qui contient l'application.
Retirer et mettre à jour le fichier .jar dans le ext/ répertoire.
Mise à jour le contenu de la ext-air/ répertoire.
Copiez le nouveau cordova-2.1.0.js dans votre projet.
playbook/ répertoire.Mettre à jour votre code HTML pour utiliser le nouveau cordova-2.1.0.js fichier.
Mise à jour le répertoire de l'exemple (c.-à-d., mise à jour grâce aux outils de fourmi) :
Ouvert le sample/lib/ répertoire.
Mise à jour le fichier .jar dans le cordova.2.0.0/ext/ répertoire.
Mise à jour le contenu de la cordova.2.0.0/ext-air/ répertoire.
Mise à jour le fichier .js dans le cordova.2.0.0/javascript/ répertoire.
Ouvert le sample/lib/ répertoire et renommez le cordova.2.0.0/ Répertoire decordova.2.1.0/.
Type ant blackberry build ou ant playbook build pour mettre à jour le www répertoire avec mise à jour Cordova.
Ouvert le www répertoire et mettre à jour votre code HTML pour utiliser le nouveau cordova-2.1.0.js fichier.
Mise à jour juste le www répertoire :
Ouvert le www répertoire, qui contient l'application.
Retirer et mettre à jour le fichier .jar dans le ext/ répertoire.
Mise à jour le contenu de la ext-air/ répertoire.
Copiez le nouveau cordova-2.0.0.js dans votre projet.
playbook/ répertoire.Mettre à jour votre code HTML pour utiliser le nouveau cordova-2.0.0.js fichier.
Mise à jour le www/plugins.xml fichier. Deux plugins changé leur étiquette d'espace de noms/service. Changer les anciennes entrées pour les plugins de Capture et de Contact de :
< nom du plugin = « Capturer » value="org.apache.cordova.media.MediaCapture"/ >< nom du plugin = « Contact » value="org.apache.cordova.pim.Contact"/ >
À:
< nom du plugin = « Capturer » value="org.apache.cordova.capture.MediaCapture"/ >< nom du plugin = « Contacts » value="org.apache.cordova.pim.Contact"/ >
Mise à jour le répertoire de l'exemple (c.-à-d., mise à jour grâce aux outils de fourmi) :
Ouvert le sample/lib/ répertoire.
Mise à jour le fichier .jar dans le cordova.1.9.0/ext/ répertoire.
Mise à jour le contenu de la cordova.1.9.0/ext-air/ répertoire.
Mise à jour le fichier .js dans le cordova.1.9.0/javascript/ répertoire.
Ouvert le sample/lib/ répertoire et renommez le cordova.1.9.0/ Répertoire decordova.2.0.0/.
Type ant blackberry build ou ant playbook build pour mettre à jour le www répertoire avec mise à jour Cordova.
Ouvert le www répertoire et mettre à jour votre code HTML pour utiliser le nouveau cordova-2.0.0.js fichier.
Ouvert le www répertoire et mise à jour le plugins.xml fichier. Deux plugins changé leur étiquette d'espace de noms/service. Changer les anciennes entrées pour les plugins de Capture et de Contact de :
< nom du plugin = « Capturer » value="org.apache.cordova.media.MediaCapture"/ >< nom du plugin = « Contact » value="org.apache.cordova.pim.Contact"/ >
À:
< nom du plugin = « Capturer » value="org.apache.cordova.capture.MediaCapture"/ >< nom du plugin = « Contacts » value="org.apache.cordova.pim.Contact"/ >
Mise à jour juste le www répertoire :
Ouvert le www répertoire, qui contient l'application.
Retirer et mettre à jour le fichier .jar dans le ext/ répertoire.
Mise à jour le contenu de la ext-air/ répertoire.
Copiez le nouveau cordova-1.8.0.js dans votre projet.
playbook/ répertoire.Mettre à jour votre code HTML pour utiliser le nouveau cordova-1.8.0.js fichier.
Mise à jour le www/plugins.xml fichier. Deux plugins changé leur étiquette d'espace de noms/service. Changer les anciennes entrées pour les plugins de Capture et de Contact de :
< nom du plugin = « Capturer » value="org.apache.cordova.media.MediaCapture"/ >< nom du plugin = « Contact » value="org.apache.cordova.pim.Contact"/ >
À:
< nom du plugin = « Capturer » value="org.apache.cordova.capture.MediaCapture"/ >< nom du plugin = « Contacts » value="org.apache.cordova.pim.Contact"/ >
Mise à jour le répertoire de l'exemple (c.-à-d., mise à jour grâce aux outils de fourmi) :
Ouvert le sample/lib/ répertoire.
Mise à jour le fichier .jar dans le cordova.1.7.0/ext/ répertoire.
Mise à jour le contenu de la cordova.1.7.0/ext-air/ répertoire.
Mise à jour le fichier .js dans le cordova.1.7.0/javascript/ répertoire.
Ouvert le sample/lib/ répertoire et renommez le cordova.1.7.0/ Répertoire decordova.1.8.0/.
Type ant blackberry build ou ant playbook build pour mettre à jour le www répertoire avec mise à jour Cordova.
Ouvert le www répertoire et mettre à jour votre code HTML pour utiliser le nouveau cordova-1.8.0.js fichier.
Ouvert le www répertoire et mise à jour le plugins.xml fichier. Deux plugins changé leur étiquette d'espace de noms/service. Changer les anciennes entrées pour les plugins de Capture et de Contact de :
< nom du plugin = « Capturer » value="org.apache.cordova.media.MediaCapture"/ >< nom du plugin = « Contact » value="org.apache.cordova.pim.Contact"/ >
À:
< nom du plugin = « Capturer » value="org.apache.cordova.capture.MediaCapture"/ >< nom du plugin = « Contacts » value="org.apache.cordova.pim.Contact"/ >