Unsupported content This version of the documentation is no longer supported. However, the documentation is available for your convenience. You will not be able to leave comments.

Distributing applications to iOS devices

This topic provides information for administrators who need to distribute BMC Remedy ITSM - Mobility: Service Desk applications over-the-air (OTA) to iOS devices. 

To distribute applications for iOS devices

  1. Unzip the ClientDistribution.zip file that you received from BMC on on a computer that is running the Apple Mac OS operating system.
     A ClientDistribution folder is created.
  2. Join the iOS Developer Enterprise Program, and create certificates and a provisioning profile for the BMC Remedy ITSM - Mobility: Service Desk Incident Management or Approvals application, as follows:
    1. Go to the iOS Developer Enterprise Program website.
    2. From the Apple Developer Portal, obtain a Distribution developer certificate that allows you to sign applications. You need to create a Distribution Certificate.
      currentdistribution.png
    3. Create a new App ID as the bundle identifier. This is the ID of the Mobility application.
      1. For Incidents, use the string com.bmc.nextgenmobile.IncidentsMobile as the bundle identifier.
      2. for Approvals, use the string com.bmc.nextgenmobile.ApprovalsMobile as the bundle identifier.
    4. Obtain a provisioning profile that identifies the Mobility application Incident Management or Approvals). Create a Distribution profile that identifies the Incident Management application. You need to create a Distribution Profile.
      iosprovisioning.png
    5. Obtain the certificate for using OS push notification as follows:
      1. Configure the App ID that you created in step 2c.
        configure.png
      2. Create the Push SSL certificate for production.
    6. Download the developer certificate, Push SSL certificate, and provisioning profile to your local computer, and save them in the certificate folder, which is inside the ClientDistribution folder.
    7. Create P12 files from the distribution developer certificate as follows:
      1. In the certificate folder, double-click the developer certificate to add the certificate to the keychain.
      2. In the Keychain Access utility, navigate to Certificates.
         The developer certificate should be listed.
      3. Expand the certificate.
         A private key should be listed.
      4. Right-click the private key and select Export.

        keychainaccess.png
      5. Assign a file name, the location to save the file, and select the file format to be Personal Information Exchange (.p12).
      6. Click Save.

        keychainaccess2.png
      7. In the dialog box that appears, create a password for the P12 file. You must enter this password when you use this certificate to sign applications.
    8. Create a P12 file from the Push SSL certificate as follows:
      1. In the certificate folder, double-click the Push SSL certificate to add the certificate to the keychain.
      2. Navigate to Certificates.
         The Push SSL certificate should be listed.
      3. Expand the Apple Production iOS Push Service.
         A private key should be listed.
      4. Select the certificate and key.
      5. Right-click the certificate and key and select Export to export the certificate to P12 format.

        keychainaccess3.png
      6. In the dialog box that is displayed, create a password for the P12 file. You must enter this password when you use this certificate to push notification.
  3. Download the Adobe Flex SDK 4.6 and the Adobe Air SDK from the following URLs:
  4. Unzip the two SDK files and merge all of the folders in the Adobe Air SDK into the Flex SDK.
  5. Copy the merged Flex SDK folder to the ClientDistribution folder.
  6. Go to the appropriate file:
    • For Incident Management, go to the buildIncidentsMobile.sh file.
       The shell script is available in ClientDistribution/IncidentsMobile/ios.
    • For Approvals, go to the buildApprovalsMobile.sh file.
       The shell script is available in ClientDistribution/ApprovalsMobile/ios.
  7. Update the following four variables with the App ID that you registered in step 2c:
    • KEY_STORE
    • STORE_PASSWORD
    • PROVISION_PROFILE
    • FLEX_SDK_DIR
  8. Run the appropriate batch file to create the ipa file in the ClientDistribution/IncidentsMobile or ClientDistribution/ApprovalsMobiledirectory, as appropriate. (It may take 10 - 15 minutes for this step to complete.)
    • For Incident Management, run the buildIncidents.sh batch file.
    • For Approvals, run the buildApprovalsMobile.sh batch file.
  9. Upload the appropriate files and folder to a web server for web distribution.
    • For Incident Management, upload the index.html, IncidentsMobile.plist, IncidentsMobile.ipa files and the icons folder from the ClientDistribution/IncidentsMobile folder.
    • For Approvals, upload the index.html, ApprovalsMobile.plist, ApprovalsMobile.ipa files and icons folder form the ClientDistribution/ApprovalsMobile folder.
  10. Update the appropriate files to provide the correct URL.
    • For Incident Management, update the index.html, and IncidentsMobile.plist files, to provide the URL of the IncidentsMobile.plist, IncidentsMobile.ipa files and the icon folder.
    • For Approvals, update the index.html, and ApprovalsMobile.plist files, the to provide the URL of the ApprovalsMobile.plist, ApprovalsMobile.ipa files and the icon folder.

Note

For more information about configuring an iOS Distribution Certificate, see the Configuring Development and Distribution Assets section of the Tools Workflow Guide for iOS in the Apple iOS Developer Library.

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*