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


Registering iOS applications from the MobileFirst Operations Console

Register your iOS application to an instance of MobileFirst Server to establish communication with the server and to provide the server with information about your app.


Before you begin

You must have the IBM MobileFirstâ„¢ Platform Operations Console running on the MobileFirst Server targeted for registration. For more information, see The IBM MobileFirst Platform Foundation Developer Kit.


Overview

We can register an app on the server before or after setting up the Xcode environment see Methods of setting up your environment. You must register your app to the server before developing code that accesses server resources.


Procedure

  1. In the MobileFirst Operations Console, navigate to the Register Application page by using one of the following methods:
    • In the navigation sidebar, select New next to Appilcations.

      Console navigation-bar app-registration button

    • From the Dashboard, select Register an App.

      Console dashboard app-registration tile

  2. On the Register an Application page, fill in the following values for the application you are registering:

    Register button

    • Application Name: This is for display and can be any convenient value. It is optional.
    • Bundle ID: The bundle identifier from the Xcode project.
    • Version: The version number of your iOS app.

      The version number and bundle identifier are reported in the Identity section of the General tab of your Xcode project.

      iOS version number in Xcode

      These correspond to the values in the info.plist file.

      Table 1. Registration values for iOS projects in the info.plist
      registration value parameter in info.plist
      Bundle identifier CFBundleIdentifier
      Version CFBundleShortVersionString

      Note: In the info.plist for projects created by Xcode, these values are represented by variables. Therefore you need to check these values in the Xcode project itself.

  3. Click the Register application button.
  4. From the main Dashboard page, your application is now listed under the default mfp runtime.

    App registered in dashboard

    Note: The mfp runtime is the default value for the WLServerContext parameter in the mfpclient.plist file below.

  5. Click the application name to display the main configuration page for our app.
  6. The main page for our app displays different configuration options for the server-side registration of your app.

    App registration

    Click the Configuration Files tab.

  7. The Client Configuration File tab displays a template for creating your mfpclient.properties file. This file is used for connecting the client app to the server.

    mfpclient.plist file


Results

Your iOS application is registered on the server.


What to do next

To complete the client-server registration, we must complete the required properties in the mfpclient.plist file, copy, and register it in your Xcode project. For more information, see iOS client properties file.

Parent topic: Registering iOS applications to MobileFirst Server