Building an Apple iOS* Binary
Use the Intel XDK development environment to develop, debug, and test your project's app. After you successfully test your app using the Test tab in the Intel XDK and App Preview on your device(s):
- Select the project for the app you want to build.
- Click the Intel XDK Build tab.
- Under Legacy Hybrid Mobile App Platforms, click the button under either:
- iOS Ad Hoc to build an iOS binary you can use for testing.
- iOS Production to build an iOS binary you can submit as a final app to the Apple store.
If you want to see exactly how your app name will appear on device when users install it from the App Store, build an Ad Hoc version first to verify you are happy with the way it looks.
- Before your app can be built in the cloud, your code will be packaged as a bundle and uploaded. If a previous build is found, you can decide whether to use the previous upload (Use Previous) or upload your most recent code (Upload Code) .
- After uploading your app bundle, review the dashboard for Details, Assets, Plugins, Credentials, iOS Certificate, Push, and Provisioning information in the Overview screen. For a new app, you need to answer a series of questions to provide the app title, icons, splash screens, and related information. To review or edit this information, click the step name near the top (such as 1 Details) or click the button in the right column.
For each build step that was set up previously, you should see a green check mark and Step Complete indicator. If not, the condition will be indicated by a red Step Incomplete indicator. In this case, click to display the incomplete build information, which is described below.
Later, when each of the steps has a green checkmark, you can build your app to create an iOS binary for your iOS device.
Apple iOS Build Settings: Details, Assets, Plugins, Credentials, iOS Certificate, Push, and Provisioning
To make iOS binary builds, you must first register to obtain an iOS developer account with Apple. To purchase an iOS developer account, point your browser to http://developer.apple.com.
Once you have an iOS developer account, and you are ready to create an actual binary file for your iOS device, open the Intel XDK.
For this tutorial, we will walk through each step individually. Instructions are also provided within the Build tab.
On the Details tab, you will be asked to provide the title of your application as it will appear on the device. By default, the rightmost portion of your project name is used. For example, if your project name is testuser.exampleios, the default app name will be exampleios. Be aware that on iOS devices, if the name is too long it will be truncated with an ellipsis. As a rule of thumb, we suggest keeping the application name less than 19 characters.
You are asked to set a couple of application background settings. Unless you specifically have an app that you would like to be able to serve audio even when relegated to the background, leave the first background setting button selection to OFF. It is possible Apple could reject your app if you toggle this to “ON” and do not actually use the background audio feature. The second setting allows you to specify if you want the application to stay loaded and running in the background when another app is started on the device.
You will also provide the device configuration and operating systems your app is targeting. If your application is sized only for an Apple iPhone* or iPad* device, select the appropriate device. Otherwise, if you have written your device to size dynamically between the two devices using the AppMobi.display.useViewport command or a method of your own making, select the iPhone+iPad option. Always choose the most up-to-date operating system, unless you know for certain that you need to support legacy devices. Be aware that selecting older operating systems may limit the functionality available to your application.Finally, you will select the code base you wish to build with.
These options are available:
- GOLD – The current fully tested, publicly available code base that contains complete support for all Intel APIs.
- LEAN – The current fully tested, publicly available code base that contains limited support for Intel APIs. Items NOT supported are streaming shoutcast or mp3 support, barcode scanning support, rich media push viewer support, and App Game Interfaces (AGI) support.
- LEAN WITH APP GAME INTERFACE – The same as LEAN but App Game Interfaces are supported.
Choosing either of the LEAN options will reduce the size of your binary. One of these is recommended if your application does not require support for the excluded items.Once you have completed all items, click the button. This displays the Assets step.
To complete your build, you will need a series of assets such as launch icons and splash screens.
On this tab, you have an option to create your application for landscape or portrait mode. Once you have the initial orientation set, you will need to upload the appropriate assets for the application. By default, a set of Intel XDK icons are used. This allows you to build and test without creating your own specific assets. Once you are ready to publish your application, you can upload your own asset files from this screen. As a starting point, you can download sample templates and directions for creating your own. The size and file format specifications for each asset are provided on the screen. You can drag and drop files into each Assets Submission field.
Once you have completed all items, click the button. This displays the Plugins step.
You can include custom native code known as “plugins” into your build.
To learn more about legacy plugins, download the plugin documentation here:
If your application requires native plugins, set the toggle switch to ON. Next, click the button to display a screen where you can add information about your plugin and create it.
After entering the information, click Create.
Once you have completed all items, click the button. This displays the Credentials step.
In this step, provide your Facebook credentials if you want your app to be available as a Facebook application. You will provide your Facebook Application ID which is required, and Facebook requires an additional layer of security for iOS apps in the form of an application signature. A signature is provided that you may then use in the Native iOS App section of the Facebook App Dashboard.
Once you have completed all items on this screen, click the button to display the Push step.
If you have never used the iOS platform build system before, you will be asked to download a signing certificate to create your certificate and private key pair. Follow the steps described in 5a by selecting the Screenshot Walkthrough link, and then click Download to retrieve the signing request.
Next, you will be asked to upload the certification you downloaded from the iOS Dev Center* site to the build process.
Finally, you will create an application ID on the iOS Dev Center site. Those directions are outlined in the screenshot walkthrough link included in step 5c of this panel. Once you have completed the steps to obtain an app ID, move the toggle switch to the “YES” position so that the build system knows you have completed that step.
Once you have completed all items, click the button. This displays the Push step.
By default, all new apps are configured without push messaging. To use push messaging with iOS devices, you must obtain and upload a push certificate. To do so, click the radio button for Configure this app for push messaging. Otherwise, proceed to the next step.
If you want to configure push messaging, the screen will be expanded to allow you to enter additional information required.
|NOTE: Once you check the radio button for Configure this app for push messaging and click the button, you cannot easily undo this action. To uncheck Configure this app for push messaging, either click the Close Build Page button below the Projects tab, or close the project and reopen it.|
Next, you will be asked to upload the certificate you downloaded from the iOS Dev Center site to the build process.
Once you have completed all items, click the button. This displays the Provisioning step.
Once you have completed all items on this screen, congratulations, you are ready to build. Click the button. This will take you back to the to the Overview screen, where the green Build App Now button will be available if each of the steps has been completed.
On this panel, you will specify the application target destination of your build, either Ad Hoc (testing) or Distribution (for submission to the Apple App Store). Follow the instructions shown by clicking on the screenshot walkthrough link in step 7b to create and upload a Distribution Provisioning Profile.
Build Your App
In the Overview screen, when the green Build App Now button appears, click the Build App Now button. A status indicator will show that the build is occurring:
If any build errors are detected, you will be notified. Once your binary is successfully built, a build successful screen appears.
For an Ad Hoc build, the screen provides a button to download your build and provides instructions on how to load your app on a device for testing. An email will be automatically sent to the email address for which you are logged in. This email will contain a link which will allow for Over The Air (OTA) installation of your Ad Hoc app. You can also send build notifications to additional email addresses.
For a Distribution build, the screen provides a button to download your build and provides some basic instructions on how to submit it to the Apple App Store*. A successful build email will be automatically sent to the email address for which you are logged in. You can also send build notifications to additional email addresses if desired. For example:
To download your application to your device, either:
- On your iOS device, open the email sent to the Intel XDK account for your successful build and click the link of your app's URL.
- On your development system, click on the Download Build button and transfer the binary file to your iOS device by copying it over a wired connection or email it to your device. Once you have the binary iOS file on the device, select it to install the test application.
The email address associated with your Intel XDK account will receive an email notifying you of the successful build with a link to your app's URL. To send an email to others containing a link to your app's URL, type an email address at the bottom of the window and click the Send button.
When done, click the Close button at the bottom of the screen to return to the Overview screen.
To build for a different platform or to otherwise, return to the Intel XDK Build tab, click the Close Build Window button in the upper-left corner.
Deploy Your App
Open the following web site to begin the process of adding your app to the Apple store: http://developer.apple.com. If you have not done so already, sign into your Apple Developer account.
For each app, you need to upload the binary file and provide your app's title (name) and store information. The store information includes the title, description, the app category, promotional text, icons and screen shots. Also specify the price and where the app can be distributed.
- Using the Build Tab
- Using the Projects tab
- Understanding the Intel XDK Cordova Build Files
- Adding Plugins to Your Intel XDK Cordova App