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.

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 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.
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 ## Eigenschaften
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 Rufen Sie die Version von Cordova, die auf dem Gerät ausgeführt.
michael@0 46
michael@0 47 ### Unterstützte Plattformen
michael@0 48
michael@0 49 * Amazon Fire OS
michael@0 50 * Android
michael@0 51 * BlackBerry 10
michael@0 52 * Browser
michael@0 53 * Firefox OS
michael@0 54 * iOS
michael@0 55 * Tizen
michael@0 56 * Windows Phone 7 und 8
michael@0 57 * Windows 8
michael@0 58
michael@0 59 ## device.model
michael@0 60
michael@0 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.
michael@0 62
michael@0 63 ### Unterstützte Plattformen
michael@0 64
michael@0 65 * Android
michael@0 66 * BlackBerry 10
michael@0 67 * Browser
michael@0 68 * iOS
michael@0 69 * Tizen
michael@0 70 * Windows Phone 7 und 8
michael@0 71 * Windows 8
michael@0 72
michael@0 73 ### Kurzes Beispiel
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. Finden Sie unter http://theiphonewiki.com/wiki/index.php?title=Models / / Var-Modell = device.model;
michael@0 81
michael@0 82
michael@0 83 ### Android Eigenarten
michael@0 84
michael@0 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`.
michael@0 86
michael@0 87 [1]: http://developer.android.com/reference/android/os/Build.html#PRODUCT
michael@0 88 [2]: http://developer.android.com/reference/android/os/Build.html#MODEL
michael@0 89
michael@0 90 ### Tizen Macken
michael@0 91
michael@0 92 * Gibt z. B. das Gerätemodell von dem Kreditor zugeordnet,`TIZEN`
michael@0 93
michael@0 94 ### Windows Phone 7 und 8 Eigenarten
michael@0 95
michael@0 96 * Gibt das vom Hersteller angegebenen Gerätemodell zurück. Beispielsweise gibt der Samsung-Fokus`SGH-i917`.
michael@0 97
michael@0 98 ## device.platform
michael@0 99
michael@0 100 Name des Betriebssystems des Geräts zu erhalten.
michael@0 101
michael@0 102 var string = device.platform;
michael@0 103
michael@0 104
michael@0 105 ### Unterstützte Plattformen
michael@0 106
michael@0 107 * Android
michael@0 108 * BlackBerry 10
michael@0 109 * Browser4
michael@0 110 * Firefox OS
michael@0 111 * iOS
michael@0 112 * Tizen
michael@0 113 * Windows Phone 7 und 8
michael@0 114 * Windows 8
michael@0 115
michael@0 116 ### Kurzes Beispiel
michael@0 117
michael@0 118 // Depending on the device, a few examples are:
michael@0 119 // - "Android"
michael@0 120 // - "BlackBerry 10"
michael@0 121 // - Browser: returns "MacIntel" on Mac
michael@0 122 // returns "Win32" on Windows
michael@0 123 // - "iOS"
michael@0 124 // - "WinCE"
michael@0 125 // - "Tizen"
michael@0 126 var devicePlatform = device.platform;
michael@0 127
michael@0 128
michael@0 129 ### Windows Phone 7 Macken
michael@0 130
michael@0 131 Windows Phone 7 Geräte melden die Plattform als`WinCE`.
michael@0 132
michael@0 133 ### Windows Phone 8 Macken
michael@0 134
michael@0 135 Windows Phone 8 Geräte melden die Plattform als`Win32NT`.
michael@0 136
michael@0 137 ## device.uuid
michael@0 138
michael@0 139 Des Geräts Universally Unique Identifier ([UUID][3] zu erhalten).
michael@0 140
michael@0 141 [3]: http://en.wikipedia.org/wiki/Universally_Unique_Identifier
michael@0 142
michael@0 143 var string = device.uuid;
michael@0 144
michael@0 145
michael@0 146 ### Beschreibung
michael@0 147
michael@0 148 Die Details wie eine UUID generiert wird werden vom Gerätehersteller und beziehen sich auf die Plattform oder das Modell des Geräts.
michael@0 149
michael@0 150 ### Unterstützte Plattformen
michael@0 151
michael@0 152 * Android
michael@0 153 * BlackBerry 10
michael@0 154 * iOS
michael@0 155 * Tizen
michael@0 156 * Windows Phone 7 und 8
michael@0 157 * Windows 8
michael@0 158
michael@0 159 ### Kurzes Beispiel
michael@0 160
michael@0 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.
michael@0 162 / / Es ist gewährleistet, dass für jedes Gerät eindeutig sein und kann nicht gebunden werden / / an den Benutzer weitergeleitet.
michael@0 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.
michael@0 164 var deviceID = device.uuid;
michael@0 165
michael@0 166
michael@0 167 ### iOS Quirk
michael@0 168
michael@0 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.
michael@0 170
michael@0 171 ### Windows Phone 7 und 8 Eigenarten
michael@0 172
michael@0 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.
michael@0 174
michael@0 175 ## device.version
michael@0 176
michael@0 177 Version des Betriebssystems zu erhalten.
michael@0 178
michael@0 179 var string = device.version;
michael@0 180
michael@0 181
michael@0 182 ### Unterstützte Plattformen
michael@0 183
michael@0 184 * Android 2.1 +
michael@0 185 * BlackBerry 10
michael@0 186 * Browser
michael@0 187 * iOS
michael@0 188 * Tizen
michael@0 189 * Windows Phone 7 und 8
michael@0 190 * Windows 8
michael@0 191
michael@0 192 ### Kurzes Beispiel
michael@0 193
michael@0 194 // Android: Froyo OS would return "2.2"
michael@0 195 // Eclair OS would return "2.1", "2.0.1", or "2.0"
michael@0 196 // Version can also return update level "2.1-update1"
michael@0 197 //
michael@0 198 // BlackBerry: Torch 9800 using OS 6.0 would return "6.0.0.600"
michael@0 199 //
michael@0 200 // Browser: Returns version number for the browser
michael@0 201 //
michael@0 202 // iPhone: iOS 3.2 returns "3.2"
michael@0 203 //
michael@0 204 // Windows Phone 7: returns current OS version number, ex. on Mango returns 7.10.7720
michael@0 205 // Tizen: returns "TIZEN_20120425_2"
michael@0 206 var deviceVersion = device.version;

mercurial