~ubuntuone-client-engineering/droidcouch/trunk

4 by jobe
Added file INSTALL and updated README
1
The easiest way to test DroidCouch is to create a new Eclipse project and run the test client
2
3
If you don't already have Eclipse and the latest Android SDK, please install them. 
4
See http://developer.android.com/sdk/installing.html for details. 
5
6
You also need a CouchDB server that you can access via HTTP. It can be either remote or local. 
7
See http://couchdb.apache.org/ for details on how to install CouchDB.
8
9
Installation:
10
11
1. Use menu alternative File -> New project -> Other -> Android project -> Specify from existing source. 
12
2. Browse to the directory you checked out from GitHub and select it. 
13
3. Use default values for everything
14
15
Note: if you intend to run on a real phone, please specify a compatible SDK version. 
16
Currently we default to SDK 1.5, which works for most phones currently on the market.
17
18
4. Change the file TestClient.java 
19
20
Find the line: //String HOST = "ADD_YOUR_OWN_COUCHDB_SERVER_HERE";
21
and add a valid URL to your own server. Note that the URL should end with a forward slash. 
22
23
5. Try running the project using "Debug as -> Android project"
24
25
If everything works, you will see the test application in the emulator. 
26
After a few seconds, it should then display: All tests passed!
27
28
Good luck!
29
30
31
32