Installing an Application on a Mobile Device or Simulator (Magic xpa 2.x)

You can install the RIA application on your device or simulator as follows:

Android

There are several ways to deploy the application on Android:

• Run the APK file on your device (for example, by receiving the APK file as an email attachment and clicking on it).

• Over-the-Air – Click the Browse icon and browse to a server where the APK file exists, for example: http://192.168.13.1/PublishedApplications/myapp/my.apk. Then, click the Downloads icon and download your application.
  
  For this to work, you need to put the APK file on an exposed folder on the web server. If the application does not run, configure the web server to support download of the APK file as follows:
  
  Open the Internet Information Services (IIS) manager, navigate to the Default Web Sites, open the Mime Types and add a new one as follows:

• Extension=.apk

• MIME type=application/vnd.android.package-archive

• Upload your application to the Android market.

• Using the Android Debug Bridge (ADB) utility – when installing on a simulator or on a device using a cable or over WiFi.
  
  To install your APK, run the following command: adb install –r my.apk.
  
  For further information regarding the ADB utility, refer to Using the Android Debug Bridge (ADB) Utility.

iOS

There are several ways to deploy the application on iOS:

• Double click on the IPA file to add it to iTunes. Once in iTunes, simply synchronize it to your device.

• Over-the-Air (require compilation with an Enterprise account) – Browse to a URL page.
  
  Over-the-Air installation requires having the following files on an exposed folder on the web server:

• The application (.ipa) file.

• The manifest (.plist) file.
  
  Any information written in the manifest file, such as app name and version, overrides the application information written in the customization step.
  
  Note: A sample file, manifest.plist, is located in the %EngineDir%\RIAModules\iOS folder, so you can simply edit this file and define the properties and location of your application.

• A web page (.html) file with the following line in it: <a href="itms-services://?action=download-manifest&url=https://example.com/manifest.plist">Install App</a>
  
  The manifest.plist file refers to the application's IPA file.
  
  Note:

• • A sample file, install.html, contains this line and a sample manifest.plist file are located in the %EngineDir%\RIAModules\iOS folder, so you can simply edit them.

  • The Rich Client Deployment Builder also generates these files.

  • Spaces are not allowed in the IPA file name and the PLIST file name.

  • With the launch of iOS 7.1, Apple requires all enterprise apps' manifest files to be served over HTTPS. Attempts to install through HTTP show the following message: “Cannot install applications because the certificate is not valid”. You can use Dropbox to resolve this issue. For more information, see How Do I Expose the iOS Enterprise Installation Files Using Dropbox?.

You also need to configure the web server to support the download of the IPA and PLIST files as follows:

Open the Internet Information Services (IIS) manager, navigate to the Default Web Sites, open the Mime Types and add two new items as follows:

• Extension=.ipa

• MIME type= application/octet-stream

• Extension=.plist

• MIME type= text/xml

For additional information refer to: http://developer.apple.com/library/ios/#featuredarticles/FA_Wireless_Enterprise_App_Distribution/Introduction/Introduction.html

• Upload your application to the Apple market.

• Use 3rd party websites, such as TestFlight (http://testflightapp.com).

Note: After deploying the application client, there is no need to redeploy it after every application change. The application itself is not packaged as part of the client. All application changes are downloaded and updated automatically, just like any other Magic RIA application. A change is only required when you want to upgrade the core client version, that is, for a newer Magic release).

BlackBerry PlayBook and BlackBerry 10

For development purposes, you can use the blackberry-deploy utility available in the BlackBerry SDK tools.

• When deploying on BlackBerry Playbook devices, open the security settings of the Playbook and enable debug mode. You will see an IP on this screen.

• Open the windows command prompt and navigate to the %EngineDir%\RIAModules\Utils\blackberry.tools.SDK\bin folder.

• Run the following command: blackberry-deploy -installapp <ip> -password <pass> <bar file>
  
  For example: blackberry-deploy -installapp 169.254.0.1 -password 123 c:\PlayBook\dev.bar