initial checkin from subversion
This commit is contained in:
Tretter
80
plugins/org.apache.cordova.device/docs/device.cordova.md
Normal file
80
plugins/org.apache.cordova.device/docs/device.cordova.md
Normal file
@@ -0,0 +1,80 @@
|
||||
---
|
||||
license: Licensed to the Apache Software Foundation (ASF) under one
|
||||
or more contributor license agreements. See the NOTICE file
|
||||
distributed with this work for additional information
|
||||
regarding copyright ownership. The ASF licenses this file
|
||||
to you under the Apache License, Version 2.0 (the
|
||||
"License"); you may not use this file except in compliance
|
||||
with the License. You may obtain a copy of the License at
|
||||
|
||||
http://www.apache.org/licenses/LICENSE-2.0
|
||||
|
||||
Unless required by applicable law or agreed to in writing,
|
||||
software distributed under the License is distributed on an
|
||||
"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
|
||||
KIND, either express or implied. See the License for the
|
||||
specific language governing permissions and limitations
|
||||
under the License.
|
||||
---
|
||||
|
||||
device.cordova
|
||||
===============
|
||||
|
||||
Get the version of Cordova running on the device.
|
||||
|
||||
var string = device.cordova;
|
||||
|
||||
Description
|
||||
-----------
|
||||
|
||||
`device.cordova` returns the version of Cordova running on the device.
|
||||
|
||||
Supported Platforms
|
||||
-------------------
|
||||
|
||||
- Android
|
||||
- BlackBerry WebWorks (OS 5.0 and higher)
|
||||
- iOS
|
||||
- Windows Phone 7 and 8
|
||||
- Bada 1.2 & 2.x
|
||||
- Tizen
|
||||
- Windows 8
|
||||
|
||||
Quick Example
|
||||
-------------
|
||||
|
||||
var name = device.cordova;
|
||||
|
||||
Full Example
|
||||
------------
|
||||
|
||||
<!DOCTYPE html>
|
||||
<html>
|
||||
<head>
|
||||
<title>Device Properties Example</title>
|
||||
|
||||
<script type="text/javascript" charset="utf-8" src="cordova-x.x.x.js"></script>
|
||||
<script type="text/javascript" charset="utf-8">
|
||||
|
||||
// Wait for device API libraries to load
|
||||
//
|
||||
document.addEventListener("deviceready", onDeviceReady, false);
|
||||
|
||||
// device APIs are available
|
||||
//
|
||||
function onDeviceReady() {
|
||||
var element = document.getElementById('deviceProperties');
|
||||
element.innerHTML = 'Device Name: ' + device.name + '<br />' +
|
||||
'Device Cordova: ' + device.cordova + '<br />' +
|
||||
'Device Platform: ' + device.platform + '<br />' +
|
||||
'Device UUID: ' + device.uuid + '<br />' +
|
||||
'Device Version: ' + device.version + '<br />';
|
||||
}
|
||||
|
||||
</script>
|
||||
</head>
|
||||
<body>
|
||||
<p id="deviceProperties">Loading device properties...</p>
|
||||
</body>
|
||||
</html>
|
||||
|
||||
104
plugins/org.apache.cordova.device/docs/device.md
Normal file
104
plugins/org.apache.cordova.device/docs/device.md
Normal file
@@ -0,0 +1,104 @@
|
||||
---
|
||||
license: Licensed to the Apache Software Foundation (ASF) under one
|
||||
or more contributor license agreements. See the NOTICE file
|
||||
distributed with this work for additional information
|
||||
regarding copyright ownership. The ASF licenses this file
|
||||
to you under the Apache License, Version 2.0 (the
|
||||
"License"); you may not use this file except in compliance
|
||||
with the License. You may obtain a copy of the License at
|
||||
|
||||
http://www.apache.org/licenses/LICENSE-2.0
|
||||
|
||||
Unless required by applicable law or agreed to in writing,
|
||||
software distributed under the License is distributed on an
|
||||
"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
|
||||
KIND, either express or implied. See the License for the
|
||||
specific language governing permissions and limitations
|
||||
under the License.
|
||||
---
|
||||
|
||||
Device
|
||||
======
|
||||
|
||||
> The `device` object describes the device's hardware and software.
|
||||
|
||||
Properties
|
||||
----------
|
||||
|
||||
- device.name
|
||||
- device.cordova
|
||||
- device.platform
|
||||
- device.uuid
|
||||
- device.version
|
||||
- device.model
|
||||
|
||||
Variable Scope
|
||||
--------------
|
||||
|
||||
Since `device` is assigned to the `window` object, it is implicitly in the global scope.
|
||||
|
||||
// These reference the same `device`
|
||||
var phoneName = window.device.name;
|
||||
var phoneName = device.name;
|
||||
|
||||
Permissions
|
||||
-----------
|
||||
|
||||
### Android
|
||||
|
||||
#### app/res/xml/config.xml
|
||||
|
||||
<plugin name="Device" value="org.apache.cordova.Device" />
|
||||
|
||||
#### app/AndroidManifest.xml
|
||||
|
||||
<uses-permission android:name="android.permission.READ_PHONE_STATE" />
|
||||
|
||||
### Bada
|
||||
|
||||
#### manifest.xml
|
||||
|
||||
<Privilege>
|
||||
<Name>SYSTEM_SERVICE</Name>
|
||||
</Privilege>
|
||||
|
||||
### BlackBerry WebWorks
|
||||
|
||||
#### www/plugins.xml
|
||||
|
||||
<plugin name="Device" value="org.apache.cordova.device.Device" />
|
||||
|
||||
#### www/config.xml
|
||||
|
||||
<feature id="blackberry.app" required="true" version="1.0.0.0" />
|
||||
<rim:permissions>
|
||||
<rim:permit>read_device_identifying_information</rim:permit>
|
||||
</rim:permissions>
|
||||
|
||||
### iOS
|
||||
|
||||
No permissions are required.
|
||||
|
||||
### webOS
|
||||
|
||||
No permissions are required.
|
||||
|
||||
### Windows Phone
|
||||
|
||||
#### Properties/WPAppManifest.xml
|
||||
|
||||
<Capabilities>
|
||||
<Capability Name="ID_CAP_WEBBROWSERCOMPONENT" />
|
||||
<Capability Name="ID_CAP_IDENTITY_DEVICE" />
|
||||
<Capability Name="ID_CAP_IDENTITY_USER" />
|
||||
</Capabilities>
|
||||
|
||||
Reference: [Application Manifest for Windows Phone](http://msdn.microsoft.com/en-us/library/ff769509%28v=vs.92%29.aspx)
|
||||
|
||||
### Tizen
|
||||
|
||||
#### config.xml
|
||||
|
||||
<feature name="http://tizen.org/api/systeminfo" required="true"/>
|
||||
|
||||
Reference: [Application Manifest for Tizen Web Application](https://developer.tizen.org/help/topic/org.tizen.help.gs/Creating%20a%20Project.html?path=0_1_1_3#8814682_CreatingaProject-EditingconfigxmlFeatures)
|
||||
106
plugins/org.apache.cordova.device/docs/device.model.md
Normal file
106
plugins/org.apache.cordova.device/docs/device.model.md
Normal file
@@ -0,0 +1,106 @@
|
||||
---
|
||||
license: Licensed to the Apache Software Foundation (ASF) under one
|
||||
or more contributor license agreements. See the NOTICE file
|
||||
distributed with this work for additional information
|
||||
regarding copyright ownership. The ASF licenses this file
|
||||
to you under the Apache License, Version 2.0 (the
|
||||
"License"); you may not use this file except in compliance
|
||||
with the License. You may obtain a copy of the License at
|
||||
|
||||
http://www.apache.org/licenses/LICENSE-2.0
|
||||
|
||||
Unless required by applicable law or agreed to in writing,
|
||||
software distributed under the License is distributed on an
|
||||
"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
|
||||
KIND, either express or implied. See the License for the
|
||||
specific language governing permissions and limitations
|
||||
under the License.
|
||||
---
|
||||
|
||||
device.model
|
||||
===========
|
||||
|
||||
Get the device's model name.
|
||||
|
||||
var string = device.model;
|
||||
|
||||
Description
|
||||
-----------
|
||||
|
||||
The `device.model` returns the name of the device's model or
|
||||
product. The value is set by the device manufacturer and may be
|
||||
different across versions of the same product.
|
||||
|
||||
Supported Platforms
|
||||
-------------------
|
||||
|
||||
- Android
|
||||
- BlackBerry WebWorks (OS 5.0 and higher)
|
||||
- iOS
|
||||
- Windows Phone 7 and 8
|
||||
- Bada 1.2 & 2.x
|
||||
- webOS
|
||||
- Tizen
|
||||
- Windows 8
|
||||
|
||||
Quick Example
|
||||
-------------
|
||||
|
||||
// Android: Nexus One returns "Passion" (Nexus One code name)
|
||||
// Motorola Droid returns "voles"
|
||||
// BlackBerry: Torch 9800 returns "9800"
|
||||
// iOS: for the iPad Mini, returns iPad2,5; iPhone 5 is iPhone 5,1. See http://theiphonewiki.com/wiki/index.php?title=Models
|
||||
//
|
||||
var model = device.model;
|
||||
|
||||
Full Example
|
||||
------------
|
||||
|
||||
<!DOCTYPE html>
|
||||
<html>
|
||||
<head>
|
||||
<title>Device Properties Example</title>
|
||||
|
||||
<script type="text/javascript" charset="utf-8" src="cordova-x.x.x.js"></script>
|
||||
<script type="text/javascript" charset="utf-8">
|
||||
|
||||
// Wait for device API libraries to load
|
||||
//
|
||||
document.addEventListener("deviceready", onDeviceReady, false);
|
||||
|
||||
// device APIs are available
|
||||
//
|
||||
function onDeviceReady() {
|
||||
var element = document.getElementById('deviceProperties');
|
||||
element.innerHTML = 'Device Name: ' + device.name + '<br />' +
|
||||
'Device Cordova: ' + device.cordova + '<br />' +
|
||||
'Device Platform: ' + device.platform + '<br />' +
|
||||
'Device UUID: ' + device.uuid + '<br />' +
|
||||
'Device Model: ' + device.model + '<br />' +
|
||||
'Device Version: ' + device.version + '<br />';
|
||||
}
|
||||
|
||||
</script>
|
||||
</head>
|
||||
<body>
|
||||
<p id="deviceProperties">Loading device properties...</p>
|
||||
</body>
|
||||
</html>
|
||||
|
||||
Android Quirks
|
||||
--------------
|
||||
|
||||
- Gets the [product name](http://developer.android.com/reference/android/os/Build.html#PRODUCT) instead of the [model name](http://developer.android.com/reference/android/os/Build.html#MODEL), which is often the production code name. For example, the Nexus One returns `Passion`, and Motorola Droid returns `voles`.
|
||||
|
||||
Windows Phone 7 and 8 Quirks
|
||||
-------------
|
||||
|
||||
- Returns the device model specified by the manufacturer. For example, the Samsung Focus returns `SGH-i917`.
|
||||
|
||||
Bada Quirks
|
||||
-----------
|
||||
- Returns the manufacturer model name, for example, `Samsung Wave S8500`
|
||||
|
||||
Tizen Quirks
|
||||
-----------
|
||||
- Returns the device model assigned by the vendor, for example, `TIZEN`
|
||||
108
plugins/org.apache.cordova.device/docs/device.name.md
Normal file
108
plugins/org.apache.cordova.device/docs/device.name.md
Normal file
@@ -0,0 +1,108 @@
|
||||
---
|
||||
license: Licensed to the Apache Software Foundation (ASF) under one
|
||||
or more contributor license agreements. See the NOTICE file
|
||||
distributed with this work for additional information
|
||||
regarding copyright ownership. The ASF licenses this file
|
||||
to you under the Apache License, Version 2.0 (the
|
||||
"License"); you may not use this file except in compliance
|
||||
with the License. You may obtain a copy of the License at
|
||||
|
||||
http://www.apache.org/licenses/LICENSE-2.0
|
||||
|
||||
Unless required by applicable law or agreed to in writing,
|
||||
software distributed under the License is distributed on an
|
||||
"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
|
||||
KIND, either express or implied. See the License for the
|
||||
specific language governing permissions and limitations
|
||||
under the License.
|
||||
---
|
||||
|
||||
device.name
|
||||
===========
|
||||
|
||||
__WARNING:__ `device.name` is deprecated as of version 2.3.0. Use `device.model` instead.
|
||||
|
||||
Get the device's model name.
|
||||
|
||||
var string = device.name;
|
||||
|
||||
Description
|
||||
-----------
|
||||
|
||||
`device.name` returns the name of the device's model or product. This
|
||||
value is set by the device manufacturer and may be different across
|
||||
versions of the same product.
|
||||
|
||||
Supported Platforms
|
||||
-------------------
|
||||
|
||||
- Android
|
||||
- BlackBerry WebWorks (OS 5.0 and higher)
|
||||
- iOS
|
||||
- Windows Phone 7 and 8
|
||||
- Bada 1.2 & 2.x
|
||||
- webOS
|
||||
- Tizen
|
||||
- Windows 8
|
||||
|
||||
Quick Example
|
||||
-------------
|
||||
|
||||
// Android: Nexus One returns "Passion" (Nexus One code name)
|
||||
// Motorola Droid returns "voles"
|
||||
// BlackBerry: Torch 9800 returns "9800"
|
||||
// iOS: All devices returns either "iPhone", "iPod Touch", "iPhone Simulator", "iPad", "iPad Simulator"
|
||||
//
|
||||
var name = device.name;
|
||||
|
||||
Full Example
|
||||
------------
|
||||
|
||||
<!DOCTYPE html>
|
||||
<html>
|
||||
<head>
|
||||
<title>Device Properties Example</title>
|
||||
|
||||
<script type="text/javascript" charset="utf-8" src="cordova-x.x.x.js"></script>
|
||||
<script type="text/javascript" charset="utf-8">
|
||||
|
||||
// Wait for device API libraries to load
|
||||
//
|
||||
document.addEventListener("deviceready", onDeviceReady, false);
|
||||
|
||||
// device APIs are available
|
||||
//
|
||||
function onDeviceReady() {
|
||||
var element = document.getElementById('deviceProperties');
|
||||
element.innerHTML = 'Device Name: ' + device.name + '<br />' +
|
||||
'Device Cordova: ' + device.cordova + '<br />' +
|
||||
'Device Platform: ' + device.platform + '<br />' +
|
||||
'Device UUID: ' + device.uuid + '<br />' +
|
||||
'Device Model: ' + device.model + '<br />' +
|
||||
'Device Version: ' + device.version + '<br />';
|
||||
}
|
||||
|
||||
</script>
|
||||
</head>
|
||||
<body>
|
||||
<p id="deviceProperties">Loading device properties...</p>
|
||||
</body>
|
||||
</html>
|
||||
|
||||
Android Quirks
|
||||
--------------
|
||||
|
||||
- Gets the [product name](http://developer.android.com/reference/android/os/Build.html#PRODUCT) instead of the [model name](http://developer.android.com/reference/android/os/Build.html#MODEL), which is often the production code name. For example, the Nexus One returns `Passion`, and Motorola Droid returns `voles`.
|
||||
|
||||
Windows Phone 7 and 8 Quirks
|
||||
-------------
|
||||
|
||||
- Returns the device model specified by the manufacturer. For example, the Samsung Focus returns `SGH-i917`.
|
||||
|
||||
Bada Quirks
|
||||
-----------
|
||||
- Returns the manufacturer model name, for example, `Samsung Wave S8500`
|
||||
|
||||
Tizen Quirks
|
||||
-----------
|
||||
- Returns the device model assigned by the vendor, for example, `TIZEN`
|
||||
99
plugins/org.apache.cordova.device/docs/device.platform.md
Normal file
99
plugins/org.apache.cordova.device/docs/device.platform.md
Normal file
@@ -0,0 +1,99 @@
|
||||
---
|
||||
license: Licensed to the Apache Software Foundation (ASF) under one
|
||||
or more contributor license agreements. See the NOTICE file
|
||||
distributed with this work for additional information
|
||||
regarding copyright ownership. The ASF licenses this file
|
||||
to you under the Apache License, Version 2.0 (the
|
||||
"License"); you may not use this file except in compliance
|
||||
with the License. You may obtain a copy of the License at
|
||||
|
||||
http://www.apache.org/licenses/LICENSE-2.0
|
||||
|
||||
Unless required by applicable law or agreed to in writing,
|
||||
software distributed under the License is distributed on an
|
||||
"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
|
||||
KIND, either express or implied. See the License for the
|
||||
specific language governing permissions and limitations
|
||||
under the License.
|
||||
---
|
||||
|
||||
device.platform
|
||||
===============
|
||||
|
||||
Get the device's operating system name.
|
||||
|
||||
var string = device.platform;
|
||||
|
||||
Supported Platforms
|
||||
-------------------
|
||||
|
||||
- Android
|
||||
- BlackBerry WebWorks (OS 5.0 and higher)
|
||||
- iOS
|
||||
- Windows Phone 7 and 8
|
||||
- Bada 1.2 & 2.x
|
||||
- webOS
|
||||
- Tizen
|
||||
- Windows 8
|
||||
|
||||
Quick Example
|
||||
-------------
|
||||
|
||||
// Depending on the device, a few examples are:
|
||||
// - "Android"
|
||||
// - "BlackBerry"
|
||||
// - "iOS"
|
||||
// - "webOS"
|
||||
// - "WinCE"
|
||||
// - "Tizen"
|
||||
var devicePlatform = device.platform;
|
||||
|
||||
Full Example
|
||||
------------
|
||||
|
||||
<!DOCTYPE html>
|
||||
<html>
|
||||
<head>
|
||||
<title>Device Properties Example</title>
|
||||
|
||||
<script type="text/javascript" charset="utf-8" src="cordova-x.x.x.js"></script>
|
||||
<script type="text/javascript" charset="utf-8">
|
||||
|
||||
// Wait for device API libraries to load
|
||||
//
|
||||
document.addEventListener("deviceready", onDeviceReady, false);
|
||||
|
||||
// device APIs are available
|
||||
//
|
||||
function onDeviceReady() {
|
||||
var element = document.getElementById('deviceProperties');
|
||||
element.innerHTML = 'Device Name: ' + device.name + '<br />' +
|
||||
'Device Cordova: ' + device.cordova + '<br />' +
|
||||
'Device Platform: ' + device.platform + '<br />' +
|
||||
'Device UUID: ' + device.uuid + '<br />' +
|
||||
'Device Version: ' + device.version + '<br />';
|
||||
}
|
||||
|
||||
</script>
|
||||
</head>
|
||||
<body>
|
||||
<p id="deviceProperties">Loading device properties...</p>
|
||||
</body>
|
||||
</html>
|
||||
|
||||
BlackBerry Quirks
|
||||
-----------------
|
||||
|
||||
Devices may return the device platform version number instead of the
|
||||
platform name. For example, the Storm2 9550 returns a value such as
|
||||
`2.13.0.95`.
|
||||
|
||||
Windows Phone 7 Quirks
|
||||
-----------------
|
||||
|
||||
Windows Phone 7 devices report the platform as `WinCE`.
|
||||
|
||||
Windows Phone 8 Quirks
|
||||
-----------------
|
||||
|
||||
Windows Phone 8 devices report the platform as `Win32NT`.
|
||||
115
plugins/org.apache.cordova.device/docs/device.uuid.md
Normal file
115
plugins/org.apache.cordova.device/docs/device.uuid.md
Normal file
@@ -0,0 +1,115 @@
|
||||
---
|
||||
license: Licensed to the Apache Software Foundation (ASF) under one
|
||||
or more contributor license agreements. See the NOTICE file
|
||||
distributed with this work for additional information
|
||||
regarding copyright ownership. The ASF licenses this file
|
||||
to you under the Apache License, Version 2.0 (the
|
||||
"License"); you may not use this file except in compliance
|
||||
with the License. You may obtain a copy of the License at
|
||||
|
||||
http://www.apache.org/licenses/LICENSE-2.0
|
||||
|
||||
Unless required by applicable law or agreed to in writing,
|
||||
software distributed under the License is distributed on an
|
||||
"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
|
||||
KIND, either express or implied. See the License for the
|
||||
specific language governing permissions and limitations
|
||||
under the License.
|
||||
---
|
||||
|
||||
device.uuid
|
||||
===========
|
||||
|
||||
Get the device's Universally Unique Identifier ([UUID](http://en.wikipedia.org/wiki/Universally_Unique_Identifier)).
|
||||
|
||||
var string = device.uuid;
|
||||
|
||||
Description
|
||||
-----------
|
||||
|
||||
The details of how a UUID is generated are determined by the device manufacturer and are specific to the device's platform or model.
|
||||
|
||||
Supported Platforms
|
||||
-------------------
|
||||
|
||||
- Android
|
||||
- BlackBerry WebWorks (OS 5.0 and higher)
|
||||
- iOS
|
||||
- Windows Phone 7 and 8
|
||||
- Bada 1.2 & 2.x
|
||||
- webOS
|
||||
- Tizen
|
||||
- Windows 8
|
||||
|
||||
Quick Example
|
||||
-------------
|
||||
|
||||
// Android: Returns a random 64-bit integer (as a string, again!)
|
||||
// The integer is generated on the device's first boot
|
||||
//
|
||||
// BlackBerry: Returns the PIN number of the device
|
||||
// This is a nine-digit unique integer (as a string, though!)
|
||||
//
|
||||
// iPhone: (Paraphrased from the UIDevice Class documentation)
|
||||
// Returns a string of hash values created from multiple hardware identifies.
|
||||
// It is guaranteed to be unique for every device and cannot be tied
|
||||
// to the user account.
|
||||
// Windows Phone 7 : Returns a hash of device+current user,
|
||||
// if the user is not defined, a guid is generated and will persist until the app is uninstalled
|
||||
//
|
||||
// webOS: returns the device NDUID
|
||||
//
|
||||
// Tizen: returns the device IMEI (International Mobile Equipment Identity or IMEI is a number
|
||||
// unique to every GSM and UMTS mobile phone.
|
||||
var deviceID = device.uuid;
|
||||
|
||||
Full Example
|
||||
------------
|
||||
|
||||
<!DOCTYPE html>
|
||||
<html>
|
||||
<head>
|
||||
<title>Device Properties Example</title>
|
||||
|
||||
<script type="text/javascript" charset="utf-8" src="cordova-x.x.x.js"></script>
|
||||
<script type="text/javascript" charset="utf-8">
|
||||
|
||||
// Wait for device API libraries to load
|
||||
//
|
||||
document.addEventListener("deviceready", onDeviceReady, false);
|
||||
|
||||
// device APIs are available
|
||||
//
|
||||
function onDeviceReady() {
|
||||
var element = document.getElementById('deviceProperties');
|
||||
element.innerHTML = 'Device Name: ' + device.name + '<br />' +
|
||||
'Device Cordova: ' + device.cordova + '<br />' +
|
||||
'Device Platform: ' + device.platform + '<br />' +
|
||||
'Device UUID: ' + device.uuid + '<br />' +
|
||||
'Device Version: ' + device.version + '<br />';
|
||||
}
|
||||
|
||||
</script>
|
||||
</head>
|
||||
<body>
|
||||
<p id="deviceProperties">Loading device properties...</p>
|
||||
</body>
|
||||
</html>
|
||||
|
||||
iOS Quirk
|
||||
-------------
|
||||
|
||||
The `uuid` on iOS is not unique to a device, but varies for each
|
||||
application, for each installation. It changes if you delete and
|
||||
re-install the app, and possibly also when you upgrade iOS, or even
|
||||
upgrade your app per version (apparent in iOS 5.1). The `uuid` is not
|
||||
a reliable value.
|
||||
|
||||
Windows Phone 7 and 8 Quirks
|
||||
-------------
|
||||
|
||||
The `uuid` for Windows Phone 7 requires the permission
|
||||
`ID_CAP_IDENTITY_DEVICE`. Microsoft will likely deprecate this
|
||||
property soon. If the capability is not available, the application
|
||||
generates a persistent guid that is maintained for the duration of the
|
||||
application's installation on the device.
|
||||
86
plugins/org.apache.cordova.device/docs/device.version.md
Normal file
86
plugins/org.apache.cordova.device/docs/device.version.md
Normal file
@@ -0,0 +1,86 @@
|
||||
---
|
||||
license: Licensed to the Apache Software Foundation (ASF) under one
|
||||
or more contributor license agreements. See the NOTICE file
|
||||
distributed with this work for additional information
|
||||
regarding copyright ownership. The ASF licenses this file
|
||||
to you under the Apache License, Version 2.0 (the
|
||||
"License"); you may not use this file except in compliance
|
||||
with the License. You may obtain a copy of the License at
|
||||
|
||||
http://www.apache.org/licenses/LICENSE-2.0
|
||||
|
||||
Unless required by applicable law or agreed to in writing,
|
||||
software distributed under the License is distributed on an
|
||||
"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
|
||||
KIND, either express or implied. See the License for the
|
||||
specific language governing permissions and limitations
|
||||
under the License.
|
||||
---
|
||||
|
||||
device.version
|
||||
==============
|
||||
|
||||
Get the operating system version.
|
||||
|
||||
var string = device.version;
|
||||
|
||||
Supported Platforms
|
||||
-------------------
|
||||
|
||||
- Android 2.1+
|
||||
- BlackBerry WebWorks (OS 5.0 and higher)
|
||||
- iOS
|
||||
- Windows Phone 7 and 8
|
||||
- Bada 1.2 & 2.x
|
||||
- webOS
|
||||
- Tizen
|
||||
- Windows 8
|
||||
|
||||
Quick Example
|
||||
-------------
|
||||
|
||||
// Android: Froyo OS would return "2.2"
|
||||
// Eclair OS would return "2.1", "2.0.1", or "2.0"
|
||||
// Version can also return update level "2.1-update1"
|
||||
//
|
||||
// BlackBerry: Torch 9800 using OS 6.0 would return "6.0.0.600"
|
||||
//
|
||||
// iPhone: iOS 3.2 returns "3.2"
|
||||
//
|
||||
// Windows Phone 7: returns current OS version number, ex. on Mango returns 7.10.7720
|
||||
// webOS: webOS 2.2.4 return 2.2.4
|
||||
// Tizen: returns "TIZEN_20120425_2"
|
||||
var deviceVersion = device.version;
|
||||
|
||||
Full Example
|
||||
------------
|
||||
|
||||
<!DOCTYPE html>
|
||||
<html>
|
||||
<head>
|
||||
<title>Device Properties Example</title>
|
||||
|
||||
<script type="text/javascript" charset="utf-8" src="cordova-x.x.x.js"></script>
|
||||
<script type="text/javascript" charset="utf-8">
|
||||
|
||||
// Wait for device API libraries to load
|
||||
//
|
||||
document.addEventListener("deviceready", onDeviceReady, false);
|
||||
|
||||
// device APIs are available
|
||||
//
|
||||
function onDeviceReady() {
|
||||
var element = document.getElementById('deviceProperties');
|
||||
element.innerHTML = 'Device Name: ' + device.name + '<br />' +
|
||||
'Device Cordova: ' + device.cordova + '<br />' +
|
||||
'Device Platform: ' + device.platform + '<br />' +
|
||||
'Device UUID: ' + device.uuid + '<br />' +
|
||||
'Device Version: ' + device.version + '<br />';
|
||||
}
|
||||
|
||||
</script>
|
||||
</head>
|
||||
<body>
|
||||
<p id="deviceProperties">Loading device properties...</p>
|
||||
</body>
|
||||
</html>
|
||||
Reference in New Issue
Block a user