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

Adding RhoMobile Capabilities To Your Web Application

You may wish to add RhoMobile API capabilties to your web application if your client devices are running a RhoMobile Application.

Client Choices

Standard Browsers

Standard browsers will not provide the added benefit of native application packaging, deployment and management. It will also not allow you to take advantage of the RhoMobile APIs that provide device, system and framework access to your web application

RhoMobile Application

Although RhoMobile applications typically involve packaging up all resources and application logic locally with the RhoMobile application, you can build a RhoMobile Application to start running from your web server start page. Although you have to install and setup the development environment and build the application for each mobile operating system, you can truly make this application appear like a native application by changing the application icon, splash screen as well as customize other build and runtime options. Follow the typical steps for building a RhoMobile Application and then be sure to change the start_path to point to your web app starting URL.

Connecting with your web application

To load application files to the RhoMobile application from an external Web server - set start_path in rhoconfig.txt to point to http:// or https:// protocol URI. rhoconfig.txt is a runtime configuration file Read More :::ruby start_path=‘http://heroku.com/myapp/index.html’

Using RhoMobile JS APIs

The RhoMobile JavaScript API library rhoapi-modules.js is needed in order to access RhoMobile 4 JavaScript APIs. This file is provided as part of the installation of RhoMobile Suite:

  • Windows: located in the [RhoMobile Suite install path]/rhoapi-modules
  • Mac: In the rhoapi-modules folder of the RhoMobile Suite DMG package.

Copy this file to your web server and make sure it is referenced in all pages that wish to use the RhoMobile JavaScript APIs.

This file is universal for all platforms and includes all of the Rhodes and RhoElements extensions and APIs by default. If you wish to customize the contents of include any additional extensions, then you will need to generate the `rhoapi-modules.js` file by creating a RhoMobile application project.

Generating rhoapi-modules.js

To generate a universal ‘rhoapi-modules.js’ you can run a rake command. In order to do this, you will need to have RhoStudio installed. Create a RhoMobile project and then in a command prompt from the project folder, execute the following command: :::ruby #platform may be: win32, wm, android, iphone, wp8 rake update_rho_modules_js[all]

The rhoapi-modules.js file will be located in the projects \public\api folder. Copy this file to your webserver application and reference it appropriately.

The `rhoapi-modules.js` file is customized to the `extensions` and `capabilities` section of your `build.yml`. If you do not included the proper settings, the rhoapi-modules.js library may not contain all of the capabilities you are looking for.

JS ORM

If you are going to be using the JS ORM API, you’ll also need to include this line in any files that will be using it:

<script type="text/javascript" charset="utf-8" src="/public/api/rhoapi-modules-ORM.js"></script>
Back to Top