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


Registering iOS applications from the MobileFirst Platform CLI

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


Before you begin


Overview

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

Tip: If the mfpdev app register command cannot determine the bundle ID, it will prompt you to enter it. This can occur if value of the CFBundleIdentifier key in the Info.plist file contains variables. To avoid this, manually edit theInfo.plist file and enter the bundle ID without variables before you run the mfpdev app register command.


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 (Info.plist) such as application name, version number, and app ID is sent to the server. If the client properties file mfpclient.plist already exists, it is updated with the value of the server's URL. If the file did not exist, a mfpclient.plist file that includes the server's URL is created at the root of your project.

Note: If an existing mfpclient.plist file resides in another directory in the project besides the root directory, the file will be updated with the server's URL.


What to do next

Copy the mfpclient.plist file and register it in your Xcode project. For more information, see iOS client properties file.

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 iOS applications to MobileFirst Server