Touchgui/plugins/org.apache.cordova.device/doc/fr/index.md

Thu, 04 Jun 2015 14:50:33 +0200

author
Michael Schloh von Bennewitz <michael@schloh.com>
date
Thu, 04 Jun 2015 14:50:33 +0200
changeset 0
e8ccd40d0ef6
permissions
-rw-r--r--

Genesis of lecture sources for Droidcon Berlin 2015 in Postbahnhof.

michael@0 1 <!---
michael@0 2 Licensed to the Apache Software Foundation (ASF) under one
michael@0 3 or more contributor license agreements. See the NOTICE file
michael@0 4 distributed with this work for additional information
michael@0 5 regarding copyright ownership. The ASF licenses this file
michael@0 6 to you under the Apache License, Version 2.0 (the
michael@0 7 "License"); you may not use this file except in compliance
michael@0 8 with the License. You may obtain a copy of the License at
michael@0 9
michael@0 10 http://www.apache.org/licenses/LICENSE-2.0
michael@0 11
michael@0 12 Unless required by applicable law or agreed to in writing,
michael@0 13 software distributed under the License is distributed on an
michael@0 14 "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
michael@0 15 KIND, either express or implied. See the License for the
michael@0 16 specific language governing permissions and limitations
michael@0 17 under the License.
michael@0 18 -->
michael@0 19
michael@0 20 # org.apache.cordova.device
michael@0 21
michael@0 22 Ce plugin définit un global `device` objet qui décrit le matériel et les logiciels de l'appareil. Bien que l'objet est dans la portée globale, il n'est pas disponible jusqu'après la `deviceready` événement.
michael@0 23
michael@0 24 document.addEventListener("deviceready", onDeviceReady, false);
michael@0 25 function onDeviceReady() {
michael@0 26 console.log(device.cordova);
michael@0 27 }
michael@0 28
michael@0 29
michael@0 30 ## Installation
michael@0 31
michael@0 32 cordova plugin add org.apache.cordova.device
michael@0 33
michael@0 34
michael@0 35 ## Propriétés
michael@0 36
michael@0 37 * device.cordova
michael@0 38 * device.model
michael@0 39 * device.platform
michael@0 40 * device.uuid
michael@0 41 * device.version
michael@0 42
michael@0 43 ## device.cordova
michael@0 44
michael@0 45 Retourne la version de Cordova en cours d'exécution sur l'appareil.
michael@0 46
michael@0 47 ### Plates-formes prises en charge
michael@0 48
michael@0 49 * Amazon Fire OS
michael@0 50 * Android
michael@0 51 * BlackBerry 10
michael@0 52 * Navigateur
michael@0 53 * Firefox OS
michael@0 54 * iOS
michael@0 55 * Paciarelli
michael@0 56 * Windows Phone 7 et 8
michael@0 57 * Windows 8
michael@0 58
michael@0 59 ## device.model
michael@0 60
michael@0 61 L'objet `device.model` retourne le nom du modèle de l'appareil/produit. Cette valeur est définie par le fabricant du périphérique et peut varier entre les différentes versions d'un même produit.
michael@0 62
michael@0 63 ### Plates-formes prises en charge
michael@0 64
michael@0 65 * Android
michael@0 66 * BlackBerry 10
michael@0 67 * Navigateur
michael@0 68 * iOS
michael@0 69 * Paciarelli
michael@0 70 * Windows Phone 7 et 8
michael@0 71 * Windows 8
michael@0 72
michael@0 73 ### Petit exemple
michael@0 74
michael@0 75 // Android: Nexus One returns "Passion" (Nexus One code name)
michael@0 76 // Motorola Droid returns "voles"
michael@0 77 // BlackBerry: Torch 9800 returns "9800"
michael@0 78 // Browser: Google Chrome returns "Chrome"
michael@0 79 // Safari returns "Safari"
michael@0 80 // iOS: for the iPad Mini, returns iPad2,5; iPhone 5 is iPhone 5,1. Voir http://theiphonewiki.com/wiki/index.php?title=Models
michael@0 81 //
michael@0 82 var model = device.model;
michael@0 83
michael@0 84
michael@0 85 ### Quirks Android
michael@0 86
michael@0 87 * Retourne le [nom du produit][1] au lieu du [nom du modèle][2], ce qui équivaut souvent au nom de code de production. Par exemple, `Passion` pour le Nexus One et `voles` pour le Motorola Droid.
michael@0 88
michael@0 89 [1]: http://developer.android.com/reference/android/os/Build.html#PRODUCT
michael@0 90 [2]: http://developer.android.com/reference/android/os/Build.html#MODEL
michael@0 91
michael@0 92 ### Bizarreries de paciarelli
michael@0 93
michael@0 94 * Retourne le modèle du dispositif, assigné par le vendeur, par exemple `TIZEN`
michael@0 95
michael@0 96 ### Windows Phone 7 et 8 Quirks
michael@0 97
michael@0 98 * Retourne le modèle de l'appareil spécifié par le fabricant. Par exemple `SGH-i917` pour le Samsung Focus.
michael@0 99
michael@0 100 ## device.platform
michael@0 101
michael@0 102 Obtenir le nom de système d'exploitation de l'appareil.
michael@0 103
michael@0 104 var string = device.platform;
michael@0 105
michael@0 106
michael@0 107 ### Plates-formes prises en charge
michael@0 108
michael@0 109 * Android
michael@0 110 * BlackBerry 10
michael@0 111 * Browser4
michael@0 112 * Firefox OS
michael@0 113 * iOS
michael@0 114 * Paciarelli
michael@0 115 * Windows Phone 7 et 8
michael@0 116 * Windows 8
michael@0 117
michael@0 118 ### Petit exemple
michael@0 119
michael@0 120 // Depending on the device, a few examples are:
michael@0 121 // - "Android"
michael@0 122 // - "BlackBerry 10"
michael@0 123 // - Browser: returns "MacIntel" on Mac
michael@0 124 // returns "Win32" on Windows
michael@0 125 // - "iOS"
michael@0 126 // - "WinCE"
michael@0 127 // - "Tizen"
michael@0 128 var devicePlatform = device.platform;
michael@0 129
michael@0 130
michael@0 131 ### Windows Phone 7 Quirks
michael@0 132
michael@0 133 Appareils Windows Phone 7 rapport de la plate-forme comme`WinCE`.
michael@0 134
michael@0 135 ### Notes au sujet de Windows Phone 8
michael@0 136
michael@0 137 Appareils Windows Phone 8 rapport de la plate-forme comme`Win32NT`.
michael@0 138
michael@0 139 ## device.uuid
michael@0 140
michael@0 141 Obtenir Universally Unique Identifier de l'appareil ([UUID][3]).
michael@0 142
michael@0 143 [3]: http://en.wikipedia.org/wiki/Universally_Unique_Identifier
michael@0 144
michael@0 145 var string = device.uuid;
michael@0 146
michael@0 147
michael@0 148 ### Description
michael@0 149
michael@0 150 Les détails de comment un UUID généré sont déterminées par le fabricant du périphérique et sont spécifiques à la plate-forme ou le modèle de l'appareil.
michael@0 151
michael@0 152 ### Plates-formes prises en charge
michael@0 153
michael@0 154 * Android
michael@0 155 * BlackBerry 10
michael@0 156 * iOS
michael@0 157 * Paciarelli
michael@0 158 * Windows Phone 7 et 8
michael@0 159 * Windows 8
michael@0 160
michael@0 161 ### Petit exemple
michael@0 162
michael@0 163 // Android : retourne un nombre entier 64-bit aléatoire (sous la forme d'une chaîne de caractères, encore !)
michael@0 164 // Ce nombre entier est généré lors du premier démarrage de l'appareil
michael@0 165 //
michael@0 166 // BlackBerry : retourne le numéro PIN de l'appareil
michael@0 167 // Il s'agit d'un nombre entier unique à neuf chiffres (sous la forme d'une chaîne de caractères cependant !)
michael@0 168 //
michael@0 169 // iPhone : (copié depuis la documentation de la classe UIDevice)
michael@0 170 // Retourne une chaîne de caractères générée à partir de plusieurs caractéristiques matérielles.
michael@0 171 / / Il est garanti pour être unique pour chaque appareil et ne peut pas être lié / / pour le compte d'utilisateur.
michael@0 172 // Windows Phone 7 : retourne un hashage généré à partir de appareil+utilisateur actuel,
michael@0 173 // si aucun utilisateur n'est défini, un guid est généré persistera jusqu'à ce que l'application soit désinstallée
michael@0 174 // Tizen : retourne le numéro IMEI (International Mobile Equipment Identity) de l'appareil, ce numéro est
michael@0 175 // unique pour chaque téléphone GSM et UMTS.
michael@0 176 var deviceID = device.uuid;
michael@0 177
michael@0 178
michael@0 179 ### Spécificités iOS
michael@0 180
michael@0 181 Le `uuid` sur iOS n'est pas propre à un périphérique, mais varie pour chaque application, pour chaque installation. Elle change si vous supprimez, puis réinstallez l'application, et éventuellement aussi quand vous mettre à jour d'iOS, ou même mettre à jour le soft par version (apparent dans iOS 5.1). Le `uuid` n'est pas une valeur fiable.
michael@0 182
michael@0 183 ### Windows Phone 7 et 8 Quirks
michael@0 184
michael@0 185 Le `uuid` pour Windows Phone 7 requiert l'autorisation `ID_CAP_IDENTITY_DEVICE` . Microsoft va probablement bientôt obsolète de cette propriété. Si la capacité n'est pas disponible, l'application génère un guid persistant qui est maintenu pendant toute la durée de l'installation de l'application sur le périphérique.
michael@0 186
michael@0 187 ## device.version
michael@0 188
michael@0 189 Téléchargez la version de système d'exploitation.
michael@0 190
michael@0 191 var string = device.version;
michael@0 192
michael@0 193
michael@0 194 ### Plates-formes prises en charge
michael@0 195
michael@0 196 * Android 2.1+
michael@0 197 * BlackBerry 10
michael@0 198 * Navigateur
michael@0 199 * iOS
michael@0 200 * Paciarelli
michael@0 201 * Windows Phone 7 et 8
michael@0 202 * Windows 8
michael@0 203
michael@0 204 ### Petit exemple
michael@0 205
michael@0 206 // Android: Froyo OS would return "2.2"
michael@0 207 // Eclair OS would return "2.1", "2.0.1", or "2.0"
michael@0 208 // Version can also return update level "2.1-update1"
michael@0 209 //
michael@0 210 // BlackBerry: Torch 9800 using OS 6.0 would return "6.0.0.600"
michael@0 211 //
michael@0 212 // Browser: Returns version number for the browser
michael@0 213 //
michael@0 214 // iPhone: iOS 3.2 returns "3.2"
michael@0 215 //
michael@0 216 // Windows Phone 7: returns current OS version number, ex. on Mango returns 7.10.7720
michael@0 217 // Tizen: returns "TIZEN_20120425_2"
michael@0 218 var deviceVersion = device.version;

mercurial