How to build the project

Checking out the source code

$ git clone https://github.com/raphaelm/opacclient.git opacclient
$ cd opacclient/
$ git submodule update --init --recursive

Import project in Eclipse

We assume you have an Eclipse installation ready for use with Android projects (SDK, ADT, ... set up properly).

1. Import the project 3dparty/HoloEverywhere/contrib/HoloEverywhere/library into Eclipse using File → New → Project → Android Project from Existing Code
2. Do the same with 3dparty/HoloEverywhere/addons/preferences
3. Import the opacclient project the same way
4. Make sure in the opacclient project the path to the HoloEverywhere project is set properly (right click → Properties → Android and look under Libraries)

If you want to use EGit, importing the projects is a little bit more complicated:

1. Import via File → Import... → Android → Existing Android Code Into Workspace in order to set up the project configuration correctly
2. Delete the just imported project from the workspace
3. Import again via File → Import... → Git → Projects from Git in order to have the EGit commands in the 'Team' group of the project's context menus.

Should work. If not, play around or email us. Happy hacking!

Build with ant

$ android update project -p 3dparty/HoloEverywhere/addons/preferences
$ android update project -p 3dparty/HoloEverywhere/library
$ android update project -p .
$ ant debug

Import the Unit Tests into eclipse

This might be a bit more complicated.

1. Import the tests folder as a eclipse project with Import → Existing Projects into workspace.
2. For Linux and Mac OS X: You are done here. Continue only if you use Windows.
3. This step is not necessary on Unix systems. Detele the symlink file tests/upstream. Open Project Properties → Java Build Path. In first tab, click "Link source…". Select the src directory of the main Android project as the location and upstream as the directory name. Change the newly created tests/.classpath line to <classpathentry including="de/geeksfactory/opacclient/ISBNTools.java|de/geeksfactory/opacclient/Base64.java|de/geeksfactory/opacclient/NotReachableException.java|de/geeksfactory/opacclient/apis/|de/geeksfactory/opacclient/objects/|de/geeksfactory/opacclient/searchfields/|de/geeksfactory/opacclient/storage/MetaDataSource.java" kind="src" path="upstream"/> if it does not look like this already.