Building From Eclipse

This document has been customized for aug-mn. Here is the original.

The GitHub Android app can be built by a simple running of mvn clean install from the repository's root directory but you may also want to build/launch the projects and this page outlines the extra steps required to do so.

To make Eclipse setup easier, we (aug-mn) have included the third-party dependencies in the repo. Many of the dependencies are binary JARs and have been inluded in app/libs. Others need to be set up as library projects in Eclipse; their source is in libraries.

Contents

• Prerequisites
• Forking and cloning the repo
• Importing library projects into Eclipse
• Importing GitHub Android project

Prerequisites

• Android SDK with 4.0 (API 14) SDK Platform
• Eclipse
• Git
• GitHub account

Forking and cloning the repo

1. Click here to fork the aug-mn/android repo into your personal GitHub account.

2. Change directories on your machine to the directory you want to be the parent of the repo. Example:

    $ cd ~/dev/android
   

3. Clone the repo:

    git clone git@github.com:<your_github_account>/android.git github-android
   

   Where your_github_account is your account name. Example:

    git clone git@github.com:jeremyhaberman/android.git github-android
   

Importing library projects into Eclipse

Import the libraries directory into Eclipse.

1. File > Import

2. Select General > Existing Projects into Workspace and click Next.

3. Select the libraries directory as the root directory. The following library projects should be listed in the Projects box:

   Project Name	Source Directory
   ViewPagerIndicator	libraries/ViewPagerIndicator
   ActionBarSherlock	libraries/ActionBarSherlock
   wishlist	libraries/wishlist

4. Click Finish.

Before continuing, make sure each of the above projects are building successfully in Eclipse.

Importing GitHub Android project

You are now ready to import and GitHub Android app project.

Import the app directory like you did above with the libraries directory.

The GitHub project should now build and be launchable and with no error markers. If you still see error markers try running the Project > Clean... menu and/or restart Eclipse.