Build Instructions and Suggested Build/Development Environment

1. Install and set up Eclipse with Android Development Tools plugin

System requirements are located here:
http://developer.android.com/sdk/index.html
click on "System requirements" under the Download button.

1. Download and install Eclipse 3.6.2 (Helios) or greater from here:
http://www.eclipse.org/downloads/

2. Download the Android SDK from here:
http://developer.android.com/sdk/index.html

3. Install instructions for the SDK is located here with detailed steps.
Suggested Android versions to install are Android 4.1 (API16) and Android 2.2 (API8)*:
http://developer.android.com/sdk/installing/index.html

2. Setting up workspace on Eclipse, Setting up AVD and running the code

1. If you are reading this document, you most likely have already cloned or downloaded
the Snapshot Shopper source files. For your reference,
the GitHub repository for Snapshot Shopper is here:
https://github.com/aya2/Snapshot-Shopper
You should have downloaded the entire contents of folder SnapshotShopper.
If you have not, do so now. Note the location of this folder.

2. Once Eclipse with Android Development Tools plugin is installed, open Eclipse. You may be
prompted to select a workspace upon startup. Browse to the downloaded and extracted folder
in the previous step.

3. Go to File -> Import -> General -> Existing Projects into Workspace. Click Next, and check Select root directory.
Browse to the downloaded and extracted folder in step 1, and locate the folder SnapshotShopper
inside. Select this folder, and click Finish.

4. In the Project Explorer to the left side in Eclipse window, you should now see a project called
SnapshotShopper. Expand to SnapshotShopper -> src -> com.snapshotshopper -> SnapshotShopper.java,
and double-click to open this file.

5. Next, we need to create an Android Virtual Device. Open the AVD Manager by Window -> AVD Manager.
Click New, and create an AVD of Android 4.1 (API16) and Android 2.2 (API8).
The settings for each can be seen in the following images. You can Edit these settings later from the AVD Manager.
It is suggested to enable the Keyboard support under Hardware. Make sure that Keyboard support is checked "yes".

Android 4.1(API16):

Android 2.2 (API8):

6. Once AVDs are created, start up the AVD. From the AVD Manager, select the desired AVD and click Start.
This may take a few minutes. It is suggested to start up the AVD before running the source code.

7. Run the source code as Android Application. If you have multiple AVDs running, you will be prompted to select the target AVD.
IMPORTANT: There are known issues with Eclipse when running a project when you have a xml file
opened as the main focus. This creates an extra file and the run stops, causing an error.
Always select and open the SnapshotShopper.java under src folder before running the code.

8. On the AVD, the app Snapshot Shopper should launch.
If it does not seem to launch itself, locate the app in the home app list by clicking the home button on the AVD.
As of now, the app has an icon of an orange camera:

Menu screen from Android 2.2 (API8) AVD:



Snapshot Shopper with items entered on Android 2.2 (API8) AVD:

*Note: Many android devices still run older OS, and Android 2.2 (API8) covers most of these devices.
(Source: http://en.wikipedia.org/wiki/Android_(operating_system)#Usage_share)
Therefore, it is important to do testing for the app on Android 2.2 (API8).
However, there are known issues with the camera functionality in Android 2.2 (API8).
Development is most stable with Android 4.1 (API16) as of now.

Copyright (C) 2012 Aya Yakura

Contact information:

email: aya2@pdx.edu

Revised August 16, 2012