Creating a New Mobile Project

Mobile Development provides the New Mobile Development Project wizard that you can use to create a new mobile project. When you create a mobile project, Mobile Development automatically adds the following to your mobile project:

Adds your system language as a language that your application supports. You can add additional languages and/or remove languages after the project is created. For more information, see Managing Languages the Application Supports.

Adds several universal devices that your application supports. You can add additional devices and/or remove devices after the project is created. For more information, see Adding Devices to the Mobile Project and Removing Devices from the Mobile Project.

Additionally, when you create a project, in the New Mobile Development Project wizard, you can provide settings to use Mobile Administrator with your project. Before you can use Mobile Administrator, you must perform required setup. For more information, see Using Mobile Administrator to Manage and Distribute Mobile Applications.

The name that you type will automatically be used as the default value in the Application Name field and as a prefix in the Package Name field.

b. Optional. If you want to use an application name other than the default value, type the name in the Application Name field.

Mobile Development uses the application name internally, for example, as part of the name of the application_nameAppControllerImpl.java Java class that it creates.

Note:

You can rename the application at a later time. However, if you have added custom code to application_nameAppControllerImpl.java, you need to take further action. For more information, see Renaming the Application.

c. Optional. If you want to use a package name other than the default value, type the name in the Package Name field. When specifying the name, be sure to only use characters that are valid in a Java package name.

The default value for the package name is defined in the Mobile Development preferences. If you want to change the default value, you can simply click the Configure the default Package Name link. For more information, see Mobile Development Preferences.

Mobile Development uses the supplied name as part of the package names for the Java classes in the gen/src and src folders of your project. For example, if you specify com.mycompany.myproject, the gen/src folder contains the com.mycompany.myproject package.

To specify an alternate location, clear the Use the default location check box, click Browse, and browse to and select the location where you want to save the project.

3. Select the application template that you want to use. The application template helps to speed up development because default configurations that are ready for customization will be generated. The following templates are provided for selection (see the template descriptions in the wizard for more detailed information):

4. If you want to manage and distribute your application via webMethods Mobile Administrator, click Next to continue with the next step. Otherwise, click Finish.

Important:

To use Mobile Administrator for a mobile project, you must perform setup in Mobile Administrator. For more information, see Using Mobile Administrator to Manage and Distribute Mobile Applications.

b. When a Mobile Administrator host name has been defined in the Mobile Development preferences, it is shown in the URL field. If a host name is not shown in this field, you can simply click the Configure the default host name link and then define the host name in the preferences. For more information, see Mobile Development Preferences. Otherwise, type the URL of the Mobile Administrator instance that you want to use to manage and distribute the application.

The authentication token is now requested from the specified Mobile Administrator instance. When the authentication was successful, it is possible to proceed with the remaining options on the wizard page.

If the Mobile Administrator application you want to use does not yet exist and you plan to create a new Mobile Administrator application, select New.

6. Complete the Mobile Administrator information based on whether you are using an existing application or will be creating a new application:

If you are using an existing Mobile Administrator application, select the identifier of the application you want to use from a drop-down list.

i. Either keep the value in the Identifier field (this is taken from the project name you have specified) or type another identifier you want to use for a new project.

ii. For an Android project, select the Android check box and in the Bundle ID field specify the bundle ID you want to use for the final binary.

iii. For an iOS project, select the iOS check box and in the Bundle ID field specify the bundle ID you want to use for the final binary.

The wizard will make the required call to Mobile Administrator and create the application in Mobile Administrator. If there are issues during the creation, an error message will be shown in the header of the wizard. This feature requires at least Mobile Administrator Version 9.8.0.0.63. Possible error messages are:

Error	Solution
Identifier has already been taken	Specify a different identifier.
Bundle ID has already been taken	The bundle ID identifies an application on the target device and must be unique. Therefore, specify an available bundle ID for the target platform. For iOS, the bundle ID is taken from a specific provisioning profile, which can be found on your target Mobile Administrator instance. For iOS, the bundle ID must also match a given provisioning profile. To find out which bundle IDs are available, log in to your Mobile Administrator instance and check the settings for the provisioning profiles.