Getting Started

Mulberry is supported on OSX Snow Leopard and Lion, and on Windows 7 64-bit via Cygwin. You should read the relevant README for your operating system in the install directory. Ubuntu is not officially supported, but it is reported to work by following the instructions in the Ubuntu installation README.

Installation

1. Read install/<your_operating_system>/README.md for details on dependencies for your operating system. The installation process takes care of as much of this as possible, but some dependencies may need to be installed manually before the installation scripts will work.

2. Download the latest release, or clone the repository into a directory of your choosing:

   git clone [email protected]:Toura/mulberry.git

3. Once you have the code, cd to the mulberry directory, and run the following command:

   source ./install.sh

Developing Apps

Supported Mobile Platforms

Mulberry currently supports the following mobile platforms:

• iOS4 and above on iPhone and iPad
• Android 2.2 and above on Phone only

Mulberry apps have been shown to run on WebOS, although not bug-free.

Mulberry does not currently support Windows Mobile or BlackBerry in any version.

There are additional requirements for each platform:

• iOS Application Development Requirements
• Android Application Development Requirements

Running the Tests

Note that if you've been following along, you have not installed the libraries to do testing. Run bundle install to install the test/development libraries necessary for testing.

To run the tests, run rake from the root of the repository.

You can also run individual suites:

rake                  # run all of the tests & jshint. Alised of rake ci
rake spec             # run the ruby unit tests
rake integration      # run the javascript integration tests
rake evergreen:run    # run the javascript unit tests
rake evergreen:serve  # serve the javascript tests for manual testing
rake jshint           # run jshint on the js code and js tests

Installing chromedriver

You will need chromedriver in order to run the JavaScript tests. You can download chromedriver if you do not already have it installed; make sure you install it somewhere in your $PATH.

This is automatically installed for you by the OSX installer, other platforms will need to install it by hand.

Getting Support

• Documentation
• Google Group
• #touramulberry on irc.freenode.net: A live chat room with Mulberry users and developers. Use your own IRC client or use Freenode's webchat