Touchgui/plugins/org.apache.cordova.device/doc/de/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 Dieses Plugin definiert eine globale `device` -Objekt, das des Geräts Hard- und Software beschreibt. Das Objekt im globalen Gültigkeitsbereich ist es zwar nicht verfügbar bis nach dem `deviceready` Ereignis.
    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 ## Eigenschaften
    37 *   device.cordova
    38 *   device.model
    39 *   device.platform
    40 *   device.uuid
    41 *   device.version
    43 ## device.cordova
    45 Rufen Sie die Version von Cordova, die auf dem Gerät ausgeführt.
    47 ### Unterstützte Plattformen
    49 *   Amazon Fire OS
    50 *   Android
    51 *   BlackBerry 10
    52 *   Browser
    53 *   Firefox OS
    54 *   iOS
    55 *   Tizen
    56 *   Windows Phone 7 und 8
    57 *   Windows 8
    59 ## device.model
    61 Die `device.model` gibt den Namen der Modell- oder des Geräts zurück. Der Wert wird vom Gerätehersteller festgelegt und kann zwischen den Versionen des gleichen Produkts unterschiedlich sein.
    63 ### Unterstützte Plattformen
    65 *   Android
    66 *   BlackBerry 10
    67 *   Browser
    68 *   iOS
    69 *   Tizen
    70 *   Windows Phone 7 und 8
    71 *   Windows 8
    73 ### Kurzes Beispiel
    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. Finden Sie unter http://theiphonewiki.com/wiki/index.php?title=Models / / Var-Modell = device.model;
    83 ### Android Eigenarten
    85 *   Ruft den [Produktname][1] anstelle des [Modellnamens][2], das ist oft der Codename für die Produktion. Beispielsweise das Nexus One gibt `Passion` , und Motorola Droid gibt`voles`.
    87  [1]: http://developer.android.com/reference/android/os/Build.html#PRODUCT
    88  [2]: http://developer.android.com/reference/android/os/Build.html#MODEL
    90 ### Tizen Macken
    92 *   Gibt z. B. das Gerätemodell von dem Kreditor zugeordnet,`TIZEN`
    94 ### Windows Phone 7 und 8 Eigenarten
    96 *   Gibt das vom Hersteller angegebenen Gerätemodell zurück. Beispielsweise gibt der Samsung-Fokus`SGH-i917`.
    98 ## device.platform
   100 Name des Betriebssystems des Geräts zu erhalten.
   102     var string = device.platform;
   105 ### Unterstützte Plattformen
   107 *   Android
   108 *   BlackBerry 10
   109 *   Browser4
   110 *   Firefox OS
   111 *   iOS
   112 *   Tizen
   113 *   Windows Phone 7 und 8
   114 *   Windows 8
   116 ### Kurzes Beispiel
   118     // Depending on the device, a few examples are:
   119     //   - "Android"
   120     //   - "BlackBerry 10"
   121     //   - Browser:         returns "MacIntel" on Mac
   122     //                      returns "Win32" on Windows
   123     //   - "iOS"
   124     //   - "WinCE"
   125     //   - "Tizen"
   126     var devicePlatform = device.platform;
   129 ### Windows Phone 7 Macken
   131 Windows Phone 7 Geräte melden die Plattform als`WinCE`.
   133 ### Windows Phone 8 Macken
   135 Windows Phone 8 Geräte melden die Plattform als`Win32NT`.
   137 ## device.uuid
   139 Des Geräts Universally Unique Identifier ([UUID][3] zu erhalten).
   141  [3]: http://en.wikipedia.org/wiki/Universally_Unique_Identifier
   143     var string = device.uuid;
   146 ### Beschreibung
   148 Die Details wie eine UUID generiert wird werden vom Gerätehersteller und beziehen sich auf die Plattform oder das Modell des Geräts.
   150 ### Unterstützte Plattformen
   152 *   Android
   153 *   BlackBerry 10
   154 *   iOS
   155 *   Tizen
   156 *   Windows Phone 7 und 8
   157 *   Windows 8
   159 ### Kurzes Beispiel
   161     / / Android: wird eine zufällige 64-Bit-Ganzzahl (als Zeichenfolge, wieder!) / / die ganze Zahl wird beim ersten Start des Geräts erzeugt / / / / BlackBerry: gibt die PIN-Nummer des Gerätes / / Dies ist eine neunstellige eindeutige Ganzzahl (als String, obwohl!) / / / / iPhone: (paraphrasiert aus der Dokumentation zur UIDevice-Klasse) / / liefert eine Reihe von Hash-Werte, die aus mehreren Hardware erstellt identifiziert.
   162     / / Es ist gewährleistet, dass für jedes Gerät eindeutig sein und kann nicht gebunden werden / / an den Benutzer weitergeleitet.
   163     / / Windows Phone 7: gibt einen Hash des Gerät + aktueller Benutzer, / / wenn der Benutzer nicht definiert ist, eine Guid generiert und wird weiter bestehen, bis die app deinstalliert wird / / Tizen: gibt das Gerät IMEI (International Mobile Equipment Identity oder IMEI ist eine Zahl / / einzigartig für jedes GSM- und UMTS-Handy.
   164     var deviceID = device.uuid;
   167 ### iOS Quirk
   169 Die `uuid` auf iOS ist nicht eindeutig zu einem Gerät, aber für jede Anwendung, für jede Installation variiert. Es ändert sich, wenn Sie löschen und neu die app installieren, und möglicherweise auch beim iOS zu aktualisieren, oder auch ein Upgrade möglich die app pro Version (scheinbaren in iOS 5.1). Die `uuid` ist kein zuverlässiger Wert.
   171 ### Windows Phone 7 und 8 Eigenarten
   173 Die `uuid` für Windows Phone 7 die Berechtigung erfordert `ID_CAP_IDENTITY_DEVICE` . Microsoft wird diese Eigenschaft wahrscheinlich bald abzuschaffen. Wenn die Funktion nicht verfügbar ist, generiert die Anwendung eine persistente Guid, die für die Dauer der Installation der Anwendung auf dem Gerät gewährleistet ist.
   175 ## device.version
   177 Version des Betriebssystems zu erhalten.
   179     var string = device.version;
   182 ### Unterstützte Plattformen
   184 *   Android 2.1 +
   185 *   BlackBerry 10
   186 *   Browser
   187 *   iOS
   188 *   Tizen
   189 *   Windows Phone 7 und 8
   190 *   Windows 8
   192 ### Kurzes Beispiel
   194     // Android:    Froyo OS would return "2.2"
   195     //             Eclair OS would return "2.1", "2.0.1", or "2.0"
   196     //             Version can also return update level "2.1-update1"
   197     //
   198     // BlackBerry: Torch 9800 using OS 6.0 would return "6.0.0.600"
   199     //
   200     // Browser:    Returns version number for the browser
   201     //
   202     // iPhone:     iOS 3.2 returns "3.2"
   203     //
   204     // Windows Phone 7: returns current OS version number, ex. on Mango returns 7.10.7720
   205     // Tizen: returns "TIZEN_20120425_2"
   206     var deviceVersion = device.version;

mercurial