Warning Older Docs! - You are viewing documentation for a previous released version of RhoMobile Suite.

Install RhoMobile Suite

The RhoMobile Suite installer installs Rho products, such as Rhodes, RhoConnect, RhoElements, and RhoStudio. RhoStudio is an Eclipse installation that facilitates development of native smartphone applications.

Mac OS

Java Development Kit

RhoStudio requires Java Development Kit. For Mac OS 10.6 and earlier, the JDK is already installed. For Mac OS 10.7 and 10.8, Java is not automatically installed. Download the Java for Mac Installer from Apple support and install Java 6 or higher.

Setup for RhoConnect

On Macintosh, you need the following setup before redis is installed.

  • The /usr/local directory exists and is recursively writable by the current user.
  • The /usr/local/etc/ directory exists and is recursively writable by the current user.

Setup for Xcode, Commend Line Tools, and Homebrew

If you do not have the latest Xcode and command line tools, you need to install them. Install the latest Xcode.

Then install the command line tools: go to Xcode –> Preferences –> Downloads tab and install the “Command Line Tools.”

Then install Homebrew into /usr/local.

Setup for RhoConnect Push

To use RhoConnect Push, you need to install Node.js.

Go to the Node.js website, and download and install Node.js. Or you can enter the following command after you install Homebrew.

$ brew install node

Setup for Ruby

If you do not have Ruby Version Manager and Ruby 1.9.3 installed, you must install them.

On Macintosh, Ruby is already installed, but this version is outdated and isn’t compatible with RhoStudio. Install Ruby Version Manager (RVM) into your home directory. Do not use sudo when you install RVM: that can cause problems with file permissions when you run bundle commands within RhoStudio.

Install Ruby 1.9.3 with the following RVM command.

$ rvm install 1.9.3

Download and Install

Download the latest Zebra RhoMobile Suite Installer for Macintosh. This contains Redis, RhoConnect and Rhodes.

Click on the Zebra RhoMobile Suite Installer for Mac download file to open it. You will get a window similar to this:
RhoStudioInstaller Mac

Run “Install gems”. A terminal window will open. Select suitable Ruby version and whether to use ‘sudo’ prefix for gem installation. Wait for the gems install process to complete.

Run “Install rhoconnect-push”. A terminal window will open. Select whether to use ‘sudo’ prefix for installation. Wait for the rhoconnect-push install process to complete.

Drag Zebra RhoStudio to the Applications folder.

RhoStudio has two launchers: RhoStudio 32-bit and RhoStudio 64-bit. Use the launcher suitable for your system.

Understanding the Installer Contents

In addition to RhoStudio, the Zebra RhoMobile Suite Installer for Macintosh also contains:

Git

The RhoMobile Suite installer for Macintosh does not install Git. Although you can develop without Git, it is a very useful tool, and is needed for RhoHub. You can install Git on Mac.

Windows 32-bit

Ruby

RhoMobile Suite installer for Windows contains Ruby 1.9.3-p194. This Ruby is used for rake commands on the developer computer and to run RhoConnect applications.

RhoMobile Native applications use Ruby 1.9.2-p290. This Ruby is used on devices.

Java Development Kit

Ensure that Java Development Kit is installed. The Sun JDK for Windows is available here.

Download and Install

Download and run the latest Zebra RhoMobile Suite Installer for Windows. This installs the Ruby stack, Redis, RhoConnect and Rhodes.

If you use Symantec Antivirus it can warn about “Suspicious.MLApp” security risk in rubyw.exe file during installation. It is known false positive in Symantec antivirus.
Ignore this warning.

On Windows XP reduce JVM heap size:
Open <RhoMobileSuiteDir>\rhostudio\win32.win32.x86\RhoStudio.ini file in editor.
Find “-Xmx1024m” line and change it to “-Xmx512m”.

The 32-bit Windows version of the JDK is required for Blackberry tools.

Use Zebra RhoStudio 32-bit launcher to run RhoStudio.

Setting the JDK Path

Go to RhoStudio Preferences (Windows –> Preferences), select RhoMobile section and set the Java bin path. Set this path to JDK, such as C:\Program Files\Java\jdk<version number>\bin .

Understanding the Windows Installation

Once you install Zebra RhoMobile Suite on Windows, you will see Zebra RhoMobile Suite on the Windows Start menu with the following options:

Troubleshooting

RhoStudio doesn’t start with message “Failed to create the Java Virtual Machine”:

Reduce JVM heap size. Likely your computer has not enough memory.
Open <RhoMobileSuiteDir>\rhostudio\win32.win32.x86_64\RhoStudio.ini file in editor.
Find “-Xmx1024m” line and change it to “-Xmx512m”.

Windows 64-bit

Ruby

RhoMobile Suite installer for Windows contains Ruby 1.9.3-p194. This Ruby used for rake commands on developer computer and to run RhoConnect applications.

RhoMobile Native applications use Ruby 1.9.2-p290. This Ruby used on devices.

Java Development Kit

Ensure that Java Development Kit is installed. The Sun JDK for Windows is available here. Install Windows x64 JDK or x86 JDK or both.

Download and Install

Download and run the latest Zebra RhoMobile Suite Installer for Windows. This installs the Ruby stack, Redis, RhoConnect and Rhodes.

If you use Symantec Antivirus it can warn about “Suspicious.MLApp” security risk in rubyw.exe file during installation. It is known false positive in Symantec antivirus.
Ignore this warning.

**

Use Zebra RhoStudio 64-bit to run RhoStudio with x64 JDK.

Use Zebra RhoStudio 32-bit to run RhoStudio with x86 JDK.**

Setting the JDK Path

Go to RhoStudio Preferences (Windows –> Preferences), select RhoMobile section, and set the Java bin path. Set this path to the x86 JDK, such as C:\Program Files (x86)\Java\jdk<version number>\bin .

Understanding the Windows Installation

Once you install Zebra RhoMobile Suite on Windows, you will see Zebra RhoMobile Suite on the Windows Start menu with the following options:

Troubleshooting

  • RhoStudio doesn’t start, and a message appears: “Failed to create the Java Virtual Machine”:

    Reduce JVM heap size. Likely your computer has not enough memory.
    Open <RhoMobileSuiteDir>\rhostudio\win32.win32.x86_64\RhoStudio.ini file in editor.
    Find “-Xmx1024m” line and change it to “-Xmx512m”.

  • RhoStudio doesn’t start, and a message appears: “Failed to load the JNI shared library…”:

    Check compatibility between RhoStudio launcher and JDK version:
    32-bit launcher is compatible with x86 JDK.
    64-bit launcher is compatible with x64 JDK.

Removing Spaces from the Workspace Path for RhoConnect Applications

When you start RhoStudio, you set the location of the workspace directory. Set this path to a workspace directory that does not contain space symbols: if the path has spaces, a RhoConnect application created with RhoStudio will not work properly.

Checking for the Zebra RhoStudio Installation

Zebra RhoMobile Suite installs into a Zebra RhoStudio folder. Old versions of RhoStudio installed into a RhoStudio folder. Check that you start from Zebra RhoStudio.

Setup Rhodes SDKs

If you develop Rhodes apps (or RhoElements native apps), you will need the SDKs for the platform you want to build your app on. These instructions are found here.

You can either run rhodes-setup, or you can set the SDK paths in RhoStudio Preferences.

Eclipse plugin, RhoSimulator

Installing RhoStudio as a plugin for Eclipse is currently disabled.

RhoSimulator, which comes with RhoStudio for Mac and Windows, does not work with Linux.

Back to Top