To see Greenhouse live, you may signup and use the production Greenhouse instance at http://greenhouse.springsource.org. However, we recommend getting the source code for study, adapting features of the application to your own needs, and contributing to Greenhouse development. Follow the guide below to get an embedded Greenhouse instance up and running locally.
Greenhouse Web AppTo get the main Greenhouse web app up and running locally, follow the steps below:
Greenhouse for iPhone
To build and run the Greenhouse for iPhone client locally, you will first need to install the iOS development environment, then run the project in the iPhone Simulator.
Download and Install the iOS SDK
The first step in developing iOS applications is downloading the iOS SDK package. The iOS SDK package contains everything you need to develop iOS applications, including the Xcode IDE and device simulators.
Note the download requires that you have an Apple Developer account. If you do not have one, you can register for free here.
After downloading, double click the disk image file to open it. The image contains an "About" document and the Xcode package. Double click the Xcode and iOS SDK package to begin the installation. Follow the prompts, continuing through the installation. Unless you have a good reason not to, accept the defaults for all the installation options. Once the installation is complete, you are ready to open the Greenhouse for iPhone project.
Opening the Greenhouse for iPhone Project in the Xcode IDE
Next, get the project source code.
From Finder, double click the
The Greenhouse for iPhone source code expects a instance of the Greenhouse web app to also be running locally. Verify the web app is on-line, and click the "Build and Run" button to start the app in the iPhone simulator.
Greenhouse for Android
To run the Greenhouse for Android client, you will first need to install and configure the Android SDK, and the Eclipse ADT (Android Developer Tools) plugin.
Download and Install the Android SDK
The first step in developing Android applications to download the Android SDK starter package. The starter package is not a full development environment — it includes only the core SDK Tools, which you can use to download the rest of the SDK components. Make sure to download the package that is appropriate for your development computer: Windows, Mac OS X, or Linux.
After downloading, unpack the Android SDK archive to a safe location on your machine. By default, the SDK files are unpacked into a directory named
Next, add the location of the SDK's primary tools directory to your system
Install the Eclipse ADT plugin
Android offers a custom plugin for the Eclipse IDE, called the Android Development Tools (ADT). To install ADT, start the SpringSource Tool Suite, or another Eclipse distribution, then select Help > Install New Software. Then:
Configure the ADT Plugin
Once you've successfully downloaded ADT as described above, the next step is to modify your ADT preferences in Eclipse to point to the Android SDK directory:
Installing SDK Components
The Android SDK and AVD Manager is the tool that you use to install and upgrade SDK components in your development environment. The SDK package downloaded previously only contains the latest Android platform. We recommend you install all of the available platform components. To launch the tool from Eclipse/ADT, navigate to Window > Android SDK and AVD Manager, then:
Configure an Android Virtual Device
Next, configure an Android Virtual Device for running the Greenhouse client. You can create multiple AVDs for testing, but you must configure at least one. The Greenhouse client is built using API Level 8. In order to run the app in the emulator, you will need to configure an AVD with a target of "Google 2.2 - API Level 8". To create an AVD:
Use the following Installation Checklist to confirm you have completed all the necessary steps.
Run the Greenhouse for Android Project
Now with the Android development environment setup, retrieve the Greenhouse for Android source code.
Import the Android project into Eclipse. The Greenhouse for Android source code comes configured to execute against a locally running instance of the Greenhouse server. Please ensure the Greenhouse web app is running locally.
Once you have a locally running Greenhouse server, select Run to start the client in the Android emulator.