2 Setting Up the Development Tools for the iOS Platform

This chapter provides information on setting up and configuring development tools for the iOS platform. Install Xcode and the iOS SDK so that you can deploy the MAF applications developed in JDeveloper to an iOS device or simulator.

This chapter includes the following sections:

2.1 Installing Xcode and iOS SDK

Download and install Xcode. The download includes the iOS SDK.

Download Xcode from http://developer.apple.com/xcode/.

After installing Xcode, you have to run it at least once and complete the Apple licensing and setup dialogs. If these steps are not followed, the build and deploy cycle from JDeveloper to Xcode or a device simulator fails with a "Return code 69" error.


Older versions of Xcode and iOS SDK are not available from the Apple App Store. To download older versions:
  1. Obtain an Apple ID from http://appleid.apple.com.

  2. Register the Apple ID with the Apple Developer Program to access the Apple developer site at http://developer.apple.com.

2.2 Specifying the iOS Settings in MAF

Specify the iOS platform settings in JDeveloper so that you can deploy a MAF application to the iOS platform.

For the iOS platform, you can specify preferences using the GUI or command line.

2.2.1 Using the GUI

To configure your environment for the iOS platform:

  1. Ensure Xcode and iOS SDK are installed.
  2. In JDeveloper, click Tools, and then click Preferences.
  3. In the Preferences dialog, click Mobile Application Framework and then click iOS Platform.
  4. Enter the signing information and export options.
    for more information, see Setting the Device Signing Options in Developing Mobile Applications with Oracle Mobile Application Framework.

2.2.2 Using the Command Line

You can set MAF preferences required to develop MAF applications by specifying startup parameters when you start JDeveloper.

To launch JDeveloper from the command line with startup parameters, use the -J-D options. All strings must be enclosed in double-quotes, as shown in the examples.

The following example shows how to override the provisioning profile name.
 ./jdev -J-Doracle.adfmf.framework.dt.preferences.PlatformSDKsPrefs.iosProvisioningProfileName="Oracle ENT1 2017”

These are the startup parameters you can use to set iOS preferences from the command line:

  • oracle.adfmf.framework.dt.preferences.PlatformSDKsPrefs.iosProvisioningProfileName

  • oracle.adfmf.framework.dt.preferences.PlatformSDKsPrefs.iosProvisioningProfileTeamIdentifier

  • oracle.adfmf.framework.dt.preferences.PlatformSDKsPrefs.iosCertificate

  • oracle.adfmf.framework.dt.preferences.PlatformSDKsPrefs.iosExportMethod

2.3 Setting Up an iOS Device or Simulator

To deploy MAF applications, connect an iPhone or iPad to your development computer or configure external network access to use iOS simulators, included in XCode downloads.

In your MAF application development and deployment, you can use either the iOS-powered device itself or its simulator.
Deployment method Description
Device (iOS-powered)

Deploying to an iPhone or iPad is preferable for testing.

You must connect the device to your computer to establish a link between the two devices. Also, you need to have an iOS-powered device with a valid license, certificates, and distribution profiles. See Deploying Mobile Applications in Developing Mobile Applications with Oracle Mobile Application Framework.


Since the Apple licensing terms and conditions may change, ensure that you understand them, comply with them, and stay up to date with any changes.

Simulator Deploying to a simulator is usually much faster than deploying to a device, and it also means that you do not have to sign the application first. Before attempting to deploy your application from JDeveloper to a device simulator, you must first run the simulator. A simulator can be invoked automatically, without any additional setup.

2.4 Testing the iOS Environment Setup

Deploy a MAF sample application to test that you set up your iOS environment successfully.

You can test your environment setup as follows:
  1. In JDeveloper, open the HelloWorld sample application.

    See MAF Sample Applications in Developing Mobile Applications with Oracle Mobile Application Framework.

  2. Select Application, and then click Deploy from the main menu.
  3. From the dropdown menu, select the deployment profile for the iOS platform.
  4. Select Deploy application to simulator in the Deploy dialog.
    Using an iOS-powered device simulator test the environment setup is preferable because it does not require signing of the application.

    Figure 2-1 Selecting Deployment Action for iOS

    Description of Figure 2-1 follows
    Description of "Figure 2-1 Selecting Deployment Action for iOS"
  5. Click Next on the Deploy dialog to verify the Summary page, and then click Finish.

See Deploying Mobile Applications in Developing Mobile Applications with Oracle Mobile Application Framework.

After a successful deployment (which might take a few minutes), the device to which you had deployed the application displays the launch screen of the HelloWorld application, and then displays the default application feature.