Use of this mobile application is on an as-is, as-available basis and it not subject to Rally’s Service Level Agreement. Support of this mobile application, evolution of this application and even ongoing existence of this Rally Labs mobile application is not guaranteed.

ALM Mobile

Getting Started

Clone the repo:

    git clone ssh://git/export/git/alm-mobile.git

If you need to install node, run:

    brew update
    brew install node

To install required node modules, run:

    npm install

Then install the Grunt Command Line and Nodemon programs:

    npm install -g grunt-cli nodemon

If you need to add the npm bin directory to your PATH for grunt, run or add this to the bottom of your ~/.zshrc file:

    export PATH=$PATH:`npm config get prefix`/bin

To compile and build the application, run:

    grunt && grunt watch

In a separate terminal window, to run the application (and reload when files are changed), run:

    npm start

Setting up Apache virtual hosts

Edit /etc/apache2/httpd.conf to enable the virtual hosts file. Uncomment out the second line:

    # Virtual hosts
    Include /private/etc/apache2/extra/httpd-vhosts.conf

Edit /etc/apache2/extra/httpd-vhosts.conf with the following, swapping out [hostname] for your machine's actual hostname. Edit your /etc/hosts file and add alm.f4tech.com at the end of the 127.0.0.1 line:

    <VirtualHost *:80>
        ServerAdmin [email]
        ServerName [hostname]
        ServerAlias [hostname]
        ProxyPass / http://[hostname]:3000/
        ProxyPassReverse / http://[hostname]:3000/
        ErrorLog "/private/var/log/apache2/[hostname]-error_log"
        CustomLog "/private/var/log/apache2/[hostname]-access_log" common
    </VirtualHost>

    <VirtualHost *:80>
        ServerAdmin [email]
        ServerName alm.f4tech.com
        ServerAlias alm.f4tech.com
        ProxyPass / http://alm.f4tech.com:7001/
        ProxyPassReverse / http://alm.f4tech.com:7001/
        ErrorLog "/private/var/log/apache2/[alm.f4tech.com]-error_log"
        CustomLog "/private/var/log/apache2/[alm.f4tech.com]-access_log" common
    </VirtualHost>

Customizing Bootstrap Stylesheets

All Bootstrap stylesheet files can be found separated into:

vendor/styles/bootstrap

They're in original LESS format in order to be easily customized, and compiled together with the app build. The proper way to override any bootstrap styles or variables is to modify:

client/styles/_bootstrap.less

Do not directly modify any files in vendor/styles/bootstrap. The changes will be overwritten as we upgrade that library.

Application Configuration

You will need to create a config.json file to configure the ALM url. You should copy from config.json.example as a template.

Properties

• almWebServiceBaseUrl: You should change this value if you want to point to a different Rally ALM Server URL
• appName: You should change this value so that it is a unique name that represents your application and who your are.

Deploying to S3

The application can easily be deployed to an Amazon S3 Bucket and served up as a static website. This is accomplished via the grunt-s3 NPM module. In order to deploy the site, you need to create and configure a grunt-aws.json file in the root directory of this repo. The grunt-aws.json.example files is given as a skeleton to start from. All you need to do is supply your S3 Access Key Id, Secret Access Key and the name of the Bucket to deploy to. Once that is done, you can run the

    grunt

command to package up the application. To deploy it, run

    grunt s3

Your bucket should be configured for Website Hosting. Here's a link to AWS Documentation to Configure a Bucket for Website Hosting. You'll want to set both the Index document and Error document to be "index.html".

Testing

Android Emulator

Full documentation can be found at the Android Developer site.

Download and unzip the Android SDK in order to set up your Android Virtual Device (AVD)

From the unzipped SDK directory get the config ID

sdk/tools/android list target

Create an AVD with the target id from an image

android create avd -n <avd_name> -t <config id>

Run the AVD with the emulator tool with graphics acceleration for increased responsiveness

emulator -avd my_avd -gpu on

Download the WebDriver for Android

Get the serial ID for your emulator

platform-tools/adb devices

Install the Android WebDriver to your emulator

platform-tools/adb -s <serialId> -e install -r android-server.apk

Start the Android WebDriver on your emulator

platform-tools/adb -s <serialId> shell am start -a android.intent.action.MAIN -n org.openqa.selenium.android.app/.MainActivity

Set up port forwarding for TCP connections from your hostmachine to your emulator

platform-tools/adb -s <serialId> forward tcp:8080 tcp:8080

Launching alm-mobile in the Windows Phone 8 Emulator

Start up Visual Studio Express 2012 for Windows Phone, and create a new Visual C# Windows Phone App project. Name it anything you want and save it anywhere you want. Once the project has loaded, press F5 or the debug button to start the emulator. It will launch the skeleton app, just press the Windows button on the phone to return to the OS then launch Internet Explorer. You will need to load the site using your IP address instead of localhost, as the emulator has its own IP address.

To use your computer's keyboard inside the emulator:

• On a standard Windows keyboard: page up see this page for details
• On a fullsize Mac keyboard: fn-page down works for me, although the magic combo seems to vary a lot for people across the web. fn-escape has been reported to work as well.

Conventions

All CoffeeScript should be indented with 2 spaces (soft tabs)