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 EBD44107F2 for ; Fri, 30 Aug 2013 17:26:08 +0000 (UTC) Received: (qmail 33499 invoked by uid 500); 30 Aug 2013 17:26:02 -0000 Delivered-To: apmail-cordova-commits-archive@cordova.apache.org Received: (qmail 33049 invoked by uid 500); 30 Aug 2013 17:25:54 -0000 Mailing-List: contact commits-help@cordova.apache.org; run by ezmlm Precedence: bulk List-Help: List-Unsubscribe: List-Post: List-Id: Reply-To: dev@cordova.apache.org Delivered-To: mailing list commits@cordova.apache.org Received: (qmail 32560 invoked by uid 99); 30 Aug 2013 17:25:51 -0000 Received: from tyr.zones.apache.org (HELO tyr.zones.apache.org) (140.211.11.114) by apache.org (qpsmtpd/0.29) with ESMTP; Fri, 30 Aug 2013 17:25:51 +0000 Received: by tyr.zones.apache.org (Postfix, from userid 65534) id A4A2A89ED25; Fri, 30 Aug 2013 17:25:51 +0000 (UTC) Content-Type: text/plain; charset="us-ascii" MIME-Version: 1.0 Content-Transfer-Encoding: 8bit From: mwbrooks@apache.org To: commits@cordova.apache.org Date: Fri, 30 Aug 2013 17:26:06 -0000 Message-Id: In-Reply-To: References: X-Mailer: ASF-Git Admin Mailer Subject: [16/36] Add edge for Spanish, French, and Chinese. http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/992e9151/docs/fr/edge/cordova/storage/sqlresultsetrowlist/sqlresultsetrowlist.md ---------------------------------------------------------------------- diff --git a/docs/fr/edge/cordova/storage/sqlresultsetrowlist/sqlresultsetrowlist.md b/docs/fr/edge/cordova/storage/sqlresultsetrowlist/sqlresultsetrowlist.md new file mode 100644 index 0000000..a155b78 --- /dev/null +++ b/docs/fr/edge/cordova/storage/sqlresultsetrowlist/sqlresultsetrowlist.md @@ -0,0 +1,69 @@ +--- + +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. +--- + +# SQLResultSetRowList + +Une des propriétés de le `SQLResultSet` contenant les lignes retournées par une requête SQL. + +## Propriétés + +* **longueur**: le nombre de lignes retournées par la requête SQL. + +## Méthodes + +* **article**: retourne la ligne à l'index spécifié, représenté par un objet JavaScript. + +## Détails + +Le `SQLResultSetRowList` contient les données retournées à partir d'un SQL `select` déclaration. L'objet contient un `length` propriété indiquant combien de lignes le `select` instruction renvoie. Pour obtenir une ligne de données, appelez la `item` méthode pour spécifier un index. Elle retourne un JavaScript `Object` dont les propriétés sont les colonnes de base de données la `select` instruction a été exécutée dans. + +## Plates-formes prises en charge + +* Android +* BlackBerry WebWorks (OS 6.0 et supérieur) +* iOS +* Paciarelli + +## Exécuter SQL exemple rapide + + function queryDB(tx) {tx.executeSql ("SELECT * de démo ', [], querySuccess, errorCB);} + + function querySuccess (tx, résultats) {var len = results.rows.length ; + Console.log ("table de démo:" + len + « lignes trouvées. ») ; + pour (var j'ai = 0; j'ai < len; i ++) {console.log ("ligne =" + i + "ID =" + results.rows.item (i) .id + "données =" + results.rows.item(i).data) ; + }} function errorCB(err) {alert ("erreur lors du traitement SQL:" + err.code) ; + } var db = window.openDatabase ("Database", "1.0", "Cordova Demo", 200000) ; + DB.transaction (queryDB, errorCB) ; + + +## Exemple complet + + < !DOCTYPE html >< html >< tête >< titre > stockage exemple < / titre >< script type = "text/javascript" charset = "utf-8" src="cordova.js" >< / script >< script type = "text/javascript" charset = "utf-8" > / / attendre pour les bibliothèques de périphérique API charger / / document.addEventListener ("deviceready", onDeviceReady, false) ; + + / / Remplir la base de données / / function populateDB(tx) {tx.executeSql ("DROP TABLE IF EXISTS démo") ; + tx.executeSql ("créer TABLE IF NOT existe démo (données uniques, id)") ; + tx.executeSql (' insérer en démo (id, données) valeurs (1, "première ligne")') ; + tx.executeSql ("insérer en démo (id, données) valeurs (2,"Seconde ligne")") ; + } / / Interroger la base de données / / function queryDB(tx) {tx.executeSql ("SELECT * de démo ', [], querySuccess, errorCB) ; + } / / Interroger le rappel réussi / / function querySuccess (tx, résultats) {var len = results.rows.length ; + Console.log ("table de démo:" + len + « lignes trouvées. ») ; + pour (var j'ai = 0; j'ai < len; i ++) {console.log ("ligne =" + i + "ID =" + results.rows.item (i) .id + "données =" + results.rows.item(i).data) ; + }} / / Rappel erreur de transaction / / function errorCB(err) {console.log ("erreur lors du traitement SQL:" + err.code) ; + } / / Rappel réussi de transaction / / function successCB() {var db = window.openDatabase ("Database", "1.0", "Cordova Demo", 200000) ; + DB.transaction (queryDB, errorCB) ; + } / / périphérique API sont disponibles / / function onDeviceReady() {var db = window.openDatabase ("Database", "1.0", "Cordova Demo", 200000) ; + DB.transaction (populateDB, errorCB, successCB) ; + } < /script >< / chef >< corps >< h1 > exemple < / h1 >< p > base de données < /p >< / body >< / html > \ No newline at end of file http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/992e9151/docs/fr/edge/cordova/storage/sqltransaction/sqltransaction.md ---------------------------------------------------------------------- diff --git a/docs/fr/edge/cordova/storage/sqltransaction/sqltransaction.md b/docs/fr/edge/cordova/storage/sqltransaction/sqltransaction.md new file mode 100644 index 0000000..40b99d7 --- /dev/null +++ b/docs/fr/edge/cordova/storage/sqltransaction/sqltransaction.md @@ -0,0 +1,105 @@ +--- + +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. +--- + +# SQLTransaction + +Permet l'exécution d'instructions SQL sur la base de données. + +## Méthodes + +* **executeSql**: exécute une instruction SQL. + +## Détails + +Appeler une `Database` méthode de transaction de l'objet, passe un `SQLTransaction` objet à la méthode de rappel spécifiée. + +## Plates-formes prises en charge + +* Android +* BlackBerry WebWorks (OS 6.0 et supérieur) +* iOS +* Paciarelli + +## Exécuter SQL exemple rapide + + function populateDB(tx) { + tx.executeSql('DROP TABLE IF EXISTS DEMO'); + tx.executeSql('CREATE TABLE IF NOT EXISTS DEMO (id unique, data)'); + tx.executeSql('INSERT INTO DEMO (id, data) VALUES (1, "First row")'); + tx.executeSql('INSERT INTO DEMO (id, data) VALUES (2, "Second row")'); + } + + function errorCB(err) { + alert("Error processing SQL: "+err); + } + + function successCB() { + alert("success!"); + } + + var db = window.openDatabase("Database", "1.0", "Cordova Demo", 200000); + db.transaction(populateDB, errorCB, successCB); + + +## Exemple complet + + + + + Storage Example + + + + + +

Example

+

SQLTransaction

+ + \ No newline at end of file http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/992e9151/docs/fr/edge/cordova/storage/storage.md ---------------------------------------------------------------------- diff --git a/docs/fr/edge/cordova/storage/storage.md b/docs/fr/edge/cordova/storage/storage.md new file mode 100644 index 0000000..f72685c --- /dev/null +++ b/docs/fr/edge/cordova/storage/storage.md @@ -0,0 +1,67 @@ +--- + +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. +--- + +# Stockage + +> Donne accès aux options de stockage de l'appareil. + +Cette API offre des options de stockage basées sur deux différentes spécifications de W3C : + +* La [Spécification de l'API Web Storage][1] vous permet d'accéder aux données via des paires clé/valeur simple. Voir la section sur le localStorage pour plus de détails sur cette interface. + +* La [Spécification de base de données SQL Web][2] propose plusieurs tables de base de données complète accessible via des requêtes SQL. Un résumé de cette interface apparaît immédiatement en dessous. + + [1]: http://dev.w3.org/html5/webstorage/ + [2]: http://dev.w3.org/html5/webdatabase/ + +Cordova permet de rejoindre les deux interfaces pour la minorité d'appareils qui ne supportent pas déjà eux. Les implémentations intégrées s'appliquerait par ailleurs. + +## Méthodes + +* openDatabase + +## Arguments + +* database_name +* database_version +* database_displayname +* database_size + +## Objets + +* Base de données +* SQLTransaction +* SQLResultSet +* SQLResultSetRowList +* SQLError + +## Accéder à la fonctionnalité + +Depuis la version 3.0, l'accès aux API de stockage est intégré à Cordova et ne nécessite pas d'ajouter des plugins comme décrit dans l'Interface de ligne de commande à l'aide de la CLI. + +Si vous utilisez l'ancienne ensemble d'outils de Cordova qui précèdent le CLI, les paramètres de configuration spécifiques à la plate-forme suivants sont toujours nécessaires : + +* Android (dans`app/res/xml/config.xml`) + + < nom de la fonction = "Storage" >< param name = "android-package" value="org.apache.cordova.Storage" / >< / fiction > + + +* BlackBerry WebWorks (dans`www/config.xml`) + + < id="blackberry.widgetcache en vedette" requis = "true" version = "1.0.0.0" / > + + +Certaines plates-formes peuvent prendre en charge cette fonctionnalité sans nécessiter aucune configuration spéciale. Voir plate-forme prise en charge pour une vue d'ensemble. \ No newline at end of file http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/992e9151/docs/fr/edge/cordova/storage/storage.opendatabase.md ---------------------------------------------------------------------- diff --git a/docs/fr/edge/cordova/storage/storage.opendatabase.md b/docs/fr/edge/cordova/storage/storage.opendatabase.md new file mode 100644 index 0000000..096a37e --- /dev/null +++ b/docs/fr/edge/cordova/storage/storage.opendatabase.md @@ -0,0 +1,66 @@ +--- + +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. +--- + +# openDatabase + +Retourne un nouveau `Database` objet. + + var dbShell = window.openDatabase(database_name, database_version, database_displayname, database_size); + + +## Description + +La méthode crée une nouvelle base de données du Lite de SQL et retourne un `Database` objet permettant la manipulation des données. + +## Plates-formes prises en charge + +* Android +* BlackBerry WebWorks (OS 6.0 et supérieur) +* iOS +* Paciarelli + +## Petit exemple + + var db = window.openDatabase("test", "1.0", "Test DB", 1000000); + + +## Exemple complet + + + + + Storage Example + + + + + +

Example

+

Open Database

+ + \ No newline at end of file http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/992e9151/docs/fr/edge/guide/appdev/privacy/index.md ---------------------------------------------------------------------- diff --git a/docs/fr/edge/guide/appdev/privacy/index.md b/docs/fr/edge/guide/appdev/privacy/index.md new file mode 100644 index 0000000..7b68946 --- /dev/null +++ b/docs/fr/edge/guide/appdev/privacy/index.md @@ -0,0 +1,54 @@ +--- + +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. +--- + +# Guide de la vie privée + +Confidentialité mobile est une question essentielle que chaque développeur d'application doit relever. Vos utilisateurs s'attendent que leurs renseignements personnels seront recueillis et traités correctement par votre application. En outre, il y a un nombre croissant de juridictions qui ont maintenant des exigences légales concernant les pratiques de confidentialité mobile. + +Ce guide sur la vie privée de l'application mobile devrait considérer un *apprêt* questions peu le plus significatif. Il décrit certaines meilleures pratiques généralement acceptées et fournit des références à d'autres guides plus détaillées et les références. + +* **Politique de confidentialité**: vous app devrait inclure une politique de confidentialité qui traite de sujets tels que quelles informations votre app recueille auprès ou au sujet de vos utilisateurs, comment cette information est utilisée, avec lesquels il est partagé, et comment les utilisateurs peuvent faire des choix relatifs à la vie privée au sein de l'app. Pour faciliter la compréhension, vous devez utiliser un langage simple et éviter le jargon technique. Vous devriez faire votre politique de confidentialité disponible pour les utilisateurs d'examiner avant le téléchargement, comme dans la description de l'app dans la Galerie d'apps. En outre, vous devez vous votre politique de confidentialité, disponible dans l'application elle-même. La taille réduite des périphériques mobiles crée des difficultés pour afficher les politiques de confidentialité aux utilisateurs. Envisager l'élaboration d'une *version abrégée* de la politique qui inclut l'informa tion la plus importante et ensuite fournir un lien vers la politique de « forme longue » pour ceux qui s'intéressent de façon plus détaillée. Plusieurs groupes tentent d'élaborer des normes de base d'icônes pour la communication des pratiques de confidentialité, qui vous voudrez peut-être une fois que ces normes. + +* **Collecte d'informations sensibles**: collection de l'application des informations personnelles sensibles soulève des préoccupations importantes de la vie privée. Exemples de renseignements personnels sensibles des renseignements financiers, santé information et information auprès ou au sujet des enfants. Il comprend également des informations recueillies auprès de certains capteurs et bases de données que se trouves généralement sur les appareils mobiles et tablettes, telles que des informations de géolocalisation, contacts/annuaire téléphonique, microphone/appareil photo et des photos ou des vidéos stockées. Voir les pages suivantes de la documentation pour plus d'informations : [caméra][1], [capturer][2], [contacts][3]et [géolocalisation][4]. En règle générale, vous devez obtenir l'autorisation expresse de l'utilisateur avant de recueillir des informations sensibles et, si possible, fournir un mécanisme de contrôle qui vous permet de facilement modifier les autorisations. Systèmes d'exploitation app peut aider dans certains cas par la présentation des boîtes de dialogue de juste-à-temps demandent la permission de l'utilisateur avant le prélèvement. Dans ces cas, n'oubliez pas de profiter de toute occasion pour personnaliser le texte de boîte de dialogue afin de préciser comment le soft utilise et, le cas échéant, partage ces informations. + +* **Éviter la surprise de l'utilisateur**: Si votre app recueille ou utilise les informations d'une manière qui peut être surprenante pour les utilisateurs à la lumière de l'objectif principal de votre application (par exemple, un lecteur de musique qui accède à des photos stockées), vous devez prendre des mesures analogues comme pour la collecte des informations personnelles sensibles. C'est-à-dire, vous devez envisager fortement l'utilisation de boîtes de dialogue juste-à-temps pour informer l'utilisateur de la collection ou l'utilisation de ces informations et, le cas échéant, fournir un contrôle de confidentialité correspondant. + +* **Collecte de données de tiers ou de partage**: Si vous app rassemble l'information qui est fournie à une autre société--comme une plateforme de réseau social ou d'un réseau ad (par exemple, si votre application affiche publicitaire)--vous devez en informer vos utilisateurs de cette collection et le partage. Au minimum, votre politique de confidentialité devrait décrire la collecte de l'information et de partage et, le cas échéant, offrir à vos utilisateurs la capacité de contrôle ou opt-out de cette collecte ou le partage. + +* **Sécurité et limitation de la collecte**: vos utilisateurs confient votre app avec leurs informations et qu'ils attendent que vous prendrez des précautions de sécurité appropriées pour le protéger. Un des meilleurs moyens de ne pas compromettre la sécurité des renseignements personnels est ne pas à collecter les informations en premier lieu, à moins que votre application a une raison d'affaires spécifiques et légitimes pour la collection. Pour plus d'informations qui a besoin d'être recueillis, vous assurer de fournir des contrôles de sécurité appropriés pour protéger cette information, si elle est stockée sur l'appareil ou sur vos serveurs back-end. Vous devez également développer une stratégie de rétention de données appropriées qui est mis en œuvre au sein de l'app et sur vos serveurs back-end. + + [1]: cordova_camera_camera.md.html + [2]: cordova_media_capture_capture.md.html + [3]: cordova_contacts_contacts.md.html + [4]: cordova_geolocation_geolocation.md.html + +Voici quelques guides de confidentialité mobile utile accrue pour les développeurs : + +* Procureur général de la Californie, [la vie privée sur le pouce : recommandations pour l'écosystème Mobile][5] + +* Center for Democracy & Technology, Future of Privacy Forum, [meilleures pratiques pour les développeurs d'applications mobiles][6] + +* CTIA-la liaison sans fil, [Services basés sur les meilleures pratiques et conseils pour Location][7] + +* Federal Trade Commission, [communications mobiles de la vie privée : instaurer la confiance par le biais de transparence][8] + +* Future of Privacy Forum, site Web [demande de confidentialité][9] + + [5]: http://oag.ca.gov/sites/all/files/pdfs/privacy/privacy_on_the_go.pdf + [6]: http://www.futureofprivacy.org/wp-content/uploads/Best-Practices-for-Mobile-App-Developers_Final.pdf + [7]: http://www.ctia.org/business_resources/wic/index.cfm/AID/11300 + [8]: http://www.ftc.gov/os/2013/02/130201mobileprivacyreport.pdf + [9]: http://www.applicationprivacy.org \ No newline at end of file http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/992e9151/docs/fr/edge/guide/appdev/whitelist/index.md ---------------------------------------------------------------------- diff --git a/docs/fr/edge/guide/appdev/whitelist/index.md b/docs/fr/edge/guide/appdev/whitelist/index.md new file mode 100644 index 0000000..2560b94 --- /dev/null +++ b/docs/fr/edge/guide/appdev/whitelist/index.md @@ -0,0 +1,171 @@ +--- + +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. +--- + +# Domain Whitelist Guide + +## Vue d'ensemble + +Domaine liste blanche est un modèle de sécurité qui contrôle l'accès à des domaines externes, tels que `http://google.com` . Stratégie de sécurité par défaut de Apache Cordova permet d'accéder à n'importe quel site. Avant de déplacer votre application à la production, vous devriez revoir la liste blanche et déclarer l'accès au réseau des domaines et sous-domaines. + +## Spécification + +Domaine whitelisting jette les bases pour la spécification [W3C Widget accès][1] . Dans la spécification de l'accès de Widget, le `` élément est utilisé pour déclarer l'accès aux domaines réseau spécifiques. À l'avenir, Apache Cordova va résumer les implémentations de liste blanche de plate-forme à la spécification W3C Widget accès. Toutefois, pour l'instant, chaque plate-forme doit implémenter sa propre liste blanche du domaine. + + [1]: http://www.w3.org/TR/widgets-access/ + +## Syntaxe + +Accès à [google.com][2]: + + [2]: http://google.com + + http://Google.com + + +Accès sécurisé [google.com][3] ( `https://` ) : + + [3]: https://google.com + + https://Google.com + + +Accès pour le sous-domaine [maps.google.com][4]: + + [4]: http://maps.google.com + + http://Maps.google.com + + +Accès à tous les sous-domaines sur [google.com][2] (p. ex., [mail.google.com][5] et [docs.google.com][6]) : + + [5]: http://mail.google.com + [6]: http://docs.google.com + + http://*.google.com + + +Accès à tous les domaines (par exemple, [google.com][2] et [developer.mozilla.org][7]) : + + [7]: http://developer.mozilla.org + + * + + +## Android + +### Détails + +Les règles de liste blanche se trouvent dans `res/xml/config.xml` et déclarée avec l'élément``. + +Android souscrit pleinement la syntaxe de la liste blanche. + +### Syntaxe + +Accès à [google.com][2]: + + < accéder origin="http://google.com" / > + + +## BlackBerry + +### Détails + +Les règles de liste blanche se trouvent dans `www/config.xml` et déclarée avec l'élément``. + +Pour une référence complète, consultez la [documentation de l'élément d'accès BlackBerry WebWorks][8]. + + [8]: https://developer.blackberry.com/html5/documentation/ww_developing/Access_element_834677_11.html + +### Syntaxe + +Accès à [google.com][2]: + + < accéder uri="http://google.com" sous-domaines = "false" / > + + +Accès à [maps.google.com][4]: + + < accéder uri="http://maps.google.com" sous-domaines = "false" / > + + +Accès à tous les sous-domaines sur [Google.fr][2]: + + < accéder uri="http://google.com" sous-domaines = "true" / > + + +Accès à tous les domaines, y compris `file://` protocole : + + < accès uri = "*" sous-domaines = « true » / > + + +## iOS + +### Détails + +Les règles de liste blanche se trouvent dans `AppName/config.xml` et déclarée avec l'élément``. + +iOS soutient pleinement la syntaxe de la liste blanche. + +**Remarque :** origines spécifiés sans un protocole, tel que `www.apache.org` plutôt que `http://www.apache.org` , par défaut à tous les `http` , `https` , `ftp` , et `ftps` régimes. + +### Syntaxe + +Caractères génériques sur iOS ( `*` ) sont plus souples que la spécification [W3C Widget accès][1] . + +Accès à tous les sous-domaines et les TLDs ( `.com` , `.net` , etc.) : + + *. google.* + + +## Windows Phone (7 & 8) + +Les règles de liste blanche se trouvent dans `config.xml` et déclarée avec l'élément``. + +Android soutient pleinement la syntaxe de la liste blanche. + +### Syntaxe + +Accès à [google.com][2]: + + < accéder origine = « http://google.com » / > + + +## Paciarelli + +### Détails + +Du répertoire racine l'application `config.xml` fichier spécifie les règles de liste blanche de domaine, en utilisant le `` élément. Pour une référence complète, consultez la \[documentation de paciarelli accès à des ressources du réseau externe\] \[10\]. + +### Syntaxe + +Accès à [google.com][2]: + + < accéder origin="http://google.com" sous-domaines = "false" / > + + +Accès sécurisé [google.com][3] ( `https://` ) : + + < accéder origin="https://google.com" sous-domaines = "false" / > + + +Accès à tous les sous-domaines sur [Google.fr][2]: + + < accéder origin="http://google.com" sous-domaines = "true" / > + + +Accès à tous les domaines, y compris `file://` protocole : + + < accéder origine = "*" sous-domaines = « true » / > \ No newline at end of file http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/992e9151/docs/fr/edge/guide/cli/index.md ---------------------------------------------------------------------- diff --git a/docs/fr/edge/guide/cli/index.md b/docs/fr/edge/guide/cli/index.md new file mode 100644 index 0000000..5c7e2b1 --- /dev/null +++ b/docs/fr/edge/guide/cli/index.md @@ -0,0 +1,267 @@ +--- + +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. + + +--- + +# L'Interface de ligne de commande + +Ce guide vous montre comment créer des applications et déployez-les sur différentes plates-formes mobiles natives à l'aide de la `cordova` Command-line interface (CLI). Cet outil permet de créer de nouveaux projets, les construire sur différentes plates-formes et de les exécuter dans un émulateur. Vous pouvez également utiliser la CLI pour initialiser le code du projet, après quoi vous utilisez kits de développement logiciel des différentes plates-formes pour les développer davantage. + +## Conditions préalables + +Avant d'exécuter tous les outils de ligne de commande, vous devez installer le SDK pour chaque plate-forme que vous voulez cibler. (Voir les Guides de la plate-forme pour plus de détails.) + +Pour ajouter le support ou reconstruire un projet pour n'importe quelle plateforme, vous devez exécuter la commande-ligne interface de la même machine qui prend en charge SDK de la plate-forme. L'ICA prend en charge les combinaisons suivantes : + +* iOS (Mac) +* Android (Mac, Linux) +* BlackBerry 10 (Mac, Linux, Windows) +* Windows Phone 7 (Windows) +* Windows Phone 8 (Windows) + +Sur le Mac, la ligne de commande est accessible via l'application *Terminal* . Sur le PC, il est disponible en *invite de commande* sous *accessoires*. + +Plus il est probable que vous exécutez le CLI de machines différentes, plus il est logique de maintenir un référentiel de code source éloignée, dont les actifs vous tirez vers le bas pour les répertoires de travail local. + +Pour installer le `cordova` de ligne de commande outil, procédez comme suit : + +1. Télécharger et installer [Node.js][1]. Après installation, vous devriez être capable d'appeler `node` ou `npm` sur votre ligne de commande. + +2. Installer le `cordova` utilitaire. Sous Unix, faisant précéder la supplémentaires `sudo` commande peut être nécessaire pour installer les utilitaires de développement en autrement limité des répertoires : + + $ sudo npm install -g cordova + + + Le journal d'installation peut générer des erreurs pour n'importe quelle plateforme désinstallé SDK. Après installation, vous devriez être en mesure d'exécuter `cordova` sur la ligne de commande. + + [1]: http://nodejs.org/ + +## Créer l'application + +Allez dans le répertoire où vous conservez votre code source et exécutez une commande comme suit : + + $ cordova create hello com.example.hello HelloWorld + + +Il peut prendre un certain temps pour la commande pour terminer, alors soyez patient. Exécutez le `cordova -d` pour voir les informations sur la progression. + +Le premier argument spécifie un répertoire *Bonjour* à générer pour votre projet. Sa `www` sous-répertoire maisons page d'accueil de votre application, ainsi que diverses ressources sous `css` , `js` , et `img` , qui suivent les conventions de dénomination de fichier du développement des web commun. Le `config.xml` fichier contient des métadonnées importantes nécessaires pour générer et distribuer l'application. + +Les deux autres arguments sont facultatifs : le `com.example.hello` argument donne à votre projet avec un identificateur de domaine inverse-style et la `HelloWorld` fournit le texte d'affichage de l'application. Vous pouvez modifier ces deux valeurs plus tard dans le `config.xml` fichier. + +## Ajouter des plates-formes + +Toutes les commandes suivantes doivent être exécutées dans le répertoire du projet ou les sous-répertoires dans sa portée : + + $ cd hello + + +Avant que vous pouvez générer le projet, vous devez spécifier un jeu de plates-formes cibles. Votre capacité d'exécuter ces commandes dépend de savoir si votre ordinateur prend en charge chaque SDK, et si vous avez déjà installé chaque SDK. Courir à chacun d'entre eux d'un Mac : + + $ cordova platform add ios + $ cordova platform add android + $ cordova platform add blackberry10 + + +Courir à chacun d'entre eux depuis une machine Windows, où *wp* se réfère aux différentes versions du système d'exploitation Windows Phone : + + $ cordova platform add wp7 + $ cordova platform add wp8 + $ cordova platform add android + $ cordova platform add blackberry10 + + +Exécutez-le pour vérifier votre noyau de plateformes : + + $ cordova platforms ls + + +(Note du `platform` et `platforms` commandes sont synonymes.) + +Exécutez une des commandes suivantes synonymes d'enlever une plate-forme : + + $ cordova platform remove blackberry10 + $ cordova platform rm android + + +Exécution de commandes pour ajouter ou supprimer des affects de plates-formes le contenu du répertoire de *plates-formes* du projet, où chaque plate-forme spécifiée apparaît comme un sous-répertoire. Le répertoire de source *www* est reproduit dans le sous-répertoire de la plate-forme, qui apparaît par exemple dans `platforms/ios/www` ou `platforms/android/assets/www` . Par défaut, le fichier de configuration de chaque plateforme est configuré pour pouvoir accéder à l'ensemble des API de Cordova. + +Si vous le souhaitez, vous pouvez utiliser un SDK à ce stade d'ouvrir le projet que vous avez créé. Toutefois, les modifications que vous apportez au projet au sein d'un affect SDK le dérivé ensemble de biens, pas les fichiers source multi-plateforme d'origine. Utilisez cette approche si vous souhaitez simplement initialiser un projet. (Voir les Guides de la plate-forme pour plus d'informations sur la façon de développer des applications au sein de chaque SDK.) Lire sur si vous souhaitez utiliser les outils de ligne de commande pour le cycle de développement complet. + +## Construire l'application + +Par défaut, le `cordova create` script génère une squelettique application web dont la page d'accueil est du projet `www/index.html` fichier. Modifier cette application, mais vous voulez, mais toute initialisation doit être spécifiée dans le cadre de la `deviceready` gestionnaire d'événements, référencé par défaut de `www/js/index.js` . + +Exécutez la commande suivante pour générer itérativement le projet : + + $ cordova build + + +Cela génère un code spécifique à la plateforme au sein du projet `platforms` sous-répertoire. Vous pouvez éventuellement restreindre la portée de chaque génération de plates-formes spécifiques : + + $ cordova build ios + + +Le `cordova build` commande est un raccourci pour la suivante, qui, dans cet exemple, est également visé à une plate-forme unique : + + $ cordova prepare ios + $ cordova compile ios + + +Dans ce cas, une fois que vous exécutez `prepare` , vous pouvez utiliser Apple Xcode SDK comme alternative pour modifier et compiler le code spécifique à la plateforme qui génère de Cordova dans `platforms/ios` . Vous pouvez utiliser la même approche avec les kits de développement logiciel des autres plates-formes. + +## Tester l'application sur un émulateur ou un périphérique + +Kits de développement logiciel pour les plates-formes mobiles sont souvent livrés avec les émulateurs qui exécutent un élément image, afin que vous pouvez lancer l'application depuis l'écran d'accueil et voir comment il interagit avec de nombreuses fonctionnalités de la plate-forme. Exécuter une commande telle que la suivante pour reconstruire l'app et il découvre au sein de l'émulateur une spécifique de la plate-forme : + + $ cordova emulate android + + +Certaines plates-formes mobiles émulent un périphérique par défaut, tels que l'iPhone pour les projets de l'iOS. Pour d'autres plateformes, vous devrez tout d'abord associer un périphérique avec un émulateur. (Voir les Guides de la plate-forme pour plus de détails.) Par exemple, vous pouvez d'abord exécuter la `android` commande pour lancer le SDK Android, puis exécutez une image de périphérique particulier, dont il lance selon son comportement par défaut : + +![][2] + + [2]: img/guide/cli/android_emulate_init.png + +Suivi auprès du `cordova emulate` commande actualise l'image de l'émulateur pour afficher la dernière application, qui est maintenant disponible pour le lancement de l'écran d'accueil : + +![][3] + + [3]: img/guide/cli/android_emulate_install.png + +Alternativement, vous pouvez brancher le combiné dans votre ordinateur et tester l'application directement : + + $ cordova run android + + +Avant d'exécuter cette commande, vous devez mettre en place le dispositif de test, suivant des procédures qui varient pour chaque plate-forme. Dans le cas d'Android, vous devrez activer une option de **Débogage USB** sur l'appareil et peut-être ajouter un pilote USB selon votre environnement de développement. Consultez les Guides de la plate-forme pour plus de détails sur les exigences de chaque plateforme. + +## Ajouter des fonctionnalités + +Lorsque vous générez et découvre un nouveau projet, l'application par défaut qui s'affiche n'est pas faire grand-chose. Vous pouvez modifier l'application de plusieurs façons de tirer parti des technologies web standard, mais l'application de communiquer étroitement avec diverses fonctions au niveau du périphérique, vous devez ajouter des plugins qui permettent d'accéder au noyau Cordova APIs. + +Un *plugin* est un peu de code complémentaire qui fournit une interface pour les composants natifs. Vous pouvez concevoir votre propre interface plugin, par exemple, lorsque vous concevez une application hybride qui mêle une Cordova WebView composants natifs. (Voir intégration WebViews et Plugin Development Guide pour plus de détails). Plus généralement, vous devez ajouter un plugin pour activer une des caractéristiques fondamentales de niveau périphérique de Cordova décrites dans la référence de l'API. + +Le `cordova plugin add` commande nécessite vous permet de spécifier le référentiel pour le code du plugin. Voici des exemples de fonctionnalités, que vous pouvez ajouter : + +* Informations de base périphérique (Device API) : + + plugin cordova $ ajouter https://git-wip-us.apache.org/repos/asf/cordova-plugin-device.git + + +* Connexion réseau et événements de la batterie : + + $ cordova plugin ajoute $ https://git-wip-us.apache.org/repos/asf/cordova-plugin-network-information.git cordova plugin ajouter https://git-wip-us.apache.org/repos/asf/cordova-plugin-battery-status.git + + +* Accéléromètre, boussole et géolocalisation : + + $ cordova plugin ajoute $ https://git-wip-us.apache.org/repos/asf/cordova-plugin-device-motion.git cordova plugin ajoute $ https://git-wip-us.apache.org/repos/asf/cordova-plugin-device-orientation.git cordova plugin ajouter https://git-wip-us.apache.org/repos/asf/cordova-plugin-geolocation.git + + +* Appareil photo, lecture et Capture : + + $ cordova plugin ajoute https://git-wip-us.apache.org/repos/asf/cordova-plugin-camera.git $ cordova plugin ajoute $ https://git-wip-us.apache.org/repos/asf/cordova-plugin-media-capture.git cordova plugin ajouter https://git-wip-us.apache.org/repos/asf/cordova-plugin-media.git + + +* Accéder aux fichiers sur un périphérique réseau (fichier API) : + + $ cordova plugin ajoute https://git-wip-us.apache.org/repos/asf/cordova-plugin-file.git $ cordova plugin ajouter https://git-wip-us.apache.org/repos/asf/cordova-plugin-file-transfer.git + + +* Notification via la boîte de dialogue ou de vibration : + + $ cordova plugin ajoute https://git-wip-us.apache.org/repos/asf/cordova-plugin-dialogs.git $ cordova plugin ajouter https://git-wip-us.apache.org/repos/asf/cordova-plugin-vibration.git + + +* Contacts : + + plugin cordova $ ajouter https://git-wip-us.apache.org/repos/asf/cordova-plugin-contacts.git + + +* Mondialisation : + + plugin cordova $ ajouter https://git-wip-us.apache.org/repos/asf/cordova-plugin-globalization.git + + +* SplashScreen : + + plugin cordova $ ajouter https://git-wip-us.apache.org/repos/asf/cordova-plugin-splashscreen.git + + +* Fenêtres ouvertes du navigateur nouvelle (InAppBrowser) : + + plugin cordova $ ajouter https://git-wip-us.apache.org/repos/asf/cordova-plugin-inappbrowser.git + + +* Console de débogage : + + plugin cordova $ ajouter https://git-wip-us.apache.org/repos/asf/cordova-plugin-console.git + + +Utilisation `plugin ls` (ou `plugin list` , ou `plugin` en soi) à Découvre actuellement les plugins installés. Chacun affiche par son identificateur : + + $ cordova plugin ls # ou « list plugin » ['org.apache.cordova.core.console'] + + +Pour supprimer un plugin, faire référence à elle par le même identificateur qui apparaît dans la liste. Par exemple, voici comment vous enlèverait le soutien pour une console de débogage d'une version : + + $ cordova plugin rm org.apache.cordova.core.console $ cordova plugin supprimer org.apache.cordova.core.console # même + + +Vous pouvez lot-supprimer ou ajouter des plugins en spécifiant plusieurs arguments pour chaque commande. + +## Personnaliser chaque plate-forme + +Alors que Cordoue vous permet de déployer facilement une application pour nombreuses plates-formes, parfois vous avez besoin d'ajouter des personnalisations. Dans ce cas, vous ne voulez pas modifier les fichiers source dans divers `www` répertoires à l'intérieur du premier niveau `platforms` répertoire, car ils sont remplacés régulièrement avec le niveau supérieur `www` source multi-plateforme de l'annuaire. + +Au lieu de cela, le niveau supérieur `merges` répertoire offre un endroit pour spécifier des actifs de déployer sur des plates-formes spécifiques. Chaque sous-répertoire spécifique à la plateforme dans `merges` reflète la structure de répertoire de la `www` l'arbre source, ce qui vous permet de substituer ou ajouter des fichiers au besoin. Par exemple, voici comment vous pourriez utilise `merges` pour augmenter la taille de police par défaut pour les appareils Android : + +* Modifier la `www/index.html` fichier, en ajoutant un lien vers un fichier CSS supplémentaire, `overrides.css` dans ce cas : + + < link rel = "stylesheet" type = "text/css" href="css/overrides.css" / > + + +* Créer éventuellement un vide `www/css/overrides.css` fichier, qui s'applique pour toutes les versions non-Android, empêchant une erreur de fichier manquant. + +* Créer un `css` sous-répertoire dans `merges/android` , puis ajoutez un correspondant `overrides.css` fichier. Spécifier CSS qui remplace la taille de police de 12 points par défaut spécifiée dans `www/css/index.css` , par exemple : + + Body {font-size : 14px;} + + +Lorsque vous régénérez le projet, la version Android dispose de la taille de police personnalisée, tandis que d'autres restent inchangés. + +Vous pouvez également utiliser `merges` pour ajouter des fichiers non présents dans l'original `www` répertoire. Par exemple, une application peut intégrer un *bouton* graphique à l'interface d'iOS, stocké dans `merges/ios/img/back_button.png` , tandis que la version Android peut au lieu de capter `backbutton` événements de la touche correspondante de la quincaillerie. + +## Mise à jour de Cordova + +Après avoir installé la `cordova` utilitaire, vous pouvez toujours mettre à jour elle vers la dernière version en exécutant la commande suivante : + + $ sudo NGP update cordova -g + + +Utilisez cette syntaxe pour installer une version spécifique : + + $ sudo NGP installer -g cordova@3.0.0 + + +Exécutez `cordova -v` pour voir la version en cours d'exécution. Exécutez le `npm +info` commande pour obtenir une liste plus longue qui inclut la version actuelle ainsi que d'autres numéros de version disponible : + + $ NGP info cordova + + +Cordova 3.0 est la première version à supporter l'interface de ligne de commande décrite dans cette section. Si vous mettez à jour depuis une version antérieure à 3.0, vous devez créer un nouveau projet, tel que décrit ci-dessus, puis copiez les actifs les plus âgés de l'application dans le niveau supérieur `www` répertoire. Le cas échéant, plus amples détails sur la mise à niveau vers 3.0 sont disponibles dans les Guides de la plate-forme. Une fois que vous mettez à niveau vers le `cordova` Command-line interface et utilisation `npm update` pour rester à jour, les plus longues procédures décrits là ne sont plus pertinentes. \ No newline at end of file http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/992e9151/docs/fr/edge/guide/hybrid/plugins/index.md ---------------------------------------------------------------------- diff --git a/docs/fr/edge/guide/hybrid/plugins/index.md b/docs/fr/edge/guide/hybrid/plugins/index.md new file mode 100644 index 0000000..d4c059a --- /dev/null +++ b/docs/fr/edge/guide/hybrid/plugins/index.md @@ -0,0 +1,84 @@ +--- + +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. +--- + +# Guide de développement de plugin + +Un ponts de plugin de Cordova, un peu de fonctionnalité entre le WebView alimentant une application de Cordova et la plate-forme native, l'application de Cordova s'exécute sur. Plugins sont composés d'une seule interface JavaScript utilisée sur toutes les plates-formes et des implémentations natives suite d'interfaces de Plugin spécifique à la plateforme qui appelle le code JavaScript. Tous le noyau Cordova APIs sont implémentées à l'aide de cette architecture. + +Ce guide étapes le processus d'écriture d'un Plugin Echo simple qui transmet une chaîne à partir de JavaScript et l'envoie dans l'environnement natif pour les plates-formes supportées. Le code natif retourne alors la chaîne même aux rappels à l'intérieur JavaScript du plugin. + +Ce guide fournit suffisamment aperçu sur lequel vous pouvez construire pour écrire des plugins plus complexes. + +## JavaScript + +Le point d'entrée pour n'importe quel plugin est JavaScript. L'utilisation de développeurs raison que Cordova est afin qu'ils puissent utiliser et écrire JavaScript, pas Objective-C, pas de Java, pas de langage c#. L'interface JavaScript de votre plugin est la partie frontale et sans doute plus importante de votre plugin de Cordova. + +Vous pouvez structurer votre plugin JavaScript comme bon vous semble. La seule chose que vous *devez* utiliser pour communiquer entre le Cordova JavaScript et les environnements natifs est le `cordova.exec` fonction. Voici un exemple : + + cordova.exec(function(winParam) {}, function(error) {}, "service", + "action", ["firstArgument", "secondArgument", 42, + false]); + + +Les paramètres sont détaillées ci-dessous : + +* `function(winParam) {}`: Rappel de fonction succès. En supposant que votre `exec` appel se termine avec succès, cette fonction est appelée (en option avec tous les paramètres vous passez à lui). + +* `function(error) {}`: Rappel d'erreur de fonction. Si l'opération ne se termine pas avec succès, cette fonction est appelée (éventuellement avec un paramètre error). + +* `"service"`: Le nom du service pour appeler dans le côté natif. Il est mappé à une classe native, sur lequel des informations supplémentaires sont disponibles dans les guides autochtones énumérées ci-dessous. + +* `"action"`: Le nom de l'action d'appeler. C'est capté par le récepteur de la classe native le `exec` appel et, dépendant de la plate-forme, essentiellement correspond à méthode d'une classe. Les natives guides énumérés ci-dessous fournissent des détails. + +* `[/* arguments */]`: Arguments pour passer dans l'environnement natif. + +### Exemple de JavaScript Plugin Echo + + window.echo = function(str, callback) { + cordova.exec(callback, function(err) { + callback('Nothing to echo.'); + }, "Echo", "echo", [str]); + }; + + +Plongeons-nous dans tout cela. Le plugin s'attache à `window` , plus précisément à la `echo` fonction. Plugin utilisateurs seraient alors utilisez-le comme suit : + + window.echo("echome", function(echoValue) { + alert(echoValue == "echome"); // should alert true. + }); + + +Tout d'abord, nous allons jeter un regard sur les trois derniers arguments de la `exec` fonction. Nous demanderons le `Echo` « de service », demandant la `echo` « action », et en passant un tableau d'arguments qui contient la chaîne echo, qui est le premier paramètre dans la `window.echo` fonction. + +Le rappel du succès passé dans `exec` est simplement une référence au rappel fonction `window.echo` prend. Nous faisons un peu plus pour le rappel de l'erreur : si le côté natif déclenche le rappel de l'erreur, nous avons simplement appeler le rappel de la réussite et transmettez-lui une chaîne « par défaut ». + +## Spécification du plugin + +Cordoue possède une spécification de plugin disponible pour activer l'installation automatique du plugin pour Android, iOS, plates-formes 10 BlackBerry et Windows Phone. En structurant votre plugin de façon particulière et en ajoutant un `plugin.xml` fichier manifeste, vous pouvez permettre aux utilisateurs d'installer votre plug-in via les outils de ligne de commande. + +* Spécification du plugin + +## Native + +Une fois que vous définissez JavaScript pour votre plugin, vous devez compléter au moins une implémentation native. Détails de le faire pour chaque plate-forme sont répertoriées ci-dessous. Ces guides continuent de miser sur l'exemple simple de Plugin Echo discuté ci-dessus. + +* Plugins Android +* Plugins de blackBerry +* BlackBerry 10 Plugins +* iOS Plugins +* Windows Phone Plugins + +La plate-forme paciarelli ne supporte actuellement pas de plugins. \ No newline at end of file http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/992e9151/docs/fr/edge/guide/hybrid/webviews/index.md ---------------------------------------------------------------------- diff --git a/docs/fr/edge/guide/hybrid/webviews/index.md b/docs/fr/edge/guide/hybrid/webviews/index.md new file mode 100644 index 0000000..1c1a6a8 --- /dev/null +++ b/docs/fr/edge/guide/hybrid/webviews/index.md @@ -0,0 +1,22 @@ +--- + +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. +--- + +# Intégration WebViews + +> Mettre en œuvre le Cordova WebView dans votre propre projet. + +* Android WebViews +* iOS WebViews \ No newline at end of file http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/992e9151/docs/fr/edge/guide/overview/index.md ---------------------------------------------------------------------- diff --git a/docs/fr/edge/guide/overview/index.md b/docs/fr/edge/guide/overview/index.md new file mode 100644 index 0000000..afda3ea --- /dev/null +++ b/docs/fr/edge/guide/overview/index.md @@ -0,0 +1,701 @@ +--- + +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. + + +--- + +# Vue d'ensemble + +Cordova est un framework de développement mobile open-source. Il vous permet d'utiliser des technologies web standard tels que HTML5, CSS3 et JavaScript pour le développement multi-plateforme, en évitant de langue native development chaque mobile platforms. Les applications s'exécutent dans les wrappers ciblées pour chaque plate-forme et s'appuient sur les liaisons conforme aux normes d'API pour accéder aux capteurs de chaque appareil, les données et état du réseau. + +Utilisez Cordova, si vous êtes : + +* un développeur mobile et que vous voulez pour étendre une application sur plusieurs plates-formes, sans avoir à re-mettre en œuvre avec l'outil et la langue de chaque plateforme définie. + +* un développeur web et que vous voulez pour déployer une application web qui est emballée pour distribution dans divers $ $ etAPP stockent des portails. + +* un développeur de mobile intéressé par la combinaison de composants de l'application native avec une *WebView* (fenêtre de navigateur) qui peut accéder aux API de niveau périphérique, ou si vous voulez développer une interface plugin entre les autochtones et les composants WebView. + +## Composants de base + +Cordova applications s'appuient sur un commun `config.xml` fichier qui fournit des informations sur l'application et spécifie les paramètres qui affectent comment ça marche, comme si elle répond à l'orientation se déplace. Ce fichier respecte [Emballés Web App][1]ou *widget*, spécification de la W3C. + + [1]: http://www.w3.org/TR/widgets/ + +L'application elle-même est implémenté comme une page web, nommé *index.html* par défaut, qui fait référence à quelque CSS, JavaScript, images, fichiers multimédias, ou d'autres ressources sont nécessaires pour son exécution. L'application s'exécute sous une *WebView* dans le wrapper de l'application native, qui vous distribuez à l'app store. Pour l'application web d'interagir avec diverses fonctions de l'appareil font les apps de façon natives, il doit également référencer un `cordova.js` fichier, qui fournit une API. + +Le WebView Cordova-activé peut prévoir l'application grâce à son interface utilisateur entière. Il peut aussi être un composant dans une application hybride plus grande, qui mêle le mode Web avec des composants de l'application native. Cordova fournit une interface *plugin* pour ces composants de communiquer entre eux. + +## Voies de développement + +La meilleure façon de mettre en place une application doit exécuter le `cordova` de l'utilitaire, aussi connu sous le nom *Command-line interface* (CLI). (Pour installer le CLI, voir The Command-Line Interface). Selon l'ensemble des plateformes que vous souhaitez cibler, vous pouvez compter sur la CLI pour des actions plus en plus importantes du cycle de développement : + +* Dans le scénario de base, vous pouvez utiliser l'interface CLI simplement pour créer un nouveau projet qui est rempli avec la configuration par défaut pour modifier. + +* Pour de nombreuses plateformes mobiles, vous pouvez également utiliser la CLI de mettre en place les fichiers de projet supplémentaire requis pour compiler dans chaque kit de développement logiciel. Pour ce faire, vous devez installer SDK chaque ciblée de la plate-forme. (Voir les Guides de la plate-forme pour obtenir des instructions.) Comme indiqué dans le tableau de la plateforme de Support ci-dessous, vous devrez peut-être exécuter la CLI sur différents systèmes d'exploitation selon la plateforme ciblée. + +* Pour les plateformes, la CLI peut compiler les applications et de les exécuter dans un émulateur de périphérique SDK. pour le test complet, vous pouvez également générer des fichiers d'application et les installer directement sur un périphérique. + +À tout moment dans le cycle de développement, vous pouvez également compter sur les outils spécifiques à la plate-forme SDK, qui peuvent offrir un ensemble plus large d'options. (Voir les Guides de la plate-forme pour plus d'informations sur l'outil du SDK de la plate-forme chaque jeu). Un environnement SDK est plus approprié si vous voulez implémenter une application hybride qui mêle des composants d'applications web et natives. vous pouvez utiliser l'utilitaire de ligne de commande pour générer initialement l'app, ou de manière itérative par la suite pour nourrir code mis à jour pour les outils du kit de développement logiciel. Vous pouvez également créer fichier de configuration de l'application vous-même. + + + + + +## Plateforme de Support + +Vous trouverez ci-dessous l'ensemble des outils de développement et dispositif API disponibles pour chaque plate-forme mobile. (Les en-têtes de colonne affichent les talons de sténographie de la CLI.) + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ + Android + + BlackBerry (6) + + blackberry10 + + iOS + + WP7 (Windows
Phone 7) + 		+ wp8 (Windows
Téléphone 8) + 		+ WIN8
(Windows 8) + 		+ paciarelli +
+ Cordova
CLI + 		+ Mac, Windows, Linux + + Mac, Windows + + Mac, Windows + + Mac + + Windows + + Windows + + +
+ Embedded
WebView + 		+ (voir détails) + + + + (voir détails) + + + + +
+ Plug-in
Interface + 		+ (voir détails) + + (voir détails) + + (voir détails) + + (voir détails) + + (voir détails) + + + +
+ + API de la plate-forme +
+ Accéléromètre + + + + + + + + +
+ Appareil photo + + + + + + + + +
+ Capture + + + + + + + + +
+ Boussole + + + + + (3 G +) + + + + +
+ Connexion + + + + + + + + +
+ Contacts + + + + + + + + +
+ Dispositif + + + + + + + + +
+ Événements + + + + + + + + +
+ Fichier + + + + + + aucun transfert de fichiers + + aucun transfert de fichiers + + +
+ Géolocalisation + + + + + + + + +
+ Mondialisation + + + + + + + + +
+ InAppBrowser + + + + + + + + +
+ Media + + + + + + + + +
+ Notification + + + + + + + + +
+ SplashScreen + + + + + + + + +
+ Stockage + + + + + + localStorage seulement + + localStorage seulement + + +
+ + \ No newline at end of file http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/992e9151/docs/fr/edge/guide/platforms/android/config.md ---------------------------------------------------------------------- diff --git a/docs/fr/edge/guide/platforms/android/config.md b/docs/fr/edge/guide/platforms/android/config.md new file mode 100644 index 0000000..5615517 --- /dev/null +++ b/docs/fr/edge/guide/platforms/android/config.md @@ -0,0 +1,45 @@ +--- + +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. +--- + +# Configuration Android + +Le `config.xml` fichier contrôle les différents paramètres de Cordova. Elles s'appliquent dans toute l'application et par l'instance de CordovaWebView. + +## `` + +Divers autres préférences (comme `` tags) par défaut sur la rupture ne pas les applications existantes. Les préférences disponibles sont : + +* `useBrowserHistory`(boolean, la valeur par défaut `true` ): la valeur `false` si vous souhaitez utiliser la cale de l'histoire qui a été utilisée pour contourner l'erreur hashtag présent dans Android 3.x avant la correction de l'histoire. (Remarque : ce paramètre sera déconseillé en avril 2013) + +* `loadingDialog`: Afficher une boîte de dialogue chargement native lors du chargement de l'application. Le format de la valeur est *titre, Message* + +* `loadingPageDialog`: Afficher une boîte de dialogue chargement native lors du chargement des sous-pages. Le format de la valeur est *titre, Message* + +* `errorUrl`: Définir la page d'erreur pour votre application. Doit se trouver dans votre projet Android dans`file://android_asset/www/` + +* `backgroundColor`: Définir la couleur d'arrière-plan pour votre application. Prend en charge une valeur hexadécimale de quatre octets, le premier octet représentant la valeur alpha et les trois octets suivants avec les valeurs RGB standard. Par exemple, `0x00000000` est noir. + +* `loadUrlTimeoutValue`: Combien temps Cordova doit attendre avant de lancer une erreur de délai d'attente relatif à l'application. + +* `keepRunning`(boolean, la valeur par défaut `true` ): détermine si Cordova reste en cours d'exécution en arrière-plan. + +* `splashscreen`: Le nom du fichier moins son extension dans le `res/drawable` répertoire. Si vous avez plusieurs actifs, ils sont tous doivent partager ce nom commun dans leur répertoire respectif. + +* `disallowOverscroll`(boolean, la valeur par défaut `false` ): la valeur `true` pour désactiver la lueur lorsqu'un utilisateur fait défiler au-delà du bord de l'affichage Web. + +## `` + +Android prend en charge à l'aide de `` comme analogues aux `` des éléments. \ No newline at end of file http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/992e9151/docs/fr/edge/guide/platforms/android/index.md ---------------------------------------------------------------------- diff --git a/docs/fr/edge/guide/platforms/android/index.md b/docs/fr/edge/guide/platforms/android/index.md new file mode 100644 index 0000000..8f25a7d --- /dev/null +++ b/docs/fr/edge/guide/platforms/android/index.md @@ -0,0 +1,188 @@ +--- + +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. +--- + +# Guide de la plate-forme Android + +Ce guide montre comment configurer votre environnement de développement SDK pour déployer des applications de Cordova pour appareils Android. Voir ci-dessous pour plus d'informations spécifiques à la plateforme : + +* Configuration Android +* Android WebViews +* Plugins Android +* Mise à jour Android +* Outils de ligne de commande Android + +Les outils de ligne de commande ci-dessus se référer aux versions antérieures à la 3.0 de Cordova. Voir l'Interface de ligne de commande pour plus d'informations sur l'interface actuelle. + +## Exigences et soutien + +Consultez la [Configuration requise][1] pour le SDK Android. + + [1]: http://developer.android.com/sdk/index.html + +Cordova supporte Android 2.2, 2.3 et 4.x. En règle générale, les plates-formes sont déconseillés car ils plonger au-dessous de 5 % sur Google [dashboard de distribution][2]. + + [2]: http://developer.android.com/about/dashboards/index.html + + + +Les développeurs doivent utiliser les `cordova` utilitaire conjointement avec le SDK Android. Voir l'Interface de ligne de commande pour plus d'informations comment faire pour l'installer, d'ajouter des projets, puis de créer et de déployer un projet. + +## Installer le SDK + +Installer le SDK Android de [developer.android.com/sdk][3]. Dans le cas contraire vous pouvez être présentées avec un choix de l'endroit où installer le SDK, déplacer le fichier téléchargé `adt-bundle` arbre à chaque fois que vous stockez des outils de développement. + + [3]: http://developer.android.com/sdk/ + +Pour les outils de ligne de commande de Cordova pour travailler, vous devez inclure le SDK `tools` et `platform-tools` des répertoires dans votre environnement de chemin d'accès. Sur Mac, vous pouvez utiliser un éditeur de texte pour créer ou modifier le `~/.bash_profile` fichier, en ajoutant une ligne comme ci-dessous, en fonction d'où le kit de développement logiciel installe : + + export PATH=${PATH}:/Development/adt-bundle/sdk/platform-tools:/Development/adt-bundle/sdk/tools + + +Cela expose les outils SDK dans windows terminales nouvellement ouverts. Dans le cas contraire, exécutez-le pour les rendre disponibles dans la session en cours : + + $ source ~/.bash_profile + + +Pour modifier l'environnement PATH sur Windows 7 : + +* Cliquez sur le menu **Démarrer** dans le coin en bas à gauche du bureau, faites un clic droit sur **ordinateur**, puis cliquez sur **Propriétés**. + +* Cliquez sur **Paramètres système avancés** dans la colonne de gauche. + +* Dans la boîte de dialogue, appuyez sur **Variables d'environnement**. + +* Sélectionnez la variable **PATH** et appuyer sur **modifier**. + +* Le chemin d'accès basé sur lequel vous avez installé le SDK, par exemple, ajoutez ce qui suit : + + ;C:\Development\adt-bundle\sdk\platform-Tools ;C:\Development\adt-bundle\sdk\tools + + +* Enregistrez la valeur et fermez les deux boîtes de dialogue. + +Vous devrez peut-être également activer Java et Open ant une invite de commandes et tapez `java` , puis tapez également `ant` . Ajoutez le chemin d'accès si elle ne pas s'exécuter : + + ; %JAVA_HOME%\bin;%ANT_HOME%\bin + + +## Ouvrez un projet dans le SDK + +Utilisation du `cordova` utilitaire de mettre en place un nouveau projet, tel que décrit dans The Cordova The Command-Line Interface. Par exemple, dans un répertoire de code source : + + $ cordova créer Bonjour com.example.hello « HelloWorld » $ cd $ Bonjour cordova plate-forme ajouter $ android cordova build + + +Une fois créé, voici comment utiliser le SDK pour le modifier : + +* Lancez l'application **Eclipse** . + +* Sélectionnez l'élément de menu **Nouveau projet** . + +* Choisissez **Un projet Android à partir de Code existant** dans la boîte de dialogue, puis appuyez sur **suivant**: ![][4] + +* Accédez à `hello` , ou n'importe quel répertoire vous avez créé pour le projet, puis à la `platforms/android` sous-répertoire. + +* Appuyez sur **Terminer**. + + [4]: img/guide/platforms/android/eclipse_new_project.png + +Une fois que la fenêtre de Eclipse s'ouvre, un rouge **X** peut apparaître pour indiquer les problèmes non résolus. Dans l'affirmative, suivez ces étapes supplémentaires : + +* Faites un clic droit sur le répertoire du projet. + +* Dans la boîte de dialogue **Propriétés** , sélectionnez **Android** du volet de navigation. + +* Pour le projet construire cible, sélectionnez le plus haut niveau de l'API Android que vous avez installé. + +* Cliquez sur **OK**. + +* Sélectionnez **nettoyer** dans le menu **projet** . Cela devrait corriger toutes les erreurs dans le projet. + +## Déployer sur émulateur + +Vous pouvez utiliser le `cordova` utilitaire de mise à exécution d'une application dans l'émulateur, ou vous pouvez l'exécuter dans le SDK. Quoi qu'il en soit, le SDK doit tout d'abord être configuré pour afficher au moins un appareil. Pour ce faire, utilisez l'Android SDK Manager, une application de Java qui s'exécute séparément d'Eclipse. Il y a deux façons pour l'ouvrir : + +* Exécutez `android` sur la ligne de commande. + +* Partir au sein d'Eclipse, appuyez sur cette icône de la barre d'outils : + + ![][5] + + [5]: img/guide/platforms/android/eclipse_android_sdk_button.png + +Une fois ouvert, le Android SDK Manager affiche diverses bibliothèques d'exécution : + +![][6] + + [6]: img/guide/platforms/android/asdk_window.png + +Choisissez **Outils → gérer AVDs** (périphériques virtuels Android), puis cliquez sur n'importe quel élément de **Définitions de périphérique** dans la boîte de dialogue : + +![][7] + + [7]: img/guide/platforms/android/asdk_device.png + +Appuyez sur **Créer AVD**, éventuellement modifier le nom, puis appuyez sur **OK** pour accepter les modifications : + +![][8] + + [8]: img/guide/platforms/android/asdk_newAVD.png + +L'AVD apparaît alors dans la liste **Des périphériques virtuels Android** : + +![][9] + + [9]: 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 : + +![][10] + + [10]: img/guide/platforms/android/asdk_emulator.png + +À ce stade, vous pouvez utiliser le `cordova` utilitaire pour déployer l'application sur l'émulateur de la ligne de commande : + + $ cordova émuler android + + +Si au lieu de cela, vous travaillez au sein d'Eclipse, cliquez droit sur le projet et choisissez **exécute en tant que → Application Android**. Vous devrez peut-être spécifier un AVD si aucun n'est encore ouvert. + +Pour une expérience plus rapide, utiliser une image d'émulateur de processeur Intel : + +* Installer un ou plusieurs `Intel x86 Atom` des Images du système ainsi que le `Intel Hardware Accelerated Execution Manager` , disponible sous **Extras**. + +* Exécutez le programme d'installation d'Intel, qui est disponible dans votre Android SDK à`extras/intel/Hardware_Accelerated_Execution_Manager`. + +* Créer un nouvel AVD avec l'objectif fixé à une image d'Intel. + +* Lorsque vous démarrez l'émulateur, assurez-vous il n'y a aucun message d'erreur indiquant une panne de charger les modules HAX. + +## Déployer sur le périphérique + +Pour repousser un $ $ etAPP directement sur l'appareil, assurez-vous que débogage USB est activé sur votre appareil tel que décrit sur le [Site des développeurs Android][11]et utiliser un câble mini USB à brancher sur votre système. + + [11]: http://developer.android.com/tools/device.html + +Vous pouvez pousser l'app à l'appareil de la ligne de commande : + + cordova $ courir android + + +En alternance au sein d'Eclipse, cliquez droit sur le projet et choisissez **exécute en tant que → Application Android**. \ No newline at end of file