Project Properties for the Mobile Administrator Plug-In

The following sections describe the properties that you can add to the ma.properties file to configure the Mobile Administrator plug-in for a project. Each section lists:

These properties do not have default values. You must specify a value for each property you want to use. For information about how to set properties, see Setting Mobile Administrator Plug-in Project Properties.

Platforms	Android iOS Windows Phone 8.x Windows RT Windows 8
Ant tasks	Upload-Binaries Upload-Binaries-Last Remote-Multi-Build
Value	URL of the Mobile Administrator instance Example value: http://localhost:8080

Platforms

Android
iOS
Windows Phone 8.x
Windows RT
Windows 8

Ant tasks

Upload-Binaries Upload-Binaries-Last Remote-Multi-Build

Value

Value of the Slug property that identifies the Mobile Administrator project

Note:

You can find the Slug property in Mobile Administrator on the Detail tab for the project.

Important:

The bundle ID for the Mobile Designer project must match the bundle ID for the Mobile Administrator project.

Note:

If you do not specify a value for this property, Mobile Designer uses the bundle ID that it generates by using the value of the ios.bundle property from the sdk.properties file, the application name, device name, and language. Because Mobile Designer includes the device name and language in the bundle ID, two devices for the same platform have different bundle IDs. However, Mobile Administrator supports only one bundle ID per platform. Use this property to override the bundle ID Mobile Designer generates for the final binary.

Platforms	iOS
Ant tasks	Upload-Binaries Upload-Binaries-Last
Value	Bundle ID

Specifies the type of authentication you want Mobile Designer to use when it accesses Mobile Administrator during the process of uploading or remotely building the project.

Platforms	Android iOS Windows Phone 8.x Windows RT Windows 8
Ant tasks	Upload-Binaries Upload-Binaries-Last Remote-Multi-Build
Value	access_token if you want to use an access token for authentication. When you specify access_token, use the mobile.admin.auth.access_token property to provide the access token. Software AG recommends that you use an access token for authentication. basic if you want to use basic authentication. When you specify basic, use the following properties to provide a user name, password, and/or to indicate whether you want Mobile Designer to prompt for a password: mobile.admin.basic.auth.user mobile.admin.basic.auth.pass mobile.admin.basic.auth.prompt_for_pass

Specifies the access token that you want Mobile Designer to use for authentication when it accesses Mobile Administrator during the process of uploading or remotely building the project.

Note:

This property is only applicable when you set the mobile.admin.use.authentication property to access_token.

Platforms	Android iOS Windows Phone 8.x Windows RT Windows 8
Ant tasks	Upload-Binaries Upload-Binaries-Last Remote-Multi-Build
Value	Access token that Mobile Administrator generated for a user account.

Specifies whether you want Mobile Designer to prompt for a password to use for authentication when Mobile Designer accesses Mobile Administrator during the process of uploading or remotely building the project. The password corresponds to the user name you specify in the mobile.admin.basic.auth.user property.

Note:

This property is only applicable when you set the mobile.admin.use.authentication property to basic.

Platforms	Android iOS Windows Phone 8.x Windows RT Windows 8
Ant tasks	Upload-Binaries Upload-Binaries-Last Remote-Multi-Build
Value	true if you want Mobile Designer to prompt for a password. If you specify true and you also specify the password in the mobile.admin.basic.auth.pass property, Mobile Designer uses the password you supply at the prompt and ignores the value of the mobile.admin.basic.auth.pass property. false if you do not want Mobile Designer to prompt for a password. If you specify false, be sure to specify the password in the mobile.admin.basic.auth.pass property.

Specifies the user name of the user account that you want Mobile Designer to use when it accesses Mobile Administrator during the process of uploading or remotely building the project.

Note:

This property is only applicable when you set the mobile.admin.use.authentication property to basic.

Platforms	Android iOS Windows Phone 8.x Windows RT Windows 8
Ant tasks	Upload-Binaries Upload-Binaries-Last Remote-Multi-Build
Value	User name of a Mobile Administrator user account Be sure to specify a user account that has permissions to act against the Mobile Administrator project that corresponds to the Mobile Designer project. For a description of the required permissions, see Requirements for Using the Mobile Administrator Plug-in for a Project.

Note:

This property is only applicable when you set the mobile.admin.use.authentication property to basic.

Platforms

Android
iOS
Windows Phone 8.x
Windows RT
Windows 8

Ant tasks

Upload-Binaries Upload-Binaries-Last Remote-Multi-Build

Value

Password of the Mobile Administrator user account.

Caution:

If you use basic authentication, the password is saved in plain text in the ma.properties file. To avoid this, Software AG recommends that you use an access token for authentication.

Specifies the Mobile Designer project.temp.last.version.properties.file project property that the +Multi-Build Ant task uses for caching the last version of the final binary.

Platforms	Android iOS Windows Phone 8.x Windows RT Windows 8
Ant tasks	Upload-Binaries Upload-Binaries-Last Remote-Multi-Build
Value	Set the value to the project.temp.last.version.properties.file project property

Mobile Designer accesses Mobile Administrator to get the project’s last version number. Use this property to indicate whether you want Mobile Designer to use that last version for the build or to calculate a new version number by incrementing the last build version number by one.

Platforms

Android
iOS
Windows Phone 8.x
Windows RT
Windows 8

Ant tasks

Upload-Binaries
Remote-Multi-Build

Value

INCREMENT if you want Mobile Designer to increment the last version number by one.

Note:

If the last version number does not end with a number, for example, “1.0.0.0a”, Mobile Designer cannot increment the version number. Instead, Mobile Designer prompts you to provide the version number to use.

LATEST if you want Mobile Designer to use the last version number.

Platforms	Android iOS Windows Phone 8.x Windows RT Windows 8
Ant tasks	Upload-Binaries Upload-Binaries-Last Remote-Multi-Build
Value	true if you want to mark the uploaded final binaries as stable. false if the uploaded final binaries are not stable.

Specifies whether you want a webpage containing a link to the application displayed if the build is successful. The webpage is displayed in the default browser.

Platforms	Android iOS Windows Phone 8.x Windows RT Windows 8
Ant tasks	Upload-Binaries Upload-Binaries-Last
Value	true if you want to display a web page containing a link that you can use to download the mobile application if the build is successful. false if you do not want to display a web page containing a link for the application if the build is successful.

Specifies whether you want Mobile Designer to use the existing build configurations defined in the Mobile Administrator project that is associated with your Mobile Designer project.

Note:

You create build configurations from Mobile Administrator on the Build tab for the project.

Platforms

Android
iOS
Windows Phone 8.x
Windows RT
Windows 8

Ant tasks

Remote-Multi-Build

Value

true if you want Mobile Designer to use existing build configurations to build targets

false if you want Mobile Designer to create new build configuration in the corresponding Mobile Administrator project based on information you supply on the Remote Multi-Build dialogs.

Note:

After the build is finished, Mobile Designer does not delete the newly created build configurations because deleting build configurations triggers the deletion of all underlying build jobs in Mobile Administrator.

This property identifies the files and folders that reside within the project folder that you want Mobile Designer to transmit to Mobile Administrator to perform a remote multi-build of the project. When you use this property, Mobile Designer transmits only the files and folders that you specifically include using this property.

Note:

Specify either the mobile.admin.data.transmission.zip.includes property or the mobile.admin.data.transmission.zip.excludes. If you specify both properties, Mobile Designer uses only the mobile.admin.data.transmission.zip.includes property.

Platforms	Android iOS Windows Phone 8.x Windows RT Windows 8
Ant tasks	Remote-Multi-Build
Value	Semicolon-separated list of project files and folders to include. Specify the files and folders that are required to remotely build the project.

This project identifies the files and folders that Mobile Designer transmits to Mobile Administrator to perform a remote multi-build of the project. Mobile Designer transmits all the files and folders from the project folder except the ones you specifically exclude using this property.

Note:

Platforms	Android iOS Windows Phone 8.x Windows RT Windows 8
Ant tasks	Remote-Multi-Build
Value	Semicolon-separated list of project files and folders to exclude. Specify only files and folders that are not required to remotely build the project.

Specifies a list of file or folder name prefixes. When Mobile Designer transmits files to Mobile Administrator to perform a remote multi-build, Mobile Designer ignores, that is, does not transmit, files and folders in the project folder that begin with the prefixes you specify. This property applies to all files and folders, including subfolders and their files recursively.

Platforms	Android iOS Windows Phone 8.x Windows RT Windows 8
Ant tasks	Remote-Multi-Build
Value	Semicolon-separated list of prefixes that identify the start of file and/or folder names to ignore. Example value: .svn