Running Mobile Projects

This procedure explains how to test a CCM client-side project by running your Web Mobile application using the CordovaSim emulator. The CordovaSim emulator is a light-weight mobile application simulator that allows you to preview your mobile application during and after development.

CordovaSim loads faster, runs faster and consumes less memory, and is ideal for quickly testing small changes during the development cycle. It also provides a control panel for easily simulating events through the Cordova API.

More about CordovaSim...

Instructions on how to complete a procedure

To test on the CordovaSim emulator:

Create a new mobile project. See Creating a New Hybrid Mobile Project or Creating a New Cloud Connected Mobile Project for more information.
In the PHP Explorer, right-click your mobile project or the 'index.html' file, and select Run As | Run with CordovaSim.
The application is displayed in the simulator, and the CordovaSim control panel is opened.

To configure launch settings, right-click the project in the PHP Explorer, and select Run As | Run Configurations.
You can configure the project which is to be launched, starting page (default- www/index.html), and the screen resolution.

Running as a Native Android Application

Using the Android mobile device emulator or on an actual device, you can test your mobile project as a native mobile application.

Prerequisites

Existing Mobile project. See Creating a New Hybrid Mobile Project or Creating a New Cloud Connected Mobile Project for more information.

Installed Android SDK:
1. Go to http://developer.android.com/sdk/index.html#download
2. Click Use an Existing IDE. (On Ubuntu 13.10 only - scroll down to SDK Tools Only, and download Linux package).
3. Click the Download button.
4. Once installed, open the SDK Manager and install Android 4.2.2 (API 17) and Android 4.3 (API 18).

Note:

Using ADT on Linux 64-bit requires installation of ia32-libs. To do this, run:
sudo apt-get update
sudo apt-get install ia32-libs
For Fedora 64-bit (RPM), install redhat-lsb.i686. To do this, run:
sudo yum install redhat-lsb.i686

Running Applications On the Android Emulator

The Android SDK includes a mobile device emulator - a virtual mobile device that runs on your computer. The emulator lets you develop and test Android applications without using a physical device. Click here for more information on the Android Emulator.

Instructions on how to complete a procedure

To run an Android application on the Android Emulator:

In the PHP Explorer, right-click your mobile application and select Run As | Run Configurations.
The Run Configurations dialog is displayed.

In the list of available running options, double-click Android Application.

Name your new configuration.
In the Project field, click Browse and select your mobile project.
Under Settings, verify that 'android-17' or 'android -18' are selected as your Android platform. If not, click Manage, and use the Android SDK Manager to install these components.
As your Target, select Android Virtual Device.
If you have already created an Android Virtual Device (AVD), click the Android Virtual Device drop-down menu, and select an existing device (skip to step 11).
If not, click Manage.
The Android Virtual Device (AVD) Manager is displayed.

Click New.
The Create New Android Virtual Device (AVD) dialog is displayed.

Configure the new AVD:
Tip:
For quicker results, we recommend selecting a small screen (Device), and adding memory and VM heap (Memory Options). For more information on managing AVDs, see http://developer.android.com/tools/devices/managing-avds.html.
Click OK.
The new AVD is created, and added to the Android Virtual Device drop-down menu in the Run Configurations dialog.
Click Run.
The application is displayed in the Android emulator.

If your application fails to run on the emulator, check if the ARM System Image is installed on your Android SDK:

Open the Android SDK Manager and view installed packages. Install the package if it not installed, and repeat the procedure above.

Running Applications On a Device

This option allows you to run your Android native application on an actual device from within Zend Studio.

Instructions on how to complete a procedure

To run your Android application on an actual device:

Connect your Android device to your machine.
In the PHP Explorer, right-click your native project, and select Run As | Run on Android Device.
Your Android application is launched on your device.

To configure the Android launch device and emulator settings, right-click the project in the PHP Explorer, and select Run As | Run Configurations.

Running as a Native iOS Application

Using the iOS Simulator or on an actual device using Xcode, you can run your mobile project as a native iOS application.

Note:

Only available for Mac OS X.

Prerequisites

Existing Mobile project. See Creating a New Hybrid Mobile Project or Creating a New Cloud Connected Mobile Project for more information.
Installed Xcode. Click here to download and install.
To test on an actual device:
- Registered iOS developer. Click here to register.

Running Applications On the iOS Simulator

The iOS Simulator presents the iPhone or iPad user interface in a window on your computer. The simulator provides several ways to interact with it by using the keyboard and mouse to simulate taps, device rotation, and other user actions. Click here for more information on the iOS Simulator.

Instructions on how to complete a procedure

To run an iOS application using the iOS Simulator:

In the PHP Explorer, right-click your native project, and select Run As | Run on iOS Emulator.
The application is displayed in the iOS simulator.

To configure launch settings, right-click the project in the PHP Explorer, and select Run As | Run Configurations.

You can configure the project to be launched, the SDK to be used in the iOS simulator, and the device family (iPhone, iPad).

Running Applications On a Device

This option allows you to run your iOS native application on an actual device from within Zend Studio.

Instructions on how to complete a procedure

To run an iOS application on an actual device:

Connect your device to your machine.
Right-click the project in the PHP Explorer, and select Open in Xcode to open the iOS project directly in Xcode.

Running as a Native Windows Phone Application

Using the Windows Phone emulator, MS Visual Studio, or an actual device, you can run your mobile project as a native Windows Phone application.

Prerequisites

Existing Mobile project. See Creating a New Hybrid Mobile Project or Creating a New Cloud Connected Mobile Project for more information.
Installed Windows Phone SDK. Click here to download and install.
To test on an actual device:
- Installed Zune. Click here to download and install.
- Registered Windows Phone developer. Click here to register.

Running Applications On the Windows Phone Emulator

The Windows Phone emulator emulates a Windows Phone 8 or a Windows Phone 8.1 device. It provides a virtualized environment in which you can develop, debug, and test Windows Phone applications. It also provides an isolated environment for early application prototypes. By using the emulator, you can proceed through the common application development scenarios without a physical device. This can reduce the cost of developing applications for Windows Phone.

Instructions on how to complete a procedure

To run a Windows Phone application using the Windows Phone emulator:

In the PHP Explorer, right-click your mobile project, and select Run As | Run on Windows Phone 8 Application.
The application is displayed in the Windows Phone Emulator.

Tip:

If you have modified your project and want to test your updates simply re-select Run as | Windows Phone 8 Application, and the updated application will be deployed to your running emulator. There is no need to close and re-launch the emulator.

Your Windows Phone application can also be run in the Microsoft Visual Studio. To do this, right-click the application in the PHP Explorer, and select Open in Visual Studio.

Running Applications On a Device

This option allows you to run your Windows Mobile native application on an actual device from within Zend Studio (MS Visual Studio does not need to be opened).

Important:

See Prerequisites above.

Instructions on how to complete a procedure

To run a Windows Mobile application on an actual device:

Launch Zune.
Connect your Windows Phone device to your machine, and make sure the device is recognized by Zune. Click here for troubleshooting the connection process.
In Zend Studio, in the PHP Explorer, right-click your native project, and select Run As | Windows Phone 8 Application | On Device.
The application is launched on your Windows Phone device.

	Read Also
	Cloud Connected Mobile
	Creating a New Cloud Connected Mobile Project
	Creating Native Applications