add instructions for running the embedded Android Test Project

README.md

@@ -45,6 +45,29 @@ Translate Extension](http://www.mediawiki.org/wiki/Extension:Translate). See
 [our translation page](https://f-droid.org/wiki/page/Special:Translate) if you
 would like to contribute.
 
+
+Running the test suite
+----------------------
+
+FDroid client includes a embedded Android Test Project for running tests.  It
+is in the `test/` subfolder.  To run the tests from the command line, do:
+
+```
+git submodule update --init
+./ant-prepare.sh # This runs 'android update' on the libs and the main project
+ant clean emma debug install test
+```
+
+You can also run the tests in Eclipse. Here's how:
+
+1. Choose *File* -> *Import* -> *Android* -> *Existing Android Code Into Workspace* for the `fdroidclient/` directory.
+2. Choose *File* -> *Import* -> *Android* -> *Existing Android Code Into Workspace* for the `fdroidclient/test/` directory
+3. If **fdroid-test** has errors, right-click on it, select *Properties*, the
+*Java Build Path*, then click on the *Projects* tab.
+4. Click on the *Add...* button and select `fdroidclient/`
+5. Right-click on the **fdroid-test** project, then *Run As...* -> *Android JUnit Test*
+
+
 License
 -------