7 Searching the WURFL Device Database

The Wireless Universal Resource File (WURFL) is an XML file that acts as a global database of mobile device capabilities. WURFL is an open source project at http://wurfl.sourceforge.net/. The WURFL DB (http://www.wurflpro.com/) is a web-based interface that allows WURFL contributors to add or change device information in the WURFL.

The SDK uses a WURFL module to discover devices based on API support or on physical characteristics such as physical memory size or display size.

7.1 WURFL Search for Devices

Follow these instructions to search for devices.

Select Tools > Java ME > Device Database Search.

The WURFL Device Search tab opens in the main window.
Check Use Filter to see search options.

If you do not check Use Filter, all devices in the database are listed. See Section 7.2, "WURFL Search Filtering".
Make a selection from the dropdown menu on the left.

If applicable, the center dropdown displays a list of conditions. The menu on the right displays a value.
To add another search criteria, click the + button.

Click the - button to remove a search setting.
Click the Search button.

The search returns devices that match all the chosen criteria. The results are not case sensitive.
Click on a device to view its properties on the right, as shown below.

Description of the illustration wurflsearch.gif

See Section 7.2, "WURFL Search Filtering".

7.2 WURFL Search Filtering

As discussed in Section 7.1, "WURFL Search for Devices", you can use the filter to set search constraints. If Use Filter is not checked all devices are listed. If Use Filter is checked, you must set at least one constraint.

Supported Properties

This utility searches on a predefined list of constraints that have corresponding properties in the Java ME SDK.

Supported APIs

You can check the APIs you want. Note, checking an API does not exclude APIs that are not checked.
- MIDP 1.0, MIDP 2.0
- CLDC 1.0, CLDC 1.1MMAPI 1.0, MMAPI 1.1
- WMAPI 1.0, WMAPI 1.1, WMAPI 2.0
- Bluetooth API
- 3D API
- Localization API
Vendor
Device
Resolution Width/Height

The device resolution.
Maximum Image Width/Height

The maximum image size that the device can display.
Physical Memory Size

The built-in memory size.
Heap Size

Memory limit in bytes at runtime.
Number of Colors

The number or colors the device's display supports.
Supports Wi-Fi
Supported Image Formats

Check the image type. Unchecked types might still be supported.
- bmp
- jpeg
- gif

To see the full list of WURFL constraints, go to: http://wurfl.sourceforge.net/help_doc.php.