Mobile Development Environment (Magic xpa 2.x)

The Android and iOS platforms provide a managed, controlled process for installing native applications on the mobile devices. Each Magic application that you want to deploy on these platforms must be packaged as a separate, self-contained application with its unique name, icon and application properties. The process of building an application involves editing configuration files and running a “build” tool that creates a new, unique application that embeds the Magic RIA client engine. This application can then be deployed on the mobile devices using the supported distribution mechanisms.

Minimum requirements for mobile devices

It is recommended to use the following devices for demo and testing purposes:

Android

• Smartphone: Android 2.3.3 and above

• Tablet: Android 3.2 and above

iOS

• Smartphone: iPhone 3GS and above running iOS 6.0 and above

• Tablet: iPad 2 and above running iOS 6.0 and above

BlackBerry

• Tablet: BlackBerry Playbook 2.0 or BlackBerry 10

The BlackBerry Playbook and BlackBerry 10 can run the Magic xpa RIA client for Android. Refer to https://bdsc.webapps.blackberry.com/android/ for further information.

Magic xpa server configuration

The Magic xpa server must run in Background deployment mode in order to handle requests from the mobile RIA client.

Connecting your mobile device to the server

To run your application on a mobile device, the device must have access to your server.

You can do this in several ways:

1. Use the WiFi capabilities of the device to connect your device to the same network as your local machine.

2. If your device supports USB tethering you can connect the device to your machine, enable the USB tethering and then use the IP address that was given to your machine as the server address.

3. If you develop on a machine that has WiFi capabilities, you can use that WiFi to turn your machine into a wireless hotspot and connect your device to that hotspot.

For further information, refer to the Testing an Application on a Mobile Device Technical Note.

Mobile device simulators

You can use the platforms’ device simulators to test your application. However, the simulators’ features are limited compared to real devices and the simulators might behave differently. Therefore, it is recommended to develop and, especially, test your application using a real device.

Android

The Android emulator can run on any Windows desktop.

To run the Android emulator, you need to download and install the Java SE Development Kit (JDK) 5 or 6 and the Android SDK.

To see a video demonstration about installing the Android emulator, click here.

Note that the JDK is installed automatically during the Magic xpa installation if you installed the Web Services component during the Magic xpa installation.

You can download them from:

• http://www.oracle.com/technetwork/java/javase/downloads/index.html

• http://developer.android.com/sdk/index.html

Android SDK Manager

During the installation of the Android SDK, the Android SDK manager will be launched.

Select the Android versions that you want to test your application on. For each version you need to select at least the SDK Platform component.

To create a custom application, you need to install all of the items listed below:

• Android 4.0.3 (API 15) SDK

• Android SDK Tools revision 19 or above

• Android SDK Platform-tools

• Android SDK Build-tools (Android SDK Build-tools is available from Android SDK Tools revision 22)

Note: Additional information about the components can be found at: http://developer.android.com/sdk/installing.html.

If a proxy needs to be used, define it in the Tools>Options menu.

Continue with the installation by clicking on the Install XXX Packages button.

After installing the SDK platforms, click the Tools menu and start the Manage AVDs entry in order to configure the Android emulator and virtual environment.

Android Virtual Device Manager

In the Android Virtual Device Manager screen’s Android Virtual Devices tab, add a new device and specify:

• Name – The name for the virtual device.

• Device – The device itself.

• Target – Choose the Android version, for example: Android 2.2. You will see different Android versions depending on the SDK versions installed in the SDK Manager.

• SD Card Size – Define a size for the SD card, for example: 20.

You can also define these settings in the Device Definitions tab and then click the Create AVD button.

After the device creation is complete, the device will be added to the list. Select the device and click Start to run the emulator.

Note:

• Additional information about the emulator can be found at: http://developer.android.com/guide/developing/devices/emulator.html.

• An alternative emulator can be downloaded from: https://cloud.genymotion.com/page/launchpad/download/. This emulator is actually a virtual machine running virtual Android devices. After downloading and installing the virtual machine, follow the wizard to download and install Android devices. Note that this emulator is faster than the native Android emulator.

iOS

The iOS simulator runs only on Mac OS computers and requires the iOS development environment (Xcode) of version 5.0.

To run the simulator, open the project in Xcode, set the Scheme combo box (on the top left side) to the required device (for example: iPad 5.0 Simulator) and click the Run button.

BlackBerry PlayBook and BlackBerry 10

The BlackBerry PlayBook and BlackBerry 10 simulator can run on any Windows desktop.

You can download and install a BlackBerry PlayBook and BlackBerry 10 device simulator from: https://developer.blackberry.com/devzone/develop/simulator/simulator_installing.html.

The use of BlackBerry PlayBook Simulators and the BlackBerry 10 Simulator requires the installation of a VMware Player.

You can download and install a VMware Player from: http://www.vmware.com/products/player.

After the installation, you can run the simulator from the Start menu. For example: Start \ BlackBerry 10 Simulator \ BlackBerry BlackBerry 10 Simulator - BB10_1_X-807 \ BlackBerry 10 Simulator.