Registering Android applications from the MobileFirst Platform CLI

You can use the IBM MobileFirst™ Platform Command Line Interface (CLI) to register your Android application to an instance of MobileFirst Server.

Before you begin

About this task

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

Procedure

  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 https://company.mobile.com:9080 -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.

Results

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/mfpclient.properties already exists, it is updated with the value of the server's URL. If the file did not exist, a /app/src/main/assets/mfpclient.properties file that includes the server's URL is created at the root of your project.

What to do next

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