Return-Path: X-Original-To: apmail-cordova-commits-archive@www.apache.org Delivered-To: apmail-cordova-commits-archive@www.apache.org Received: from mail.apache.org (hermes.apache.org [140.211.11.3]) by minotaur.apache.org (Postfix) with SMTP id DE9B71815B for ; Tue, 10 Nov 2015 03:46:04 +0000 (UTC) Received: (qmail 22710 invoked by uid 500); 10 Nov 2015 03:46:04 -0000 Delivered-To: apmail-cordova-commits-archive@cordova.apache.org Received: (qmail 22587 invoked by uid 500); 10 Nov 2015 03:46:04 -0000 Mailing-List: contact commits-help@cordova.apache.org; run by ezmlm Precedence: bulk List-Help: List-Unsubscribe: List-Post: List-Id: Delivered-To: mailing list commits@cordova.apache.org Received: (qmail 20751 invoked by uid 99); 10 Nov 2015 03:46:02 -0000 Received: from git1-us-west.apache.org (HELO git1-us-west.apache.org) (140.211.11.23) by apache.org (qpsmtpd/0.29) with ESMTP; Tue, 10 Nov 2015 03:46:02 +0000 Received: by git1-us-west.apache.org (ASF Mail Server at git1-us-west.apache.org, from userid 33) id 96B05E0AFC; Tue, 10 Nov 2015 03:46:02 +0000 (UTC) Content-Type: text/plain; charset="us-ascii" MIME-Version: 1.0 Content-Transfer-Encoding: 8bit From: steven@apache.org To: commits@cordova.apache.org Date: Tue, 10 Nov 2015 03:46:21 -0000 Message-Id: <51473d66e1534e1fa5d786687081d259@git.apache.org> In-Reply-To: <9947fcbdfe2c45d2b16c47354fa843de@git.apache.org> References: <9947fcbdfe2c45d2b16c47354fa843de@git.apache.org> X-Mailer: ASF-Git Admin Mailer Subject: [20/51] [partial] docs commit: added 5.4.0 docs for all languages http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/fd1b79a4/www/docs/fr/5.4.0/guide/platforms/android/index.md ---------------------------------------------------------------------- diff --git a/www/docs/fr/5.4.0/guide/platforms/android/index.md b/www/docs/fr/5.4.0/guide/platforms/android/index.md new file mode 100644 index 0000000..e05414b --- /dev/null +++ b/www/docs/fr/5.4.0/guide/platforms/android/index.md @@ -0,0 +1,275 @@ +--- +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. + +title: Guide pour la plate-forme Android +--- + +# Guide pour la plate-forme Android + +Ce guide montre comment configurer votre environnement SDK pour déployer des applications de Cordova pour les appareils Android et comment éventuellement utiliser Android-centré des outils de ligne de commande dans votre flux de travail de développement. Vous devez installer le SDK Android indépendamment si vous voulez utiliser ces outils axés sur la plate-forme de shell ou la CLI de Cordova multi-plateforme pour le développement. Pour une comparaison entre les voies de deux développement, consultez la vue d'ensemble. Pour plus d'informations sur la CLI, consultez l'Interface de ligne de commande. + +## Configuration requise et support + +Cordova pour Android nécessite le SDK Android qui peut être installé sur le système d'exploitation OS X, Linux ou Windows. Voir du SDK Android [Configuration du système requise][1]. + + [1]: http://developer.android.com/sdk/index.html#Requirements + +Cordova supporte Android 4.0.x (en commençant par le niveau de l'API Android 14) et plus élevé. En règle générale, les versions Android deviennent non étayées par Cordova comme ils plonger au-dessous de 5 % sur Google [dashboard de distribution][2]. Android versions antérieures à la version API de niveau 10 et les versions 3.x (Honeycomb, niveaux API 11-13) tombent nettement au-dessous de ce seuil de 5 %. + + [2]: http://developer.android.com/about/dashboards/index.html + +## Installer les outils de Cordova Shell + +Si vous souhaitez utiliser les outils de coquille Android-centrée de Cordova conjointement avec le SDK, Télécharger Cordova de [cordova.apache.org][3]. Sinon ignorer cette section si vous envisagez d'utiliser l'outil CLI de multi-plateforme décrit dans l'Interface de ligne de commande. + + [3]: http://cordova.apache.org + +Le téléchargement de Cordova contient des archives distincts pour chaque plate-forme. N'oubliez pas d'élargir l'archive appropriée, `android` dans ce cas, dans un répertoire vide. Les utilitaires les pertinents sont disponibles dans le niveau supérieur `bin` répertoire. (Consultez le fichier **README** si nécessaire pour des directions plus détaillées). + +Ces outils de coquille permettent de créer, générer et exécuter des applications Android. Pour plus d'informations sur l'interface de ligne de commande supplémentaire qui active les fonctionnalités de plugin sur toutes les plateformes, voir Plugman à l'aide à gérer les Plugins. Voir Application Plugins pour plus d'informations sur la façon de développer des plugins. + +## Installez le Kit de développement Java (JDK) + +Installer [Java Development Kit (JDK) 7][4] ou version ultérieure. + + [4]: http://www.oracle.com/technetwork/java/javase/downloads/jdk7-downloads-1880260.html + +Lors de l'installation sous Windows, vous devez également définir la Variable d'environnement `JAVA_HOME` selon le chemin d'installation de JDK (par exemple, C:\Program Files\Java\jdk1.7.0_75). + +## Installer le SDK Android + +Installer les [outils de Android SDK autonome][5] ou [Studio Android][6]. Procceed avec `Android Studio` si vous prévoyez Cordova nouvelle pour Android plugins ou utilisant des outils natifs pour exécuter et déboguer la plateforme Android. Dans le cas contraire, `Outils du SDK Android autonome` suffisent pour créer et déployer des applications Android. + + [5]: http://developer.android.com/sdk/installing/index.html?pkg=tools + [6]: http://developer.android.com/sdk/installing/index.html?pkg=studio + +Instructions d'installation détaillées sont disponibles dans le cadre des liens d'installation ci-dessus. + +Pour outils de ligne de commande de Cordova pour travailler, ou la CLI qui repose sur eux, vous devez inclure les répertoires de `plate-forme-outils` et `outils` du SDK dans votre `PATH`. Sur un Mac ou Linux, vous pouvez utiliser un éditeur de texte pour créer ou modifier le fichier `~/.bash_profile` , ajoutant une ligne comme ci-dessous, en fonction d'où installe le SDK : + + export PATH=${PATH}:/Development/android-sdk/platform-tools:/Development/android-sdk/tools + + +Cette ligne dans `~/.bash_profile` expose ces outils dans windows terminales nouvellement ouverts. Si votre fenêtre de terminal est déjà ouvert dans OSX ou d'éviter une déconnexion/connexion sur Linux, exécutez ceci pour les rendre disponibles dans la fenêtre du terminal actuelle : + + $ source ~/.bash_profile + + +Pour modifier l'environnement `PATH` sous Windows : + +1. Cliquez sur le menu **Démarrer** dans le coin en bas à gauche du bureau, faites un clic droit sur **ordinateur**, puis sélectionnez **Propriétés**. + +2. Sélectionnez **Paramètres système avancés** dans la colonne de gauche. + +3. Dans la boîte de dialogue, appuyez sur **Variables d'environnement**. + +4. Sélectionnez la variable **PATH** et appuyer sur **modifier**. + +5. Ajouter ce qui suit à le `PATH` basé sur lequel vous avez installé le SDK, par exemple : + + ;C:\Development\android-sdk\platform-tools;C:\Development\android-sdk\tools + + +6. Enregistrez la valeur et fermez les deux boîtes de dialogue. + +## Installer les paquets SDK + +Ouvrez le gestionnaire de SDK Android (par exemple, par l'intermédiaire de borne : `android`) et installer : + +1. 5.1.1 Android (API 22) platform SDK +2. Version d'Android SDK Build-tools 19.1.0 ou supérieur +3. Référentiel de prise en charge Android (Extras) + +Pour plus de détails, voir [Installation de Packages de SDK][7] . + + [7]: http://developer.android.com/sdk/installing/adding-packages.html + +## Configurer un émulateur + +Android sdk ne fournit pas de n'importe quelle instance d'émulateur par défaut par défaut. Vous pouvez créer un nouveau en exécutant `android` sur la ligne de commande. La presse **Outils → gérer AVDs** (périphériques virtuels Android), puis choisissez n'importe quel élément du **Dispositif de définitions** dans la boîte de dialogue : + +![][8] + + [8]: {{ site.baseurl }}/static/img/guide/platforms/android/asdk_device.png + +Appuyez sur **Créer AVD**, éventuellement modifier le nom, puis appuyez sur **OK** pour accepter les modifications : + +![][9] + + [9]: {{ site.baseurl }}/static/img/guide/platforms/android/asdk_newAVD.png + +L'AVD apparaît alors dans la liste **Des périphériques virtuels Android** : + +![][10] + + [10]: {{ site.baseurl }}/static/img/guide/platforms/android/asdk_avds.png + +Pour ouvrir l'émulateur comme une demande distincte, l'AVD et cliquez sur **Démarrer**. Il lance autant qu'il le ferait sur le dispositif, avec des contrôles supplémentaires disponibles pour les boutons matériels : + +![][11] + + [11]: {{ site.baseurl }}/static/img/guide/platforms/android/asdk_emulator.png + +Pour une expérience plus rapide, vous pouvez utiliser l' `Accélération de la Machine virtuelle` pour améliorer la vitesse d'exécution. De nombreux processeurs modernes fournissent des extensions pour exécuter des Machines virtuelles plus efficacement. Avant d'utiliser ce type d'accélération, vous devez déterminer si CPU de votre système actuel de développement, on supporte les technologies de virtualisation suivants : + +* **Technologie de virtualisation Intel** (VT-x, vmx) → [Intel VT-x pris en charge la liste des processeurs][12] +* **AMD Virtualization** (AMD-V, SVM), pris en charge uniquement pour Linux (depuis mai 2006, tous les processeurs AMD incluent AMD-V, sauf Sempron). + + [12]: http://ark.intel.com/products/virtualizationtechnology + +Une autre façon de savoir si votre processeur supporte la technologie de VT-x, c'est en exécutant l' `Utilitaire Intel Processor Identification Utility`, pour `Windows`, vous pouvez le télécharger depuis le [Centre de téléchargement][13]de Intel, ou vous pouvez utiliser l' [utilitaire booteable][14], qui est `Indépendant de l'OS`. + + [13]: https://downloadcenter.intel.com/Detail_Desc.aspx?ProductID=1881&DwnldID=7838 + [14]: https://downloadcenter.intel.com/Detail_Desc.aspx?ProductID=1881&DwnldID=7840&lang=eng + +Après avoir installer et exécuter `l'Utilitaire d'Identification des processeurs Intel` sur Windows, vous obtiendrez la fenêtre suivante, afin de vérifier si votre processeur supporte les Technologies de virtualisation : + +![][15] + + [15]: {{ site.baseurl }}/static/img/guide/platforms/android/intel_pid_util_620px.png + +Afin d'accélérer l'émulateur, vous devez télécharger et installer une ou plusieurs Images de système `Atom d'Intel x 86` , ainsi que l' `Intel matériel accéléré l'exécution Manager (HAXM)`. + +Ouvrez votre gestionnaire de SDK Android et sélectionnez l'Image du système `Atom d'Intel x 86` , pour quelle que soit la version que vous souhaitez tester. Puis allez à `options` et sélectionnez `Intel x 86 Emulator accélérateur (HAXM)`et installer ces paquets : + +![][16] + + [16]: {{ site.baseurl }}/static/img/guide/platforms/android/asdk_man_intel_image_haxm.png + +Après le téléchargement, exécuter le programme d'installation d'Intel, qui est disponible dans votre Android SDK à `Options/intel/Hardware_Accelerated_Execution_Manager`. **Remarque**:`si vous avez des difficultés pour installer le package, vous pouvez trouver plus d'informations et conseils étape par étape cochez-le` [Article Intel][17]. + + [17]: http://software.intel.com/en-us/android/articles/speeding-up-the-android-emulator-on-intel-architecture + +1. Installez une ou plusieurs Images de système `x 86 d'Intel Atom` ainsi que le `Gestionnaire d'exécution accélérée matériel Intel`, disponible sous **Extras**. + +2. Exécutez le programme d'installation d'Intel, qui est disponible dans votre Android SDK à `Options/intel/Hardware_Accelerated_Execution_Manager`. + +3. Créer un nouvel AVD avec l'objectif fixé à une image d'Intel. + +4. Lorsque vous démarrez l'émulateur, assurez-vous il n'y a aucun message d'erreur indiquant une panne de charger les modules HAX. + +## Créez un nouveau projet + +À ce stade, pour créer un nouveau projet, vous pouvez choisir entre l'outil CLI multiplate-forme décrit dans l'Interface de ligne de commande, ou l'ensemble des outils de coquille spécifiques à Android. Partir dans un répertoire de code source, voici l'approche de la CLI : + + $ cordova create hello com.example.hello HelloWorld + $ cd hello + $ cordova platform add android + $ ccordova prepare # or "cordova build" + + +Voici l'approche de shell-outil de niveau inférieur correspondant pour Unix et Windows : + + $ /path/to/cordova-android/bin/create /path/to/new/hello com.example.hello HelloWorld + C:\path\to\cordova-android\bin\create.bat C:\path\to\new\hello com.example.hello HelloWorld + + +## Générez le projet + +Si vous utilisez l'interface CLI dans le développement, le répertoire de niveau supérieur `www` du répertoire du projet contient les fichiers sources. Courir à chacun d'entre eux dans le répertoire du projet pour reconstruire l'application : + + $ cordova build # build all platforms that were added + $ cordova build android # build debug for only Android + $ cordova build android --debug # build debug for only Android + $ cordova build android --release # build release for only Android + + +Si vous utilisez les outils de coquille spécifiques à Android en développement, il y a une approche différente. Une fois que vous générez le projet, source de l'application par défaut est disponible dans le sous-répertoire `assets/www` . Les commandes suivantes sont disponibles dans son sous-répertoire de `cordova` . + +La commande `build` nettoie les fichiers projet et régénère l'app. Voici la syntaxe pour Mac et Windows. Les deux premiers exemples génèrent des informations de débogage, et le second s'appuie les apps pour diffusion immédiate : + + $ /path/to/project/cordova/build --debug + C:\path\to\project\cordova\build.bat --debug + + $ /path/to/project/cordova/build --release + C:\path\to\project\cordova\build.bat --release + + +## Déployer l'application + +Vous pouvez utiliser l'utilitaire CLI de `cordova` pour déployer l'application sur l'émulateur ou le dispositif de la ligne de commande : + + $ cordova emulate android #to deploy the app on a default android emulator + $ cordova run android --device #to deploy the app on a connected device + + +Sinon, utilisez l'interface de coquille alternative : + + $ /path/to/project/cordova/run --emulator + $ /path/to/project/cordova/run --device + + +Vous pouvez utiliser **cordova run android --list** pour voir toutes les cibles disponibles et **cordova run android --target=target_name** pour exécuter l'application sur un émulateur ou un périphérique spécifique (par exemple, `cordova run android --target="Nexus4_emulator"`). + +Vous pouvez également utiliser **cordova run --help** pour voir construire supplémentaire et exécuter les options. + +Cela pousse l'app à l'écran d'accueil et il lance : + +![][18] + + [18]: {{ site.baseurl }}/static/img/guide/platforms/android/emulator2x.png + +Lorsque vous `run` l'application, vous aussi `build` il. Vous pouvez ajouter supplémentaires `--debug`, `--release`et `--nobuild` drapeaux pour contrôler comment il est construit, ou même si une reconstruction est nécessaire : + + $ /path/to/project/cordova/run --emulator --nobuild + + +## Autres commandes + +Ce qui suit génère un journal détaillé de l'application en cours d'exécution : + + $ /path/to/project/cordova/log + C:\path\to\project\cordova\log.bat + + +Le texte suivant nettoie les fichiers de projet : + + $ /path/to/project/cordova/clean + C:\path\to\project\cordova\clean.bat + + +## Ouvrez un nouveau projet dans le SDK + +Une fois que la plateforme android est ajouté à votre projet, vous pouvez l'ouvrir depuis [Android][6]Studio : + +1. Lancez l'application **Android de Studio** . + +2. Sélectionnez **Import Project (Eclipse ADT, Gradle, etc.)**. + + ![][19] + +3. Sélectionnez l'emplacement où la plateforme android est stockée (`votre/projet/platforms/android`). + + ![][20] + +4. Pour la question `Gradle Sync` vous pouvez simplement répondre **Oui**. + + [19]: {{ site.baseurl }}/static/img/guide/platforms/android/asdk_import_project.png + [20]: {{ site.baseurl }}/static/img/guide/platforms/android/asdk_import_select_location.png + +Vous êtes tous ensemble maintenant et pouvez générer et exécuter l'application directement à partir de `Studio Android`. + +![][21] + + [21]: {{ site.baseurl }}/static/img/guide/platforms/android/asdk_import_done.png + +Consultez [Vue d'ensemble Studio de Android][22] et et [génération et l'exécution de Studio Android][23] pour plus de détails. + + [22]: http://developer.android.com/tools/studio/index.html + [23]: http://developer.android.com/tools/building/building-studio.html http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/fd1b79a4/www/docs/fr/5.4.0/guide/platforms/android/plugin.md ---------------------------------------------------------------------- diff --git a/www/docs/fr/5.4.0/guide/platforms/android/plugin.md b/www/docs/fr/5.4.0/guide/platforms/android/plugin.md new file mode 100644 index 0000000..35ee685 --- /dev/null +++ b/www/docs/fr/5.4.0/guide/platforms/android/plugin.md @@ -0,0 +1,182 @@ +--- +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. + +title: Plugins Android +--- + +# Plugins Android + +Cette section fournit des détails pour savoir comment implémenter le code du plugin native sur la plateforme Android. Avant de lire ceci, voir Application Plugins pour avoir un aperçu de la structure du plugin et son interface commune de JavaScript. Cette section continue de démontrer l'échantillon *écho* plugin qui communique de la webview Cordova à la plate-forme native et le dos. Pour un autre exemple, voir aussi les commentaires à [CordovaPlugin.java][1]. + + [1]: https://github.com/apache/cordova-android/blob/master/framework/src/org/apache/cordova/CordovaPlugin.java + +Plugins Android sont basés sur Android-Cordova, qui consiste en une WebView Android avec crochets attachés à elle. Plugins sont représentés comme des mappages de classe dans le `config.xml` fichier. Un plugin est composé d'au moins une classe Java qui étend la `CordovaPlugin` classe, de la substitution de l'un de ses `execute` méthodes. Aussi pratique, le plugin devrait également réaliser au mieux `[pause](../../../cordova/events/events.pause.html)` et `[resume](../../../cordova/events/events.resume.html)` des événements, ainsi que tout message transitant entre les plugins. Plugins avec longues requêtes, activité de fond telles que la lecture du média, auditeurs ou état interne doit mettre en œuvre la `onReset()` méthode aussi bien. Il exécute quand le `WebView` navigue vers une nouvelle page ou des actualisations, qui recharge le JavaScript. + +## Classe plugin cartographie + +Interface JavaScript du plugin utilise la `cordova.exec` méthode comme suit : + + exec (< successFunction >, < failFunction >, < service >, < action >, [< args >]) ; + + +Cela marshale une demande de la WebView vers le côté natif Android, effectivement l'appel la `action` méthode sur la `service` classe, avec des arguments supplémentaires passés dans le `args` tableau. + +Si vous distribuez un plugin sous Java fichier ou un fichier *jar* de ses propres, le plugin doit être spécifié dans votre application Android-Cordova `res/xml/config.xml` fichier. Voir Application Plugins pour plus d'informations sur la façon d'utiliser le `plugin.xml` fichier à injecter ce `feature` élément : + + + + + + +Le nom de service correspond à celle utilisée dans le code JavaScript `exec` appeler. La valeur est identificateur d'espace de noms complet de la classe Java. Dans le cas contraire, le plugin peut compiler mais toujours être indisponible à Cordova. + +## Durée de vie et initialisation du Plugin + +Une seule instance d'un objet plugin est créée pour la vie de chaque `WebView` . Plugins ne sont pas instanciés jusqu'à ce qu'ils sont tout d'abord référencées par un appel de JavaScript, à moins que `` avec un `onload` `name` attribut a la valeur `"true"` dans `config.xml` . Par exemple : + + + + + + + +Plugins devraient utiliser la `initialize` méthode pour leur logique de démarrage. + + @Override + public void initialize(CordovaInterface cordova, CordovaWebView webView) { + super.initialize(cordova, webView); + // your init code here + } + + +## Écriture d'un Plugin Java Android + +Une demande de plugin pour le côté natif déclenche un appel JavaScript et le plugin Java correspondant est mappé correctement en le `config.xml` fichier, mais en quoi le dernier Android Plugin Java classe ressemble ? Tout ce qui est dépêché sur le plugin avec du JavaScript `exec` fonction est passée dans la classe plugin `execute` méthode. La plupart `execute` implémentations ressemblent à ceci : + + @Override public boolean exécuter (cordes, args JSONArray, CallbackContext callbackContext) lève JSONException {si (« beep".equals(action)) {this.beep(args.getLong(0)) ; + callbackContext.success() ; + retourner la valeur true ; + } return false ; / / Retour des résultats faussement une erreur « MethodNotFound ». + } + + +Le JavaScript `exec` de fonction `action` paramètre correspond à une méthode de classe privée d'expédier avec les paramètres facultatifs. + +Quand interception d'exceptions et de retourner des erreurs, il est important pour plus de clarté que des erreurs retournées aux noms d'exception du Java JavaScript match autant que possibles. + +## Filetage + +Le plugin JavaScript est *pas* exécuté dans le thread principal de le `WebView` interface ; au lieu de cela, il s'exécute le `WebCore` fil, comme le fait la `execute` méthode. Si vous avez besoin d'interagir avec l'interface utilisateur, vous devez utiliser la variation suivante : + + @Override + public boolean execute(String action, JSONArray args, final CallbackContext callbackContext) throws JSONException { + if ("beep".equals(action)) { + final long duration = args.getLong(0); + cordova.getActivity().runOnUiThread(new Runnable() { + public void run() { + ... + callbackContext.success(); // Thread-safe. + } + }); + return true; + } + return false; + } + + +Utiliser ce qui suit si vous n'avez pas besoin d'exécuter sur l'interface principale de thread, mais ne voulez pas bloquer la `WebCore` visser soit : + + @Override + public boolean execute(String action, JSONArray args, final CallbackContext callbackContext) throws JSONException { + if ("beep".equals(action)) { + final long duration = args.getLong(0); + cordova.getThreadPool().execute(new Runnable() { + public void run() { + ... + callbackContext.success(); // Thread-safe. + } + }); + return true; + } + return false; + } + + +## Echo Android Plugin exemple + +Pour trouver *l'écho de l'interface JavaScript décrite dans les Plugins de l'Application* , utilisez le `plugin.xml` pour injecter un `feature` spécification à de la plate-forme locale `config.xml` fichier : + + + + + + + + + + +Puis ajoutez le code suivant à la `src/org/apache/cordova/plugin/Echo.java` fichier : + + package org.apache.cordova.plugin; + + import org.apache.cordova.CordovaPlugin; + import org.apache.cordova.CallbackContext; + + import org.json.JSONArray; + import org.json.JSONException; + import org.json.JSONObject; + + /** + * This class echoes a string called from JavaScript. + */ + public class Echo extends CordovaPlugin { + + @Override + public boolean execute(String action, JSONArray args, CallbackContext callbackContext) throws JSONException { + if (action.equals("echo")) { + String message = args.getString(0); + this.echo(message, callbackContext); + return true; + } + return false; + } + + private void echo(String message, CallbackContext callbackContext) { + if (message != null && message.length() > 0) { + callbackContext.success(message); + } else { + callbackContext.error("Expected one non-empty string argument."); + } + } + } + + +Les importations nécessaires en haut du fichier étend la classe de `CordovaPlugin` , dont `execute()` méthode, elle se substitue pour recevoir les messages de `exec()` . La `execute()` méthode teste tout d'abord la valeur de `action` , qui dans ce cas il est un seul valide `echo` valeur. Tout autre retour d'action `false` et se traduit par une `INVALID_ACTION` erreur, qui se traduit par un rappel de l'erreur invoqué sur le côté de JavaScript. + +Ensuite, la méthode récupère la chaîne echo à l'aide du `args` de l'objet `getString` méthode, en spécifiant le premier paramètre passé à la méthode. Après que la valeur est passée à un privé `echo` méthode, il est paramètre-vérifié pour s'assurer que ce n'est pas `null` ou une chaîne vide, auquel cas `callbackContext.error()` appelle rappel d'erreur de JavaScript. Si les divers contrôles passent, la `callbackContext.success()` passe l'original `message` chaîne à rappel réussi de JavaScript comme paramètre. + +## Intégration Android + +Android propose un `Intent` système qui permet aux processus de communiquer entre eux. Plugins ont accès à un `CordovaInterface` objet, qui peut accéder à l'Android `Activity` qui exécute l'application. C'est la `Context` requise pour lancer un nouveau Android `Intent` . Le `CordovaInterface` permet aux plugins démarrer une `Activity` pour un résultat et configurer le plugin de rappel pour quand le `Intent` retourne à l'application. + +À partir de 2.0 de Cordova, Plugins peuvent accéder n'est plus directement le `Context` et l'héritage `ctx` membre est obsolète. Tous les `ctx` méthodes existent sur le `Context` , afin que les deux `getContext()` et `getActivity()` peut retourner l'objet requis. + +## Débogage des Plugins Android + +Eclipse permet de déboguer des plugins comme source de Java inclus dans le projet. Seulement la dernière version de l'Android Developer Tools vous permet d'attacher le code source à dépendances *JAR* , alors cette fonction n'est pas encore entièrement supportée. \ No newline at end of file http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/fd1b79a4/www/docs/fr/5.4.0/guide/platforms/android/tools.md ---------------------------------------------------------------------- diff --git a/www/docs/fr/5.4.0/guide/platforms/android/tools.md b/www/docs/fr/5.4.0/guide/platforms/android/tools.md new file mode 100644 index 0000000..fe8a469 --- /dev/null +++ b/www/docs/fr/5.4.0/guide/platforms/android/tools.md @@ -0,0 +1,205 @@ +--- +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. + +title: Android Shell Tool Guide +--- + +# Android Shell Tool Guide + +Ce guide montre comment utiliser ensemble de Cordova d'outils axés sur la plate-forme de shell pour développer des applications Android. Cette voie de développement, discutée dans l'aperçu, vous offrent un plus grand choix de développement que l'outil CLI multiplate-forme décrit dans l'Interface de ligne de commande. Par exemple, vous devez utiliser les outils de shell lorsque vous déployez une coutume Cordova WebView aux côtés de composants natifs. Avant d'utiliser ou l'autre voie de développement, vous devez d'abord configurer l'environnement Android SDK comme décrit dans le Guide de la plate-forme Android. + +Pour activer les outils de la coquille pour Android, Télécharger Cordova de [cordova.apache.org][1]. Le téléchargement contient les archives distincts pour chaque plate-forme. Développez chacun vous souhaitez cibler, `android` dans ce cas. Les outils pertinents sont généralement disponibles dans le niveau supérieur `bin` répertoire, sinon, consultez le fichier **README** pour en savoir plus. + + [1]: http://cordova.apache.org + +Ces outils vous permettent de créer, générer et exécuter des applications Android. Pour plus d'informations sur l'interface de ligne de commande supplémentaire qui active les fonctionnalités de plugin sur toutes les plateformes, voir Plugman à l'aide à gérer les Plugins. Voir Application Plugins pour plus d'informations sur la façon de développer des plugins. + +## Créer un projet + +Exécutez le `create` commande, en spécifiant le chemin d'accès existant au projet, l'identificateur de package inverse-domaine-style et nom complet de l'application. Voici la syntaxe pour Mac/Linux et Windows : + + $ /path/to/cordova-android/bin/create /path/to/project com.example.project_name ProjectName + + C:\>\path\to\cordova-android\bin\create.bat \path\to\project com.example.project_name ProjectName + + +## Construire + +Cela nettoie puis génère un projet. + +Debug, sur Mac/Linux ou Windows : + + $ /path/to/project/cordova/build --debug + + C:\>\path\to\project\cordova\build.bat --debug + + +Date de sortie, sous Mac/Linux ou Windows : + + $ /path/to/project/cordova/build --release + + C:\>\path\to\project\cordova\build.bat --release + + +## Exécuter l'application + +Le `run` commande accepte les paramètres *optionnels* suivants : + +* Spécification de la cible. Cela inclut `--emulator` , `--device` , ou`--target=`. + +* Construire la spécification. Cela inclut `--debug` , `--release` , ou`--nobuild`. + + $ /path/to/project/cordova/run [Target] [Build] + + C:\>\path\to\project\cordova\run.bat [Target] [Build] + + +Assurez-vous que vous créez au moins un Android Virtual Device, autrement vous êtes invité à le faire avec la `android` commande. Si plusieurs AVD est disponible en tant que cible, vous êtes invité à sélectionner un. Par défaut la `run` commande détecte un appareil ou un émulateur en cours d'exécution si aucun périphérique n'est trouvé. + +## Signature de l'App + +Vous pouvez consulter Android app signature exigences ici : http://developer.android.com/tools/publishing/app-signing.html + +Pour signer une application, vous devez les paramètres suivants : + +* Keystore (`--keystore`): chemin d'accès à un fichier binaire qui peut contenir un jeu de clés. + +* Keystore password (`--storePassword`): mot de passe pour le fichier de clés + +* Alias (`--alias`): l'id spécifiant la clé privée utilisée pour le chant. + +* Mot de passe (`--password`): mot de passe de clé privée spécifié. + +* Type du keystore (`--keystoreType`): pkcs12, jks (par défaut : détection automatique basée sur l'extension de fichier) + +Ces paramètres peuvent être spécifiés en utilisant les arguments de ligne de commande ci-dessus à `construire` ou `exécuter` des scripts. + +Alternativement, vous pouvez spécifier les dans un fichier (build.json) de configuration de build à l'aide ( `--buildConfig` ) argument. Voici un exemple de fichier de configuration de génération : + + { + "android": { + "debug": { + "keystore": "..\android.keystore", + "storePassword": "android", + "alias": "mykey1", + "password" : "password", + "keystoreType": "" + }, + "release": { + "keystore": "..\android.keystore", + "storePassword": "", + "alias": "mykey2", + "password" : "password", + "keystoreType": "" + } + } + } + + +Pour la version signature, mots de passe ne peuvent être exclus et le système de génération attribuera une invite vous demandant le mot de passe. + +Il y a aussi des soutien à mélanger et assortir les arguments de ligne de commande et les paramètres dans le fichier build.json. Valeurs de l'argument de ligne de comamnd obtiendrez priorité. Cela peut être utile pour spécifier des mots de passe sur la ligne de commande. + +## Exploitation forestière + + $ /path/to/project/cordova/log + + C:\>\path\to\project\cordova\log.bat + + +## Nettoyage + + $ /path/to/project/cordova/clean + + C:\>\path\to\project\cordova\clean.bat + + +## Bâtiment avec Gradle + +À partir de cordova-android@4.0.0, la génération de projet à l'aide de [Gradle][2]. Pour obtenir des instructions sur le bâtiment avec ANT, se référer aux anciennes versions de la documentation. + + [2]: http://www.gradle.org/ + +### Propriétés Gradle + +Ces [Propriétés][3] peuvent être définies pour personnaliser la génération : + + [3]: http://www.gradle.org/docs/current/userguide/tutorial_this_and_that.html + +* **cdvBuildMultipleApks** (par défaut : false) + + Si celui-ci est défini, les fichiers APK multiples seront générés : une par natif plate-forme prise en charge de projets de bibliothèques (x 86, ARM, etc.). Cela peut être important si votre projet utilise des grandes bibliothèques natives, qui peuvent augmenter considérablement la taille de l'APK généré. + + Si ce n'est pas défini, alors un APK unique qui peut être utilisé sur tous les appareils est généré. + +* **cdvVersionCode** + + Substitue le versionCode situé dans `AndroidManifest.xml` + +* **cdvReleaseSigningPropertiesFile** (par défaut : release-signing.properties) + + Chemin vers un fichier .properties qui contient les informations de signature pour diffusion immédiate s'appuie. Le fichier devrait ressembler à : + + storeFile=relative/path/to/keystore.p12 + storePassword=SECRET1 + storeType=pkcs12 + keyAlias=DebugSigningKey + keyPassword=SECRET2 + + + `storePassword` et `keyPassword` sont facultatifs et vont demandera si omise. + +* **cdvDebugSigningPropertiesFile** (par défaut : debug-signing.properties) + + Même cdvReleaseSigningPropertiesFile, mais pour le débogage s'appuie. Utile lorsque vous avez besoin de partager une clé de signature avec d'autres développeurs. + +* **cdvMinSdkVersion** + + Remplace la valeur de `minSdkVersion` dans `AndroidManifest.xml`. Utile lorsque vous créez plusieurs APKs s'inspire de la version SDK. + +* **cdvBuildToolsVersion** + + Substituer la valeur automatiquement détecté `android.buildToolsVersion` . + +* **cdvCompileSdkVersion** + + Substituer la valeur automatiquement détecté `android.compileSdkVersion` . + +### Extension build.gradle + +Si vous devez personnaliser `build.gradle`, plutôt que de modifier directement, vous devez créer un fichier de frère nommé `build-extras.gradle`. Ce fichier sera inclus par le principal `build.gradle` lorsqu'il est présent. Voici un exemple : + + # Example build-extras.gradle + # This file is included at the beginning of `build.gradle` + ext.cdvDebugSigningPropertiesFile = '../../android-debug-keys.properties' + # When set, this function allows code to run at the end of `build.gradle` + ext.postBuildExtras = { + android.buildTypes.debug.applicationIdSuffix = '.debug' + } + + +Remarquez que les plugins peut inclure également `build-extras.gradle` fichiers via : + + + + +### Exemple de Build + + export ORG_GRADLE_PROJECT_cdvMinSdkVersion=14 + cordova build android -- --gradleArg=-PcdvBuildMultipleApks=true \ No newline at end of file http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/fd1b79a4/www/docs/fr/5.4.0/guide/platforms/android/upgrade.md ---------------------------------------------------------------------- diff --git a/www/docs/fr/5.4.0/guide/platforms/android/upgrade.md b/www/docs/fr/5.4.0/guide/platforms/android/upgrade.md new file mode 100644 index 0000000..23a1552 --- /dev/null +++ b/www/docs/fr/5.4.0/guide/platforms/android/upgrade.md @@ -0,0 +1,500 @@ +--- +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. + +title: Mise à jour Android +--- + +# Mise à jour Android + +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. + +## Mise à niveau vers 4.0.0 + +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 : + +1. Mise à jour le `cordova` version CLI. Voir l'Interface de ligne de commande. + +2. Exécutez `cordova platform update android` dans vos projets existants. + +### La mise à niveau de la liste blanche + +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. + +1. Le plugin de `cordova-plugin-whitelist` *(recommandé)* + + * Ce plugin est fortement recommandé, car il est plus sûr et plus configurable que la liste blanche dans les versions précédentes + * Voir [cordova-plugin-whitelist][1] pour plus de détails sur les modifications de configuration requises + * Run : `cordova plugin ajouter cordova-plugin-crosswalk-webview` + +2. Le plugin de `cordova-plugin-legacy-whitelist` + + * Ce greffon fournit le même comportement de la liste blanche que les versions précédentes. Voir [cordova-plugin-legacy-whitelist][2] + * Aucune modification de configuration est requise, mais il fournit une protection moindre que le plugin recommandé + * Run : `cordova plugin ajouter cordova-plugin-legacy-whitelist` + + [1]: https://github.com/apache/cordova-plugin-whitelist + [2]: https://github.com/apache/cordova-plugin-legacy-whitelist + +### En utilisant le tableau de Crosswalk WebView + +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. + +### La mise à niveau vers le Plugin de Splashscreen + +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 + + +## Mise à niveau vers 3.7.1 de 3.6.0 + +Pour les projets non-CLI, exécutez : + + bin/update path/to/project + + +Pour les projets de la CLI : + +1. Mise à jour le `cordova` version CLI. Voir l'Interface de ligne de commande. + +2. Exécutez `cordova platform update android` dans vos projets existants. + +## Mise à niveau vers 3.3.0 de 3.2.0 + +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. + +## Mise à niveau vers 3.2.0 de 3.1.0 + +Pour les projets qui ont été créés avec le cordova CLI : + +1. Mise à jour le `cordova` version CLI. Consultez l'Interface de ligne de commande. + +2. Exécutez `cordova platform update android` + +Pour les projets ne créés pas avec la CLI de cordova, exécutez : + + bin/update + + +**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. + +## Mise à niveau vers 3.1.0 de 3.0.0 + +Pour les projets qui ont été créés avec le cordova CLI : + +1. Mise à jour le `cordova` version CLI. Consultez l'Interface de ligne de commande. + +2. Exécutez `cordova platform update android` + +Pour les projets ne créés pas avec la CLI de cordova, exécutez : + + bin/update + + +## Mise à niveau à la CLI (3.0.0) de 2.9.0 + +1. Créez un projet Apache Cordova 3.0.0 utilisant le cordova CLI, comme décrit dans l'Interface de ligne de commande. + +2. Ajouter vos plates-formes le projet cordova, par exemple : `cordova platform add android`. + +3. 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. + +4. 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. + +5. 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 des plugins, donc ils peuvent avoir besoin d'être ajouté. Seulement 3.0.0 plugins sont compatibles avec l'interface CLI. + +## Mise à niveau vers 3.0.0 de 2.9.0 + +1. Créez un nouveau projet Apache Cordova Android. + +2. Copiez le contenu du répertoire `www` dans le nouveau projet. + +3. Copiez tout actif Android native du répertoire `res` au nouveau projet. + +4. Copier les plug-ins que vous avez installé des `src` de sous-répertoires dans le nouveau projet. + +5. Veillez à mettre à niveau tout déconseillé `< plugin >` références de votre ancien fichier `config.xml` à la nouvelle `` spécification. + +6. 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. + +## Mise à niveau vers 2.9.0 de 2.8.0 + +1. Run `bin/update `. + +## Mise à niveau vers 2.8.0 de 2.7.0 + +1. Retirer `cordova-2.7.0.jar` du répertoire `libs` du projet. + +2. `Cordova-2.8.0.jar` s'ajoute le répertoire du projet `libs`. + +3. Si vous utilisez Eclipse, veuillez actualiser votre projet Eclipse et faire un nettoyage. + + + +1. Copiez le nouveau `cordova.js` dans votre projet. + +2. Mettez à jour votre code HTML permettant d'utiliser le nouveau fichier `cordova.js`. + +3. Copiez le fichier `res/xml/config.xml` pour correspondre à `framework/res/xml/config.xml`. + +4. Mise à jour `framework/res/xml/config.xml` pour avoir des paramètres similaires comme il l'a fait précédemment. + +5. Copier les fichiers `bin/templates/cordova` pour le projet `cordova` répertoire. + +## Mise à niveau vers 2.7.0 de 2.6.0 + +1. Retirer `cordova-2.6.0.jar` du répertoire `libs` du projet. + +2. `Cordova-2.7.0.jar` s'ajoute le répertoire du projet `libs`. + +3. Si vous utilisez Eclipse, veuillez actualiser votre projet Eclipse et faire un nettoyage. + +4. Copiez le nouveau `cordova-2.7.0.js` dans votre projet. + +5. Mettez à jour votre code HTML permettant d'utiliser le nouveau fichier de `cordova-2.7.0.js`. + +6. Copie le `res/xml/config.xml` faire correspondre`framework/res/xml/config.xml`. + +7. Mise à jour `framework/res/xml/config.xml` pour avoir des paramètres similaires comme il l'a fait précédemment. + +8. Copier les fichiers `bin/templates/cordova` pour le projet `cordova` répertoire. + +## Mise à niveau à 2.6.0 de 2.5.0 + +1. Retirer `cordova-2.5.0.jar` du répertoire `libs` du projet. + +2. `Cordova-2.6.0.jar` s'ajoute le répertoire du projet `libs`. + +3. Si vous utilisez Eclipse, veuillez actualiser votre projet Eclipse et faire un nettoyage. + +4. Copiez le nouveau `cordova-2.6.0.js` dans votre projet. + +5. Mettre à jour votre code HTML permettant d'utiliser la nouvelle `cordova-2.6.0.js` fichier. + +6. Copie le `res/xml/config.xml` faire correspondre`framework/res/xml/config.xml`. + +7. Mise à jour `framework/res/xml/config.xml` pour avoir des paramètres similaires comme il l'a fait précédemment. + +8. 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. + +## Mise à niveau vers la version 2.5.0 de 2.4.0 + +1. Retirer `cordova-2.4.0.jar` du répertoire `libs` du projet. + +2. `Cordova-2.5.0.jar` s'ajoute le répertoire du projet `libs`. + +3. Si vous utilisez Eclipse, veuillez actualiser votre projet Eclipse et faire un nettoyage. + +4. Copiez le nouveau `cordova-2.5.0.js` dans votre projet. + +5. Mettre à jour votre code HTML permettant d'utiliser la nouvelle `cordova-2.5.0.js` fichier. + +6. Copie le `res/xml/config.xml` faire correspondre`framework/res/xml/config.xml`. + +7. Mise à jour `framework/res/xml/config.xml` pour avoir des paramètres similaires comme il l'a fait précédemment. + +8. Copier les fichiers `bin/templates/cordova` pour le projet `cordova` répertoire. + +## Mise à niveau vers 2.4.0 de 2.3.0 + +1. Retirer `cordova-2.3.0.jar` du répertoire `libs` du projet. + +2. `Cordova-2.4.0.jar` s'ajoute le répertoire du projet `libs`. + +3. Si vous utilisez Eclipse, veuillez actualiser votre projet Eclipse et faire un nettoyage. + +4. Copiez le nouveau `cordova-2.4.0.js` dans votre projet. + +5. Mettre à jour votre code HTML permettant d'utiliser la nouvelle `cordova-2.4.0.js` fichier. + +6. Copie le `res/xml/config.xml` faire correspondre`framework/res/xml/config.xml`. + +7. Copier les fichiers `bin/templates/cordova` pour le projet `cordova` répertoire. + +## Mise à niveau vers 2.3.0 de 2.2.0 + +1. Retirer `cordova-2.2.0.jar` du répertoire `libs` du projet. + +2. `Cordova-2.3.0.jar` s'ajoute le répertoire du projet `libs`. + +3. Si vous utilisez Eclipse, veuillez actualiser votre projet Eclipse et faire un nettoyage. + +4. Copiez le nouveau `cordova-2.3.0.js` dans votre projet. + +5. Mettre à jour votre code HTML permettant d'utiliser la nouvelle `cordova-2.3.0.js` fichier. + +6. Copie le `res/xml/config.xml` faire correspondre`framework/res/xml/config.xml`. + +7. Copier les fichiers `bin/templates/cordova` pour le projet `cordova` répertoire. + +## Mise à niveau vers 2.2.0 de 2.1.0 + +1. Retirer `cordova-2.1.0.jar` du répertoire `libs` du projet. + +2. `Cordova-2.2.0.jar` s'ajoute le répertoire du projet `libs`. + +3. Si vous utilisez Eclipse, veuillez actualiser votre projet Eclipse et faire un nettoyage. + +4. Copiez le nouveau `cordova-2.2.0.js` dans votre projet. + +5. Mettre à jour votre code HTML permettant d'utiliser la nouvelle `cordova-2.2.0.js` fichier. + +6. Copie le `res/xml/config.xml` faire correspondre`framework/res/xml/config.xml`. + +7. Copier les fichiers `bin/templates/cordova` pour le projet `cordova` répertoire. + +## Mise à niveau vers 2.1.0 de 2.0.0 + +1. Retirer `cordova-2.0.0.jar` du répertoire `libs` du projet. + +2. `Cordova-2.1.0.jar` s'ajoute le répertoire du projet `libs`. + +3. Si vous utilisez Eclipse, veuillez actualiser votre projet Eclipse et faire un nettoyage. + +4. Copiez le nouveau `cordova-2.1.0.js` dans votre projet. + +5. Mettre à jour votre code HTML permettant d'utiliser la nouvelle `cordova-2.1.0.js` fichier. + +6. Copie le `res/xml/config.xml` faire correspondre`framework/res/xml/config.xml`. + +7. Copier les fichiers `bin/templates/cordova` pour le projet `cordova` répertoire. + +## Mise à niveau vers 2.0.0 de 1.9.0 + +1. Retirer `cordova-1.9.0.jar` du répertoire `libs` du projet. + +2. `Cordova-2.0.0.jar` s'ajoute le répertoire du projet `libs`. + +3. Si vous utilisez Eclipse, veuillez actualiser votre projet Eclipse et faire un nettoyage. + +4. Copiez le nouveau `cordova-2.0.0.js` dans votre projet. + +5. Mettre à jour votre code HTML permettant d'utiliser la nouvelle `cordova-2.0.0.js` fichier. + +6. Copie le `res/xml/config.xml` faire correspondre`framework/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. + +## Mise à niveau vers 1.9.0 de 1.8.1 + +1. Retirer `cordova-1.8.0.jar` du répertoire `libs` du projet. + +2. `Cordova-1.9.0.jar` s'ajoute le répertoire du projet `libs`. + +3. Si vous utilisez Eclipse, veuillez actualiser votre projet Eclipse et faire un nettoyage. + +4. Copiez le nouveau `cordova-1.9.0.js` dans votre projet. + +5. Mettez à jour votre code HTML permettant d'utiliser le nouveau fichier de `cordova-1.9.0.js`. + +6. Mise à jour `res/xml/plugins.xml` pour correspondre`framework/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. + +## Mise à niveau vers 1.8.0 de 1.8.0 + +1. Retirer `cordova-1.8.0.jar` du répertoire `libs` du projet. + +2. `Cordova-1.8.1.jar` s'ajoute le répertoire du projet `libs`. + +3. Si vous utilisez Eclipse, veuillez actualiser votre projet Eclipse et faire un nettoyage. + +4. Copiez le nouveau `cordova-1.8.1.js` dans votre projet. + +5. Mettez à jour votre code HTML permettant d'utiliser le nouveau fichier de `cordova-1.8.1.js`. + +6. Mise à jour `res/xml/plugins.xml` pour correspondre`framework/res/xml/plugins.xml`. + +## Mise à niveau vers 1.8.0 de 1.7.0 + +1. Retirer `cordova-1.7.0.jar` du répertoire `libs` du projet. + +2. `Cordova-1.8.0.jar` s'ajoute le répertoire du projet `libs`. + +3. Si vous utilisez Eclipse, veuillez actualiser votre projet Eclipse et faire un nettoyage. + +4. Copiez le nouveau `cordova-1.8.0.js` dans votre projet. + +5. Mettre à jour votre code HTML permettant d'utiliser la nouvelle `cordova-1.8.0.js` fichier. + +6. Mise à jour `res/xml/plugins.xml` pour correspondre`framework/res/xml/plugins.xml`. + +## Mise à niveau vers 1.8.0 de 1.7.0 + +1. Retirer `cordova-1.7.0.jar` du répertoire `libs` du projet. + +2. `Cordova-1.8.0.jar` s'ajoute le répertoire du projet `libs`. + +3. Si vous utilisez Eclipse, veuillez actualiser votre projet Eclipse et faire un nettoyage. + +4. Copiez le nouveau `cordova-1.8.0.js` dans votre projet. + +5. Mettre à jour votre code HTML permettant d'utiliser la nouvelle `cordova-1.8.0.js` fichier. + +6. Mise à jour `res/xml/plugins.xml` pour correspondre `framework/res/xml/plugins.xml`. + +## Mise à niveau vers 1.7.0 de 1.6.1 + +1. Retirer `cordova-1.6.1.jar` du répertoire `libs` du projet. + +2. `Cordova-1.7.0.jar` s'ajoute le répertoire du projet `libs`. + +3. Si vous utilisez Eclipse, veuillez actualiser votre projet Eclipse et faire un nettoyage. + +4. Copiez le nouveau `cordova-1.7.0.js` dans votre projet. + +5. Mise à jour `res/xml/plugins.xml` pour correspondre`framework/res/xml/plugins.xml`. + +## Mise à niveau vers 1.6.1 de 1.6.0 + +1. Retirer `cordova-1.6.0.jar` du répertoire `libs` du projet. + +2. `Cordova-1.6.1.jar` s'ajoute le répertoire du projet `libs`. + +3. Si vous utilisez Eclipse, veuillez actualiser votre projet Eclipse et faire un nettoyage. + +4. Copiez le nouveau `cordova-1.6.1.js` dans votre projet. + +5. Mise à jour `res/xml/plugins.xml` pour correspondre`framework/res/xml/plugins.xml`. + +## Mise à niveau vers 1.6.0 de 1.5.0 + +1. Retirer `cordova-1.5.0.jar` du répertoire `libs` du projet. + +2. `Cordova-1.6.0.jar` s'ajoute le répertoire du projet `libs`. + +3. Si vous utilisez Eclipse, veuillez actualiser votre projet Eclipse et faire un nettoyage. + +4. Copiez le nouveau `cordova-1.6.0.js` dans votre projet. + +5. Mettez à jour votre code HTML permettant d'utiliser le nouveau fichier de `cordova-1.6.0.js`. + +6. Mise à jour `res/xml/plugins.xml` pour correspondre`framework/res/xml/plugins.xml`. + +7. Remplacez `res/xml/phonegap.xml` par `res/xml/cordova.xml` pour correspondre à `framework/res/xml/cordova.xml`. + +## Mise à niveau vers 1.5.0 de 1.4.0 + +1. Retirer `phonegap-1.4.0.jar` du répertoire `libs` du projet. + +2. `Cordova-1.5.0.jar` s'ajoute le répertoire du projet `libs`. + +3. Si vous utilisez Eclipse, veuillez actualiser votre projet Eclipse et faire un nettoyage. + +4. Copiez le nouveau `cordova-1.5.0.js` dans votre projet. + +5. Mettez à jour votre code HTML permettant d'utiliser le nouveau fichier de `cordova-1.5.0.js`. + +6. Mise à jour `res/xml/plugins.xml` pour correspondre`framework/res/xml/plugins.xml`. + +7. Remplacez `res/xml/phonegap.xml` par `res/xml/cordova.xml` pour correspondre à `framework/res/xml/cordova.xml`. + +## Mise à niveau vers 1.4.0 de 1.3.0 + +1. Retirer `phonegap-1.3.0.jar` du répertoire `libs` du projet. + +2. Ajouter `phonegap-1.4.0.jar` pour le répertoire du projet `libs`. + +3. Si vous utilisez Eclipse, veuillez actualiser votre projet Eclipse et faire un nettoyage. + +4. Copiez le nouveau `phonegap-1.4.0.js` dans votre projet. + +5. Mettez à jour votre code HTML permettant d'utiliser le nouveau fichier `phonegap-1.4.0.js`. + +6. Mise à jour `res/xml/plugins.xml` pour correspondre`framework/res/xml/plugins.xml`. + +7. Mise à jour `res/xml/phonegap.xml` pour correspondre`framework/res/xml/phonegap.xml`. + +## Mise à niveau vers 1.3.0 de 1.2.0 + +1. Retirer `phonegap-1.2.0.jar` du répertoire `libs` du projet. + +2. Ajouter `phonegap-1.3.0.jar` pour le répertoire du projet `libs`. + +3. Si vous utilisez Eclipse, veuillez actualiser votre projet Eclipse et faire un nettoyage. + +4. Copiez le nouveau `phonegap-1.3.0.js` dans votre projet. + +5. Mettez à jour votre code HTML permettant d'utiliser le nouveau fichier `phonegap-1.2.0.js`. + +6. Mise à jour `res/xml/plugins.xml` pour correspondre`framework/res/xml/plugins.xml`. + +7. Mise à jour `res/xml/phonegap.xml` pour correspondre`framework/res/xml/phonegap.xml`. + +## Mise à niveau vers 1.2.0 de 1.1.0 + +1. Retirer `phonegap-1.1.0.jar` du répertoire `libs` du projet. + +2. Ajouter `phonegap-1.2.0.jar` pour le répertoire du projet `libs`. + +3. Si vous utilisez Eclipse, veuillez actualiser votre projet Eclipse et faire un nettoyage. + +4. Copiez le nouveau `phonegap-1.2.0.js` dans votre projet. + +5. Mettez à jour votre code HTML permettant d'utiliser le nouveau fichier `phonegap-1.2.0.js`. + +6. Mise à jour `res/xml/plugins.xml` pour correspondre`framework/res/xml/plugins.xml`. + +7. Mise à jour `res/xml/phonegap.xml` pour correspondre`framework/res/xml/phonegap.xml`. + +## Mise à niveau vers 1.1.0 de 1.0.0 + +1. Retirer `phonegap-1.0.0.jar` du répertoire `libs` du projet. + +2. Ajouter `phonegap-1.1.0.jar` pour le répertoire du projet `libs`. + +3. Si vous utilisez Eclipse, veuillez actualiser votre projet Eclipse et faire un nettoyage. + +4. Copiez le nouveau `phonegap-1.1.0.js` dans votre projet. + +5. Mettez à jour votre code HTML permettant d'utiliser le nouveau fichier `phonegap-1.1.0.js`. + +6. Mise à jour `res/xml/plugins.xml` pour correspondre`framework/res/xml/plugins.xml`. + +## Mise à niveau vers 1.0.0 de 0.9.6 + +1. Retirer `phonegap-0.9.6.jar` du répertoire `libs` du projet. + +2. Ajouter `phonegap-1.0.0.jar` pour le répertoire du projet `libs`. + +3. Si vous utilisez Eclipse, veuillez actualiser votre projet Eclipse et faire un nettoyage. + +4. Copiez le nouveau `phonegap-1.0.0.js` dans votre projet. + +5. Mettez à jour votre code HTML permettant d'utiliser le nouveau fichier `phonegap-1.0.0.js`. + +6. Ajouter le `res/xml/plugins.xml` pour correspondre à `framework/res/xml/plugins.xml`. \ No newline at end of file http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/fd1b79a4/www/docs/fr/5.4.0/guide/platforms/android/upgrading.md ---------------------------------------------------------------------- diff --git a/www/docs/fr/5.4.0/guide/platforms/android/upgrading.md b/www/docs/fr/5.4.0/guide/platforms/android/upgrading.md new file mode 100644 index 0000000..1297b98 --- /dev/null +++ b/www/docs/fr/5.4.0/guide/platforms/android/upgrading.md @@ -0,0 +1,438 @@ +--- +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. + +title: Mise à jour Android +--- + +# Mise à jour Android + +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. + +## Mise à niveau vers 3.3.0 de 3.2.0 + +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. Ceci ne devrait avoir aucun effet pour l'utilisation de ligne de commande, mais IDE utilisateurs auront besoin d'importer le nouvellement ajouté `MyProject-CordovaLib` projet dans leur espace de travail. + +## Mise à niveau vers 3.2.0 de 3.1.0 + +Pour les projets qui ont été créés avec le cordova CLI : + +1. Mise à jour le `cordova` version CLI. Voir l'Interface de ligne de commande. + +2. Exécutez`cordova platform update android` + +Pour les projets ne créés pas avec la CLI de cordova, exécutez : + + bin/update + + +**Avertissement :** Commençant sur Android 4.4, création d'un élément du fichier d'entrée 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. Ce bug existe toujours à partir de Android 4.4.2 + +## Mise à niveau vers 3.1.0 de 3.0.0 + +Pour les projets qui ont été créés avec le cordova CLI : + +1. Mise à jour le `cordova` version CLI. Voir l'Interface de ligne de commande. + +2. Exécutez`cordova platform update android` + +Pour les projets ne créés pas avec la CLI de cordova, exécutez : + + bin/update + + +## Mise à niveau à la CLI (3.0.0) de 2.9.0 + +1. Créez un projet Apache Cordova 3.0.0 utilisant le cordova CLI, tel que décrit dans l'Interface de ligne de commande. + +2. Ajoutez vos plates-formes le projet cordova, par exemple :`cordova +platform add android`. + +3. Copiez le contenu de votre projet `www` Répertoire de la `www` répertoire à la racine du projet Cordoue vous venez de créer. + +4. 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. + +5. 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. + +## Mise à niveau vers 3.0.0 de 2.9.0 + +1. Créez un nouveau projet Apache Cordova Android. + +2. Copiez le contenu de votre `www` répertoire vers le nouveau projet. + +3. Copier n'importe quel actif Android natif de votre `res` répertoire vers le nouveau projet. + +4. Copie sur les plug-ins que vous avez installé de la `src` sous-répertoires dans le nouveau projet. + +5. Assurez-vous de mettre à niveau tout obsolète `` les références de votre ancien `config.xml` fichier pour le nouveau `` spécification. + +6. Mise à jour toutes les références à la `org.apache.cordova.api` paquet d'ê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. + +## Mise à niveau vers 2.9.0 de 2.8.0 + +1. Exécutez`bin/update `. + +## Mise à niveau vers 2.8.0 de 2.7.0 + +1. Supprimer `cordova-2.7.0.jar` partir du projet `libs` répertoire. + +2. Ajouter `cordova-2.8.0.jar` au projet `libs` répertoire. + +3. Si vous utilisez Eclipse, veuillez actualiser votre projet Eclipse et faire un nettoyage. + + + +1. Copiez le nouveau `cordova.js` dans votre projet. + +2. Mettre à jour votre code HTML pour utiliser le nouveau `cordova.js` fichier. + +3. Copie le `res/xml/config.xml` fichier corresponde à`framework/res/xml/config.xml`. + +4. Mise à jour `framework/res/xml/config.xml` pour avoir des paramètres similaires comme il l'a fait précédemment. + +5. Copier les fichiers `bin/templates/cordova` pour le projet `cordova` répertoire. + +## Mise à niveau vers 2.7.0 de 2.6.0 + +1. Supprimer `cordova-2.6.0.jar` partir du projet `libs` répertoire. + +2. Ajouter `cordova-2.7.0.jar` au projet `libs` répertoire. + +3. Si vous utilisez Eclipse, veuillez actualiser votre projet Eclipse et faire un nettoyage. + +4. Copiez le nouveau `cordova-2.7.0.js` dans votre projet. + +5. Mettre à jour votre code HTML pour utiliser le nouveau `cordova-2.7.0.js` fichier. + +6. Copie le `res/xml/config.xml` faire correspondre`framework/res/xml/config.xml`. + +7. Mise à jour `framework/res/xml/config.xml` pour avoir des paramètres similaires comme il l'a fait précédemment. + +8. Copier les fichiers `bin/templates/cordova` pour le projet `cordova` répertoire. + +## Mise à niveau à 2.6.0 de 2.5.0 + +1. Supprimer `cordova-2.5.0.jar` partir du projet `libs` répertoire. + +2. Ajouter `cordova-2.6.0.jar` au projet `libs` répertoire. + +3. Si vous utilisez Eclipse, veuillez actualiser votre projet Eclipse et faire un nettoyage. + +4. Copiez le nouveau `cordova-2.6.0.js` dans votre projet. + +5. Mettre à jour votre code HTML pour utiliser le nouveau `cordova-2.6.0.js` fichier. + +6. Copie le `res/xml/config.xml` faire correspondre`framework/res/xml/config.xml`. + +7. Mise à jour `framework/res/xml/config.xml` pour avoir des paramètres similaires comme il l'a fait précédemment. + +8. Copier les fichiers `bin/templates/cordova` pour le projet `cordova` répertoire. + +Exécuter `bin/update ` avec le chemin d'accès du projet figurant dans le répertoire Source de Cordova. + +## Mise à niveau vers la version 2.5.0 de 2.4.0 + +1. Supprimer `cordova-2.4.0.jar` partir du projet `libs` répertoire. + +2. Ajouter `cordova-2.5.0.jar` au projet `libs` répertoire. + +3. Si vous utilisez Eclipse, veuillez actualiser votre projet Eclipse et faire un nettoyage. + +4. Copiez le nouveau `cordova-2.5.0.js` dans votre projet. + +5. Mettre à jour votre code HTML pour utiliser le nouveau `cordova-2.5.0.js` fichier. + +6. Copie le `res/xml/config.xml` faire correspondre`framework/res/xml/config.xml`. + +7. Mise à jour `framework/res/xml/config.xml` pour avoir des paramètres similaires comme il l'a fait précédemment. + +8. Copier les fichiers `bin/templates/cordova` pour le projet `cordova` répertoire. + +## Mise à niveau vers 2.4.0 de 2.3.0 + +1. Supprimer `cordova-2.3.0.jar` partir du projet `libs` répertoire. + +2. Ajouter `cordova-2.4.0.jar` au projet `libs` répertoire. + +3. Si vous utilisez Eclipse, veuillez actualiser votre projet Eclipse et faire un nettoyage. + +4. Copiez le nouveau `cordova-2.4.0.js` dans votre projet. + +5. Mettre à jour votre code HTML pour utiliser le nouveau `cordova-2.4.0.js` fichier. + +6. Copie le `res/xml/config.xml` faire correspondre`framework/res/xml/config.xml`. + +7. Copier les fichiers `bin/templates/cordova` pour le projet `cordova` répertoire. + +## Mise à niveau vers 2.3.0 de 2.2.0 + +1. Supprimer `cordova-2.2.0.jar` partir du projet `libs` répertoire. + +2. Ajouter `cordova-2.3.0.jar` au projet `libs` répertoire. + +3. Si vous utilisez Eclipse, veuillez actualiser votre projet Eclipse et faire un nettoyage. + +4. Copiez le nouveau `cordova-2.3.0.js` dans votre projet. + +5. Mettre à jour votre code HTML pour utiliser le nouveau `cordova-2.3.0.js` fichier. + +6. Copie le `res/xml/config.xml` faire correspondre`framework/res/xml/config.xml`. + +7. Copier les fichiers `bin/templates/cordova` pour le projet `cordova` répertoire. + +## Mise à niveau vers 2.2.0 de 2.1.0 + +1. Supprimer `cordova-2.1.0.jar` partir du projet `libs` répertoire. + +2. Ajouter `cordova-2.2.0.jar` au projet `libs` répertoire. + +3. Si vous utilisez Eclipse, veuillez actualiser votre projet Eclipse et faire un nettoyage. + +4. Copiez le nouveau `cordova-2.2.0.js` dans votre projet. + +5. Mettre à jour votre code HTML pour utiliser le nouveau `cordova-2.2.0.js` fichier. + +6. Copie le `res/xml/config.xml` faire correspondre`framework/res/xml/config.xml`. + +7. Copier les fichiers `bin/templates/cordova` pour le projet `cordova` répertoire. + +## Mise à niveau vers 2.1.0 de 2.0.0 + +1. Supprimer `cordova-2.0.0.jar` partir du projet `libs` répertoire. + +2. Ajouter `cordova-2.1.0.jar` au projet `libs` répertoire. + +3. Si vous utilisez Eclipse, veuillez actualiser votre projet Eclipse et faire un nettoyage. + +4. Copiez le nouveau `cordova-2.1.0.js` dans votre projet. + +5. Mettre à jour votre code HTML pour utiliser le nouveau `cordova-2.1.0.js` fichier. + +6. Copie le `res/xml/config.xml` faire correspondre`framework/res/xml/config.xml`. + +7. Copier les fichiers `bin/templates/cordova` pour le projet `cordova` répertoire. + +## Mise à niveau vers 2.0.0 de 1.9.0 + +1. Supprimer `cordova-1.9.0.jar` partir du projet `libs` répertoire. + +2. Ajouter `cordova-2.0.0.jar` au projet `libs` répertoire. + +3. Si vous utilisez Eclipse, veuillez actualiser votre projet Eclipse et faire un nettoyage. + +4. Copiez le nouveau `cordova-2.0.0.js` dans votre projet. + +5. Mettre à jour votre code HTML pour utiliser le nouveau `cordova-2.0.0.js` fichier. + +6. Copie le `res/xml/config.xml` faire correspondre`framework/res/xml/config.xml`. + +Dans la 2.0.0 version, le `config.xml` fichier 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. + +## Mise à niveau vers 1.9.0 de 1.8.1 + +1. Supprimer `cordova-1.8.0.jar` partir du projet `libs` répertoire. + +2. Ajouter `cordova-1.9.0.jar` au projet `libs` répertoire. + +3. Si vous utilisez Eclipse, veuillez actualiser votre projet Eclipse et faire un nettoyage. + +4. Copiez le nouveau `cordova-1.9.0.js` dans votre projet. + +5. Mettre à jour votre code HTML pour utiliser le nouveau `cordova-1.9.0.js` fichier. + +6. Mise à jour `res/xml/plugins.xml` pour correspondre`framework/res/xml/plugins.xml`. + +En raison de l'introduction de la `CordovaWebView` dans le 1.9.0 libération, plugins tiers peuvent ne pas fonctionner. Ces plugins ont besoin d'obtenir un contexte de le `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. + +## Mise à niveau vers 1.8.0 de 1.8.0 + +1. Supprimer `cordova-1.8.0.jar` partir du projet `libs` répertoire. + +2. Ajouter `cordova-1.8.1.jar` au projet `libs` répertoire. + +3. Si vous utilisez Eclipse, veuillez actualiser votre projet Eclipse et faire un nettoyage. + +4. Copiez le nouveau `cordova-1.8.1.js` dans votre projet. + +5. Mettre à jour votre code HTML pour utiliser le nouveau `cordova-1.8.1.js` fichier. + +6. Mise à jour `res/xml/plugins.xml` pour correspondre`framework/res/xml/plugins.xml`. + +## Mise à niveau vers 1.8.0 de 1.7.0 + +1. Supprimer `cordova-1.7.0.jar` partir du projet `libs` répertoire. + +2. Ajouter `cordova-1.8.0.jar` au projet `libs` répertoire. + +3. Si vous utilisez Eclipse, veuillez actualiser votre projet Eclipse et faire un nettoyage. + +4. Copiez le nouveau `cordova-1.8.0.js` dans votre projet. + +5. Mettre à jour votre code HTML pour utiliser le nouveau `cordova-1.8.0.js` fichier. + +6. Mise à jour `res/xml/plugins.xml` pour correspondre`framework/res/xml/plugins.xml`. + +## Mise à niveau vers 1.8.0 de 1.7.0 + +1. Supprimer `cordova-1.7.0.jar` partir du projet `libs` répertoire. + +2. Ajouter `cordova-1.8.0.jar` au projet `libs` répertoire. + +3. Si vous utilisez Eclipse, veuillez actualiser votre projet Eclipse et faire un nettoyage. + +4. Copiez le nouveau `cordova-1.8.0.js` dans votre projet. + +5. Mettre à jour votre code HTML pour utiliser le nouveau `cordova-1.8.0.js` fichier. + +6. Mise à jour `res/xml/plugins.xml` pour correspondre`framework/res/xml/plugins.xml`. + +## Mise à niveau vers 1.7.0 de 1.6.1 + +1. Supprimer `cordova-1.6.1.jar` partir du projet `libs` répertoire. + +2. Ajouter `cordova-1.7.0.jar` au projet `libs` répertoire. + +3. Si vous utilisez Eclipse, veuillez actualiser votre projet Eclipse et faire un nettoyage. + +4. Copiez le nouveau `cordova-1.7.0.js` dans votre projet. + +5. Mise à jour `res/xml/plugins.xml` pour correspondre`framework/res/xml/plugins.xml`. + +## Mise à niveau vers 1.6.1 de 1.6.0 + +1. Supprimer `cordova-1.6.0.jar` partir du projet `libs` répertoire. + +2. Ajouter `cordova-1.6.1.jar` au projet `libs` répertoire. + +3. Si vous utilisez Eclipse, veuillez actualiser votre projet Eclipse et faire un nettoyage. + +4. Copiez le nouveau `cordova-1.6.1.js` dans votre projet. + +5. Mise à jour `res/xml/plugins.xml` pour correspondre`framework/res/xml/plugins.xml`. + +## Mise à niveau vers 1.6.0 de 1.5.0 + +1. Supprimer `cordova-1.5.0.jar` partir du projet `libs` répertoire. + +2. Ajouter `cordova-1.6.0.jar` au projet `libs` répertoire. + +3. Si vous utilisez Eclipse, veuillez actualiser votre projet Eclipse et faire un nettoyage. + +4. Copiez le nouveau `cordova-1.6.0.js` dans votre projet. + +5. Mettre à jour votre code HTML pour utiliser le nouveau `cordova-1.6.0.js` fichier. + +6. Mise à jour `res/xml/plugins.xml` pour correspondre`framework/res/xml/plugins.xml`. + +7. Remplacer `res/xml/phonegap.xml` avec `res/xml/cordova.xml` pour correspondre`framework/res/xml/cordova.xml`. + +## Mise à niveau vers 1.5.0 de 1.4.0 + +1. Supprimer `phonegap-1.4.0.jar` partir du projet `libs` répertoire. + +2. Ajouter `cordova-1.5.0.jar` au projet `libs` répertoire. + +3. Si vous utilisez Eclipse, veuillez actualiser votre projet Eclipse et faire un nettoyage. + +4. Copiez le nouveau `cordova-1.5.0.js` dans votre projet. + +5. Mettre à jour votre code HTML pour utiliser le nouveau `cordova-1.5.0.js` fichier. + +6. Mise à jour `res/xml/plugins.xml` pour correspondre`framework/res/xml/plugins.xml`. + +7. Remplacer `res/xml/phonegap.xml` avec `res/xml/cordova.xml` pour correspondre`framework/res/xml/cordova.xml`. + +## Mise à niveau vers 1.4.0 de 1.3.0 + +1. Supprimer `phonegap-1.3.0.jar` partir du projet `libs` répertoire. + +2. Ajouter `phonegap-1.4.0.jar` au projet `libs` répertoire. + +3. Si vous utilisez Eclipse, veuillez actualiser votre projet Eclipse et faire un nettoyage. + +4. Copiez le nouveau `phonegap-1.4.0.js` dans votre projet. + +5. Mettre à jour votre code HTML pour utiliser le nouveau `phonegap-1.4.0.js` fichier. + +6. Mise à jour `res/xml/plugins.xml` pour correspondre`framework/res/xml/plugins.xml`. + +7. Mise à jour `res/xml/phonegap.xml` pour correspondre`framework/res/xml/phonegap.xml`. + +## Mise à niveau vers 1.3.0 de 1.2.0 + +1. Supprimer `phonegap-1.2.0.jar` partir du projet `libs` répertoire. + +2. Ajouter `phonegap-1.3.0.jar` au projet `libs` répertoire. + +3. Si vous utilisez Eclipse, veuillez actualiser votre projet Eclipse et faire un nettoyage. + +4. Copiez le nouveau `phonegap-1.3.0.js` dans votre projet. + +5. Mettre à jour votre code HTML pour utiliser le nouveau `phonegap-1.2.0.js` fichier. + +6. Mise à jour `res/xml/plugins.xml` pour correspondre`framework/res/xml/plugins.xml`. + +7. Mise à jour `res/xml/phonegap.xml` pour correspondre`framework/res/xml/phonegap.xml`. + +## Mise à niveau vers 1.2.0 de 1.1.0 + +1. Supprimer `phonegap-1.1.0.jar` partir du projet `libs` répertoire. + +2. Ajouter `phonegap-1.2.0.jar` au projet `libs` répertoire. + +3. Si vous utilisez Eclipse, veuillez actualiser votre projet Eclipse et faire un nettoyage. + +4. Copiez le nouveau `phonegap-1.2.0.js` dans votre projet. + +5. Mettre à jour votre code HTML pour utiliser le nouveau `phonegap-1.2.0.js` fichier. + +6. Mise à jour `res/xml/plugins.xml` pour correspondre`framework/res/xml/plugins.xml`. + +7. Mise à jour `res/xml/phonegap.xml` pour correspondre`framework/res/xml/phonegap.xml`. + +## Mise à niveau vers 1.1.0 de 1.0.0 + +1. Supprimer `phonegap-1.0.0.jar` partir du projet `libs` répertoire. + +2. Ajouter `phonegap-1.1.0.jar` au projet `libs` répertoire. + +3. Si vous utilisez Eclipse, veuillez actualiser votre projet Eclipse et faire un nettoyage. + +4. Copiez le nouveau `phonegap-1.1.0.js` dans votre projet. + +5. Mettre à jour votre code HTML pour utiliser le nouveau `phonegap-1.1.0.js` fichier. + +6. Mise à jour `res/xml/plugins.xml` pour correspondre`framework/res/xml/plugins.xml`. + +## Mise à niveau vers 1.0.0 de 0.9.6 + +1. Supprimer `phonegap-0.9.6.jar` partir du projet `libs` répertoire. + +2. Ajouter `phonegap-1.0.0.jar` au projet `libs` répertoire. + +3. Si vous utilisez Eclipse, veuillez actualiser votre projet Eclipse et faire un nettoyage. + +4. Copiez le nouveau `phonegap-1.0.0.js` dans votre projet. + +5. Mettre à jour votre code HTML pour utiliser le nouveau `phonegap-1.0.0.js` fichier. + +6. Ajouter le `res/xml/plugins.xml` faire correspondre`framework/res/xml/plugins.xml`. \ No newline at end of file http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/fd1b79a4/www/docs/fr/5.4.0/guide/platforms/android/webview.md ---------------------------------------------------------------------- diff --git a/www/docs/fr/5.4.0/guide/platforms/android/webview.md b/www/docs/fr/5.4.0/guide/platforms/android/webview.md new file mode 100644 index 0000000..2ab4108 --- /dev/null +++ b/www/docs/fr/5.4.0/guide/platforms/android/webview.md @@ -0,0 +1,116 @@ +--- +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. + +title: Android WebViews +--- + +# Android WebViews + +Ce guide montre comment intégrer un composant WebView Cordova-activée dans une application Android plus grande. Pour plus d'informations sur la façon dont ces composants peuvent communiquer entre eux, voir Application Plugins. + +Si vous n'êtes pas familier avec Android, vous devez tout d'abord vous familiariser avec le Guide de la plate-forme Android et avoir le dernier SDK Android installé avant d'essayer l'option de développement plus inhabituelle d'incorporation une WebView. À partir de 1,9 Cordova, la plateforme Android s'appuie sur un `CordovaWebView` composant, qui s'appuie sur un héritage `CordovaActivity` composant qui est antérieure à la version 1.9. + +1. Pour suivre ces instructions, vérifiez que vous avez la dernière distribution de Cordova. Téléchargez-le sur [cordova.apache.org][1] et décompressez son Android. + +2. Accédez à du package Android `/framework` répertoire et exécutez `ant jar` . Il crée le Cordova `.jar` fichier, formé comme`/framework/cordova-x.x.x.jar`. + +3. Copie le `.jar` fichier dans le projet Android `/libs` répertoire. + +4. Ajoutez le code suivant à l'application `/res/xml/main.xml` fichier, avec la `layout_height` , `layout_width` et `id` modifié en fonction de l'application : + + + + +5. Modifier l'activité de sorte qu'il met en œuvre le `CordovaInterface` . Il doit implémenter les méthodes inclus. Vous pouvez les copier de `/framework/src/org/apache/cordova/CordovaActivity.java` , ou bien leur mise en œuvre sur votre propre. Le fragment de code suivant montre une application de base qui s'appuie sur l'interface. Notez comment correspond à l'id de la vue référencée le `id` attribut spécifié dans le fragment XML indiqué ci-dessus : + + public class CordovaViewTestActivity extends Activity implements CordovaInterface { + CordovaWebView cwv; + /* Called when the activity is first created. */ + @Override + public void onCreate(Bundle savedInstanceState) { + super.onCreate(savedInstanceState); + setContentView(R.layout.main); + cwv = (CordovaWebView) findViewById(R.id.tutorialView); + Config.init(this); + cwv.loadUrl(Config.getStartUrl()); + } + + +6. Si l'application doit utiliser l'appareil photo, mettre en œuvre ce qui suit : + + @Override + public void setActivityResultCallback(CordovaPlugin plugin) { + this.activityResultCallback = plugin; + } + /** + * Launch an activity for which you would like a result when it finished. When this activity exits, + * your onActivityResult() method is called. + * + * @param command The command object + * @param intent The intent to start + * @param requestCode The request code that is passed to callback to identify the activity + */ + public void startActivityForResult(CordovaPlugin command, Intent intent, int requestCode) { + this.activityResultCallback = command; + this.activityResultKeepRunning = this.keepRunning; + + // If multitasking turned on, then disable it for activities that return results + if (command != null) { + this.keepRunning = false; + } + + // Start activity + super.startActivityForResult(intent, requestCode); + } + + @Override + /** + * Called when an activity you launched exits, giving you the requestCode you started it with, + * the resultCode it returned, and any additional data from it. + * + * @param requestCode The request code originally supplied to startActivityForResult(), + * allowing you to identify who this result came from. + * @param resultCode The integer result code returned by the child activity through its setResult(). + * @param data An Intent, which can return result data to the caller (various data can be attached to Intent "extras"). + */ + protected void onActivityResult(int requestCode, int resultCode, Intent intent) { + super.onActivityResult(requestCode, resultCode, intent); + CordovaPlugin callback = this.activityResultCallback; + if (callback != null) { + callback.onActivityResult(requestCode, resultCode, intent); + } + } + + +7. Enfin, n'oubliez pas d'ajouter le pool de threads, l'auraient aucun thread sur lequel exécuter des plugins : + + @Override + public ExecutorService getThreadPool() { + return threadPool; + } + + +8. Copiez les fichiers HTML et JavaScript de l'application sur du projet Android `/assets/www` répertoire. + +9. Copie le `config.xml` dossier de `/framework/res/xml` pour le projet `/res/xml` répertoire. + + [1]: http://cordova.apache.org \ No newline at end of file http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/fd1b79a4/www/docs/fr/5.4.0/guide/platforms/blackberry/config.md ---------------------------------------------------------------------- diff --git a/www/docs/fr/5.4.0/guide/platforms/blackberry/config.md b/www/docs/fr/5.4.0/guide/platforms/blackberry/config.md new file mode 100644 index 0000000..3d9843b --- /dev/null +++ b/www/docs/fr/5.4.0/guide/platforms/blackberry/config.md @@ -0,0 +1,28 @@ +--- +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. + +title: Configuration de blackBerry +--- + +# Configuration de blackBerry + +BlackBerry souscrit pleinement la [Spécification W3C du Widget][1] ainsi que des extensions propriétaires de RIM. S'il vous plaît voir le complet [BlackBerry WebWorks documentation concernant config.xml][2] pour plus de détails. + + [1]: http://www.w3.org/TR/widgets/ + [2]: https://developer.blackberry.com/html5/documentation/working_with_config_xml_file_1866970_11.html \ No newline at end of file --------------------------------------------------------------------- To unsubscribe, e-mail: commits-unsubscribe@cordova.apache.org For additional commands, e-mail: commits-help@cordova.apache.org