Multi-Configurations
Multi-configurations concept are introduced mainly for resolve device fragmentation issue. A configuration contains a device and a set of preprocess symbols. The symbols will be used by preprocessor. We use these information to build the Java ME project for one device. While a Java ME project can have many configurations, we can build for many device according configurations.
You can manage project configurations in three places: project create wizard, project properties dialog and Application Descriptor Editor:
From now on we will call the user interface in the red box as Configurations Management UI.
You can add a configuration to a Java ME project.
Click "Add..." button on Configurations Management UI, you will see Add
Configuration Dialog:
First,you should select a device. Then the configuration name and
symbols will generate automatically. You can also edit configuration
name and add/remove/edit symbols.
You can also choose one or more workspace scope symbol definition sets
if you have defined some. See Defining Symbols
for details.
Select a configuration on Configurations Management UI, and click "Edit..." button, then you will see a dialog allow you to edit existing configuration. The Edit Configuration Dialog is much same as Add Configuration Dialog.
Select one or more configurations on Configurations Management
UI, and click "Remove" button, selected configurations will be deleted.
If you click "Cancel" in project properties or close Application
Descriptor Editor without saving, the remove configuration operation
will not take effect.
If you try to delete all of the configurations, you will receive a error
message box tell you that a project must have at least one
configuration.
A Java ME project can have only one active configuration. MTJ will
use the device contained by the active configuration as its current
device.
To switch active configuration, set the check box checked of a
configuration on the Configurations Management UI, and click "OK" on
project properties dialog, or perform save in Application Descriptor
Editor.
There two way to save modifications you made against
configurations.
1. In "Java ME" project properties page, click "OK" or "Apply" button.
2. In Application Descriptor Editor, click "Save" button on tool bar or
press "Ctrl+s" on keyboard.
If 1. you made any change(except switch active configurations) against
configurations then do save, and 2. you have already export Antenna
build files, MTJ will ask you if you want reexport Antenna build files
again. As shown in the following snapshot.
Your project could have many configurations, so you can build for
multi-target.
You can use MTJ packaging functionality to package for multi
configurations at one click.
You can also use MTJ exported Antenna build scripts to pakcaging for
multi configurations.
For more information about packaging, please refer Packaging and Antenna Support