This page describes how to setup the underlying native SDKs when building a RhoMobile application locally for our supported platforms: iPhone, RIM Blackberry, Windows Mobile and Android.
In order to build an iOS application locally, it must be performed on a Macintosh computers or by using RhoHub using any type of type of laptop/desktop. The instructions below describe how to do this from either the Macintosh Xcode development environment or from the command line on your local Macintosh.
To build for iPhone/iPad using you will need the following software installed:
Note: In XCode 4.3, command line tools are not included in the installation. You should install the command line tools from XCode by using the Components tab of the Downloads preferences panel. See New Features in Xcode 4.3
Check that your OS is compatible with the Android SDK.
1) Download the Android SDK, and unzip it to the location of your choice.
Note: A minimum Android API level 10 must be installed.
On Macintosh and Linux, navigate to and run
<Android SDK>/tools/android sdk. On Windows, navigate to and run
Note: To use Google Map View you need to install latest Google API from Android SDK Manager
2) Download and unzip the latest Android NDK to the location of your choice.
Note: You should update the Android SDK and NDK as you update to new versions of Rhodes. Android NDK version r8e is required as a minimum.
|RMS 5.1 does not support Android NDK r10; Android NDK r9 is current recommendation.|
Download Android NDK r9 from Google’s servers:
3) The Android Support Library must be installed using the latest version. (Minimum Rev 14). This can be installed using the Android SDK Manager under the
In RhoStudio –> Preferences on the Macintosh or Windows –> Preferences on Windows, open Rhomobile->Android and set the paths to your Android SDK and NDK installations.
If you are not using RhoStudio, run rhodes-setup from the command line and set the paths to the Android SDK and NDK installations.
In case you are planning to work with native geo mapping (the MapView interface), you must do two things:
Retrieve the Android Maps API key from Google. Follow these instructions to get it. When key received, put it in your application’s
build.yml or share it across all your applications by adding it to
rhobuild.yml. Note that the
apikey value must match a certificate used to sign an application (the key is different for debug and production signed build and debug key cannot be shared between different build computers).
Enable ‘mapping’ in your application’s
build.yml (or in
<rhodes-root>/rhobuild.yml). In RhoStudio, you can double-click on your application’s build.yml and edit from the text editor; otherwise, you can edit rhobuild.yml or build.yml from another text editor.
Note that Windows Mobile versions of your Rhodes application must be built in a Windows environment.
Make sure you have installed the following software. Since Rhdoes builds a unified .cab file for both WM and WinCE, only the WinCE SDK is necessary for building either platform.
Note: It is a good idea to install Windows Mobile 6 Professional last, since it needs to be installed after Visual Studio, and since the Windows Mobile 6 Professional install process will tell you if you forgot to install any of the other prerequisites.
Visual Studio 2012 SP1 (or 2008 SP1)
VS90COMNTOOLS) environment variable is defined and points to the correct location, e.g. to
C:\Program Files (x86)\Microsoft Visual Studio 11.0\Common7\Tools
Create new (or update existing) system environment variable
QTDIR and make sure it points to root folder of the installed Qt libraries, e.g.
Note: If the application uses HTTPS, the Qt binaries must be built against OpenSSL. Please refer to Build for Windows for instructions and links to Zebra’s pre-built Qt binaries.
Visual Studio 2013 installed or VS Express 2013 for Windows Phone
Add path to
rhobuild.yml in rhodes folder. Use 32-bit version compiler to build for device.
env: paths: msbuild: C:/Program Files (x86)/MSBuild/12.0/Bin/MSBuild.exe