For up-to-date product documentation, see the IBM MobileFirst Foundation Developer Center.

Registering Android applications from the MobileFirst Platform CLI

We can use the IBM MobileFirstâ„¢ Platform Command Line Interface (CLI) to register your Android application to an instance of MobileFirst Server.

Before you begin


Once you have the client side of your Android application initially defined, we can prepare for further development tasks by registering it to a MobileFirst Server.


  1. Check that the target MobileFirst Server is up and running.
  2. Navigate to the directory that contains your app, or one of its subdirectories.
  3. Register your app to the server. Use one of the following procedures:
    • To register the app to the default server, run the following command:

      mfpdev app register

      Note: If you have not previously set a default server and a MobileFirst Server is running on the local system, this command registers the app to the local MobileFirst Server, and this server is made the default.

    • To register your app to a server that is not the default server:
      1. Create a server profile by running the mfpdev server add command. For example:

        mfpdev server add Server1 -url -login admin -password secretPassword! For more information about the mfpdev server add command, run mfpdev help server add.

      2. To register your app to the server that you just defined, run the mfpdev app register command, and specify the server profile that you just created. For example:

        mfpdev app register Server1

    For more information about this command, including optional parameters, run mfpdev help app register.


The app is registered to the target server. Data about the app that is obtained from the platform properties file (AndroidManifest.xml) such as application name, version number, and app ID is sent to the server. If the client properties file /app/src/main/assets/ already exists, it is updated with the value of the server's URL. If the file did not exist, a /app/src/main/assets/ file that includes the server's URL is created at the root of your project.

What to do next

We can proceed with other development tasks that depend on the MobileFirst Server. For example, we can preview your app, test your app's security features, and manage your app from the MobileFirst Operations Console.

Parent topic: Registering Android applications to MobileFirst Server