Thu, 04 Jun 2015 14:50:33 +0200
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;