Adding a Device Profile to the Device Databases

To add a new device profile, execute the +Add-Update-Handset Ant target, also known as the Profile Updater. The +Add-Update-Handset Ant target adds the new device to the Mobile Designer device database by creating an XML file for the device in the following directory:

Note:

After adding the device to the Mobile Designer device database:

You might want to test the settings. For more information, see Testing Settings in a Device Profile.

If you want to build an application for the device, add the device to the project. For more information, see Adding a Device to a Project.

Note:

This procedure describes how to use the +Add-Update-Handset Ant target to add a new device profile. If you want to update an existing device profile, see Updating an Existing Device Profile in the Device Database.

1. If the Handset Updater project is not in Software AG Designer, import the project.

a. In Software AG Designer select File > Import> General > Existing Projects into Workspace, and then click Next.

b. In Import Projects, click Browse and select the project source directory of the project you want to clone.

The source code for the Handset Updater sample application is in the following directory:

2. Open the Handset Updater project’s build.xml file in the Ant view.

a. In the Project Explorer view, locate the Handset Updater project.

b. Expand the project and drag its build.xml file to the Ant view.

If the Ant view is not open, for instruction, see Displaying the Ant View.

4. In the Choose Handset dialog, type a name for the new device profile in the Add a new handset field.

When specifying the name, use the Mobile Designer naming convention for a device profile. The naming convention is the following:

For example, the name of the device profile for the AOC Android Breeze is AND_AOC_Breeze. AND represents the Android platform; AOC represents the manufacturer AOC, and Breeze represents the model.

To view samples of existing profile names, review the names in the Choose your handset list.

The +Add-Update-Handset Ant target displays the Update Handset Information dialog.

6. In the Update Handset Information dialog, select each parameter or property and enter the value for the device in the Handset override column. For the value, use the information you determined when running the Handset Updater.

7. Optionally, in Comments field, type a comment for the new device profile.

8. Click Update Handset Information when you have completed the device profile.