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.

     1 <!---
     2     Licensed to the Apache Software Foundation (ASF) under one
     3     or more contributor license agreements.  See the NOTICE file
     4     distributed with this work for additional information
     5     regarding copyright ownership.  The ASF licenses this file
     6     to you under the Apache License, Version 2.0 (the
     7     "License"); you may not use this file except in compliance
     8     with the License.  You may obtain a copy of the License at
    10       http://www.apache.org/licenses/LICENSE-2.0
    12     Unless required by applicable law or agreed to in writing,
    13     software distributed under the License is distributed on an
    14     "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
    15     KIND, either express or implied.  See the License for the
    16     specific language governing permissions and limitations
    17     under the License.
    18 -->
    20 # org.apache.cordova.device
    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.
    24     document.addEventListener("deviceready", onDeviceReady, false);
    25     function onDeviceReady() {
    26         console.log(device.cordova);
    27     }
    30 ## Installation
    32     cordova plugin add org.apache.cordova.device
    35 ## Propriétés
    37 *   device.cordova
    38 *   device.model
    39 *   device.platform
    40 *   device.uuid
    41 *   device.version
    43 ## device.cordova
    45 Retourne la version de Cordova en cours d'exécution sur l'appareil.
    47 ### Plates-formes prises en charge
    49 *   Amazon Fire OS
    50 *   Android
    51 *   BlackBerry 10
    52 *   Navigateur
    53 *   Firefox OS
    54 *   iOS
    55 *   Paciarelli
    56 *   Windows Phone 7 et 8
    57 *   Windows 8
    59 ## device.model
    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.
    63 ### Plates-formes prises en charge
    65 *   Android
    66 *   BlackBerry 10
    67 *   Navigateur
    68 *   iOS
    69 *   Paciarelli
    70 *   Windows Phone 7 et 8
    71 *   Windows 8
    73 ### Petit exemple
    75     // Android:    Nexus One       returns "Passion" (Nexus One code name)
    76     //             Motorola Droid  returns "voles"
    77     // BlackBerry: Torch 9800      returns "9800"
    78     // Browser:    Google Chrome   returns "Chrome"
    79     //             Safari          returns "Safari"
    80     // iOS:     for the iPad Mini, returns iPad2,5; iPhone 5 is iPhone 5,1. Voir http://theiphonewiki.com/wiki/index.php?title=Models
    81     //
    82     var model = device.model;
    85 ### Quirks Android
    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.
    89  [1]: http://developer.android.com/reference/android/os/Build.html#PRODUCT
    90  [2]: http://developer.android.com/reference/android/os/Build.html#MODEL
    92 ### Bizarreries de paciarelli
    94 *   Retourne le modèle du dispositif, assigné par le vendeur, par exemple `TIZEN`
    96 ### Windows Phone 7 et 8 Quirks
    98 *   Retourne le modèle de l'appareil spécifié par le fabricant. Par exemple `SGH-i917` pour le Samsung Focus.
   100 ## device.platform
   102 Obtenir le nom de système d'exploitation de l'appareil.
   104     var string = device.platform;
   107 ### Plates-formes prises en charge
   109 *   Android
   110 *   BlackBerry 10
   111 *   Browser4
   112 *   Firefox OS
   113 *   iOS
   114 *   Paciarelli
   115 *   Windows Phone 7 et 8
   116 *   Windows 8
   118 ### Petit exemple
   120     // Depending on the device, a few examples are:
   121     //   - "Android"
   122     //   - "BlackBerry 10"
   123     //   - Browser:         returns "MacIntel" on Mac
   124     //                      returns "Win32" on Windows
   125     //   - "iOS"
   126     //   - "WinCE"
   127     //   - "Tizen"
   128     var devicePlatform = device.platform;
   131 ### Windows Phone 7 Quirks
   133 Appareils Windows Phone 7 rapport de la plate-forme comme`WinCE`.
   135 ### Notes au sujet de Windows Phone 8
   137 Appareils Windows Phone 8 rapport de la plate-forme comme`Win32NT`.
   139 ## device.uuid
   141 Obtenir Universally Unique Identifier de l'appareil ([UUID][3]).
   143  [3]: http://en.wikipedia.org/wiki/Universally_Unique_Identifier
   145     var string = device.uuid;
   148 ### Description
   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.
   152 ### Plates-formes prises en charge
   154 *   Android
   155 *   BlackBerry 10
   156 *   iOS
   157 *   Paciarelli
   158 *   Windows Phone 7 et 8
   159 *   Windows 8
   161 ### Petit exemple
   163     // Android : retourne un nombre entier 64-bit aléatoire (sous la forme d'une chaîne de caractères, encore !)
   164     // Ce nombre entier est généré lors du premier démarrage de l'appareil
   165     //
   166     // BlackBerry : retourne le numéro PIN de l'appareil
   167     // Il s'agit d'un nombre entier unique à neuf chiffres (sous la forme d'une chaîne de caractères cependant !)
   168     //
   169     // iPhone : (copié depuis la documentation de la classe UIDevice)
   170     // Retourne une chaîne de caractères générée à partir de plusieurs caractéristiques matérielles.
   171     / / Il est garanti pour être unique pour chaque appareil et ne peut pas être lié / / pour le compte d'utilisateur.
   172     // Windows Phone 7 : retourne un hashage généré à partir de appareil+utilisateur actuel,
   173     // si aucun utilisateur n'est défini, un guid est généré persistera jusqu'à ce que l'application soit désinstallée
   174     // Tizen : retourne le numéro IMEI (International Mobile Equipment Identity) de l'appareil, ce numéro est
   175     // unique pour chaque téléphone GSM et UMTS.
   176     var deviceID = device.uuid;
   179 ### Spécificités iOS
   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.
   183 ### Windows Phone 7 et 8 Quirks
   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.
   187 ## device.version
   189 Téléchargez la version de système d'exploitation.
   191     var string = device.version;
   194 ### Plates-formes prises en charge
   196 *   Android 2.1+
   197 *   BlackBerry 10
   198 *   Navigateur
   199 *   iOS
   200 *   Paciarelli
   201 *   Windows Phone 7 et 8
   202 *   Windows 8
   204 ### Petit exemple
   206     // Android:    Froyo OS would return "2.2"
   207     //             Eclair OS would return "2.1", "2.0.1", or "2.0"
   208     //             Version can also return update level "2.1-update1"
   209     //
   210     // BlackBerry: Torch 9800 using OS 6.0 would return "6.0.0.600"
   211     //
   212     // Browser:    Returns version number for the browser
   213     //
   214     // iPhone:     iOS 3.2 returns "3.2"
   215     //
   216     // Windows Phone 7: returns current OS version number, ex. on Mango returns 7.10.7720
   217     // Tizen: returns "TIZEN_20120425_2"
   218     var deviceVersion = device.version;

mercurial