Installing the iOS development tools

A Mac OS X computer with Oracle JDK and Xcode installed is required to build the iOS mobile apps.

About this task

You use your Apple ID to enroll in a developer program. You can enroll in the iOS Developer Program as an individual or a company in which an individual is a one-person team.

You can also enroll in the iOS Developer Enterprise Program as a company, which authorizes you to create proprietary in-house iOS apps. The procedure for setting up the iOS Developer Enterprise account might include extra steps.

The person who creates the team becomes the team agent who is the legal contact and administrator of the team and has all privileges and full access to Member Center and iTunes Connect. The team agent is required to complete steps 5-7. iOS developers might require the assistance of the team agent to complete the procedure.

You create provisioning profiles to manage the use of iOS apps that you develop.

A development provisioning profile regulates the development and testing of apps to a specific number of devices. Development provisioning profiles for the apps must contain the IDs of the devices on which the app is installed. You can register more iOS devices and add them to the provisioning profiles.

A distribution provisioning profile provides access to the app store from all of the devices in your enterprise.

Procedure

  1. Install Oracle JDK. For the current supported version, see the Maximo® Anywhere system requirements.
    1. Download the Java™ SE Development Kit for your operating system.
    2. Run the executable file and complete the installation program.
  2. Create an Apple ID by registering as an Apple developer in the Apple Registration Center.
  3. Download and install Xcode IDE, including the iOS SDK and Simulator, from the Mac App Store.
  4. Add your Apple ID to Xcode.
  5. If you are the team agent, in Xcode create the certificate for the distribution provisioning profile. Download the certificate to your local environment.
  6. Register the App IDs.

    Create a unique ID for each app that you support. The app ID that you specify must be unique: Apple does not allow duplicate app IDs.

    The following table contains examples of bundle IDs that can be specified for the Maximo Anywhere apps. Replace the company_name value with your company name.

    App name Example bundle ID
    IBM® Maximo Asset Auditor com.company_name.maximoanywhere.AssetAudit
    IBM Maximo Asset Manager com.company_name.maximoanywhere.AssetDataManager
    IBM Maximo Inspector com.company_name.maximoanywhere.Inspection
    IBM Maximo Issues Returns com.company_name.maximoanywhere.IssuesReturns
    IBM Maximo Cycle Counts com.company_name.maximoanywhere.PhysicalCount
    IBM Maximo Service Requestor com.company_name.maximoanywhere.ServiceRequest
    IBM Maximo Transfers Receipts com.company_name.maximoanywhere.Transfers
    IBM Maximo Supervisor com.company_name.maximoanywhere.WorkApproval
    IBM Maximo Technician com.company_name.maximoanywhere.WorkExecution

    To specify an identifier to represent a single app, click Explicit App ID and enter a unique ID for the app. Repeat this step for each app that you support.

  7. From the maximoanywhere_home\MaximoAnywhere\apps\app_name directory, open the application_descriptor.xml file and change the bundle ID strings to match the bundle IDs that you created.
  8. To support command line builds of our app, you must create a distribution provisioning profile. Ensure that you select the distribution certificate when creating this provisioning profile.
    1. Create a distribution provisioning profile for each app by using Member Center. When you generate a distribution provisioning profile, you are not required to provide IDs of the devices.
    2. Download each app's provisioning profile to your Mac OS X computer. Every time that a provisioning profile is updated, you must download the profile to the build server.
    When you run the app build and deployment process, the provisioning profiles are collected and stored in the iOS application archive file (IPA).
  9. Run the following command: 
    ./build.sh all
  10. Optional: To test the app on a local device using Xcode, you must register the Device IDs for all of your test devices. You must also create a Developer Provisioning Profile for the app. While creating the provisioning profile, ensure that you select your developer certificate while creating the app and also the Device IDs of your test devices.
    1. Create a developer certificate for a development provisioning profile. Download the certificate and add it to the Keychain application.
    2. Register the Device IDs in Member Center. You can locate the unique device identifier (UDID) by connecting your device to the Mac OS X computer while Xcode or iTunes are running.
    3. Download the developer provisioning profile to your Mac OS X computer.