Touchgui/plugins/org.apache.cordova.device/doc/ru/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 Этот плагин определяет глобальный объект `device`, который описывает оборудование и программное обеспечение устройства. Несмотря на то что объект в глобальной области видимости, он не доступен до того момента пока не произойдет событие `deviceready`.
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 ## Установка
michael@0 31
michael@0 32 cordova plugin add org.apache.cordova.device
michael@0 33
michael@0 34
michael@0 35 ## Параметры
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 Возвращает версию Cordova, работающую на устройстве.
michael@0 46
michael@0 47 ### Поддерживаемые платформы
michael@0 48
michael@0 49 * Amazon Fire OS
michael@0 50 * Android
michael@0 51 * BlackBerry 10
michael@0 52 * Обозреватель
michael@0 53 * Firefox OS
michael@0 54 * iOS
michael@0 55 * Tizen
michael@0 56 * Windows Phone 7 и 8
michael@0 57 * Windows 8
michael@0 58
michael@0 59 ## device.model
michael@0 60
michael@0 61 Свойство `device.model` возвращает имя устройства модели или продукта. Значение устанавливается производителем устройства и могут отличаться в разных версиях одного и того же продукта.
michael@0 62
michael@0 63 ### Поддерживаемые платформы
michael@0 64
michael@0 65 * Android
michael@0 66 * BlackBerry 10
michael@0 67 * Обозреватель
michael@0 68 * iOS
michael@0 69 * Tizen
michael@0 70 * Windows Phone 7 и 8
michael@0 71 * Windows 8
michael@0 72
michael@0 73 ### Краткий пример
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. See 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 ### Особенности Android
michael@0 86
michael@0 87 * Возвращает [имя продукта][1] , а не [имя модели][2], которое часто является производственным кодом. Например, Nexus One из них возвращает `Passion` , и Motorola Droid возвращает `voles`.
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 ### Особенности Tizen
michael@0 93
michael@0 94 * Возвращает модель устройства, назначенного вендором, например,`TIZEN`
michael@0 95
michael@0 96 ### Особенности Windows Phone 7 и 8
michael@0 97
michael@0 98 * Возвращает модель устройства, указанной заводом-изготовителем. Например Samsung Focus возвращает `SGH-i917`.
michael@0 99
michael@0 100 ## device.platform
michael@0 101
michael@0 102 Получите имя операционной системы устройства.
michael@0 103
michael@0 104 var string = device.platform;
michael@0 105
michael@0 106
michael@0 107 ### Поддерживаемые платформы
michael@0 108
michael@0 109 * Android
michael@0 110 * BlackBerry 10
michael@0 111 * Браузером4
michael@0 112 * Firefox OS
michael@0 113 * iOS
michael@0 114 * Tizen
michael@0 115 * Windows Phone 7 и 8
michael@0 116 * Windows 8
michael@0 117
michael@0 118 ### Краткий пример
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
michael@0 132
michael@0 133 Windows Phone 7 устройства сообщают платформу как `WinCE`.
michael@0 134
michael@0 135 ### Особенности Windows Phone 8
michael@0 136
michael@0 137 Устройства Windows Phone 8 сообщают платформу как `Win32NT`.
michael@0 138
michael@0 139 ## device.uuid
michael@0 140
michael@0 141 Возвращает универсальный уникального идентификатора ([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 ### Описание
michael@0 149
michael@0 150 Подробная информация о том как UUID генерируется, определяются изготовителем устройства и являются специфическими для платформы или модели устройства.
michael@0 151
michael@0 152 ### Поддерживаемые платформы
michael@0 153
michael@0 154 * Android
michael@0 155 * BlackBerry 10
michael@0 156 * iOS
michael@0 157 * Tizen
michael@0 158 * Windows Phone 7 и 8
michael@0 159 * Windows 8
michael@0 160
michael@0 161 ### Краткий пример
michael@0 162
michael@0 163 // Android: Возвращает случайное 64-разрядное целое число (в виде строки, опять!)
michael@0 164 // целое число генерируется при первой загрузке устройства
michael@0 165 //
michael@0 166 // BlackBerry: Возвращает номер PIN устройства
michael@0 167 // это 9 значный уникальный целочисленный (как строка, хотя!)
michael@0 168 //
michael@0 169 // iPhone: (Перефразировано из документации класса UIDevice)
michael@0 170 // возвращает строку хэш-значения, созданные из нескольких аппаратных определяет.
michael@0 171 // Это значение гарантированно является уникальным для каждого устройства и не может быть привязано
michael@0 172 // к учетной записи пользователя.
michael@0 173 // Windows Phone 7: Возвращает хэш устройство + текущего пользователя,
michael@0 174 // если пользователь не определен, формируется guid который и будет сохраняться до тех пор, пока приложение не удалиться
michael@0 175 // Tizen: возвращает IMEI устройства (Международный идентификатор мобильного оборудования или IMEI это число
michael@0 176 // уникальное для каждого мобильного телефона GSM и UMTS.
michael@0 177 var deviceID = device.uuid;
michael@0 178
michael@0 179
michael@0 180 ### Особенности iOS
michael@0 181
michael@0 182 На iOS `uuid` не является уникальным для устройства, но варьируется для каждого приложения, и для каждой установки. Значение меняется, если удалить и повторно установить приложение, и возможно также когда вы обновите iOS, или даже обновить приложение до следующей версии (очевидно в iOS 5.1). Значение `uuid` не является надежным.
michael@0 183
michael@0 184 ### Особенности Windows Phone 7 и 8
michael@0 185
michael@0 186 Для Windows Phone 7 `uuid` требует разрешения `ID_CAP_IDENTITY_DEVICE` . Microsoft скорее всего скоро сделает это свойство устаревшим. Если возможность недоступна, приложение создает постоянные guid, который сохраняется на все время установки приложения на устройстве.
michael@0 187
michael@0 188 ## device.version
michael@0 189
michael@0 190 Возвращает версию операционной системы.
michael@0 191
michael@0 192 var string = device.version;
michael@0 193
michael@0 194
michael@0 195 ### Поддерживаемые платформы
michael@0 196
michael@0 197 * Android 2.1 +
michael@0 198 * BlackBerry 10
michael@0 199 * Обозреватель
michael@0 200 * iOS
michael@0 201 * Tizen
michael@0 202 * Windows Phone 7 и 8
michael@0 203 * Windows 8
michael@0 204
michael@0 205 ### Краткий пример
michael@0 206
michael@0 207 // Android: Froyo OS would return "2.2"
michael@0 208 // Eclair OS would return "2.1", "2.0.1", or "2.0"
michael@0 209 // Version can also return update level "2.1-update1"
michael@0 210 //
michael@0 211 // BlackBerry: Torch 9800 using OS 6.0 would return "6.0.0.600"
michael@0 212 //
michael@0 213 // Browser: Returns version number for the browser
michael@0 214 //
michael@0 215 // iPhone: iOS 3.2 returns "3.2"
michael@0 216 //
michael@0 217 // Windows Phone 7: returns current OS version number, ex. on Mango returns 7.10.7720
michael@0 218 // Tizen: returns "TIZEN_20120425_2"
michael@0 219 var deviceVersion = device.version;

mercurial