From f91984f489a4b969ea448bb50a0204aa733f2efa Mon Sep 17 00:00:00 2001
From: Joshua Gross <joshua.gross@gmail.com>
Date: Fri, 14 Jan 2011 15:18:22 -0800
Subject: [PATCH] Updated README to help kick-start developers
 debugging/testing, and changed test Manifest to allow it to be debugged

---
 README.md                 | 17 +++++++++++++----
 tests/AndroidManifest.xml |  2 +-
 2 files changed, 14 insertions(+), 5 deletions(-)

diff --git a/README.md b/README.md
index 4696a6b58..4990c878f 100644
--- a/README.md
+++ b/README.md
@@ -38,11 +38,20 @@ Getting Started With Development
 
 9. Sign a [Contributors License Agreement](https://github.com/downloads/todoroo/astrid/Contributors%20Licensing%20Agreement.pdf) and send it to astrid AT todoroo.com 
 
-Testing on a device - debugging
+Testing on a device - Debugging
 ---------------
-If you have trouble running Astrid on your device, it is recommended to:
-1. Fully uninstall Astrid from the device: adb uninstall com.timsu.astrid
-2. Restart Eclipse
+How to debug/test on a USB device: (JoshuaGross Jan 14, 2011)
+1. Plug in your device and make sure you can see it by running `adb devices`
+2. If you cannot see the device, or want to restart debugging, do:
+	`adb kill-server`
+	`adb usb`
+	`adb devices` (make sure your device is listed)
+	`adb uninstall com.todoroo.astrid.tests` (you should see "Failure" if this was uninstalled already)
+	`adb uninstall com.todoroo.astrid` (you should see "Failure" if this was uninstalled already)
+3. If you have not already, set up Run configurations in Eclipse; either under the "Run" or "Debug" menus. 
+   To test the application, set up "Android Application". To run JUnit tests, set up "Android JUnit Tests".
+   Settings should autofill for you, you should be able to open a new configuration and run it.
+   If you run it in debug mode, see #2 above for getting adb to work in case it is finicky.
 
 Contributors workflow
 ---------------
diff --git a/tests/AndroidManifest.xml b/tests/AndroidManifest.xml
index af07d58d8..6751fdd32 100644
--- a/tests/AndroidManifest.xml
+++ b/tests/AndroidManifest.xml
@@ -10,7 +10,7 @@
     <!-- We add an application tag here just so that we can indicate that
          this package needs to link against the android.test library,
          which is needed when building test cases. -->
-    <application>
+    <application android:debuggable="true">
         <uses-library android:name="android.test.runner" />
     </application>