Adding more help

Signed-off-by: Charles Oliver Nutter <headius@headius.com>

.gitignore

@@ -1,3 +1,4 @@
 bin
 gen
 nbproject/private
+local.properties

README

@@ -2,6 +2,18 @@ http://ruboto.com
 
 To get this working on Android, you'll need to do two things:
 
+0. Look at the various *.EXAMPLE files, copy over without without the EXAMPLE part, and edit
+accordingly if needed.  Some toolkits will generate needed files, but if not then hack by hand.
+
+This is particuallry true if you are doing development vis the command line and vi, and not 
+wussing out by using some girlyman IDE.  Just sayin'.
+
+For example,
+
+   cp local.properties.EXAMPLE  local.properties
+   vi local.properties
+
+
 1. Modify the "dx" tool for the target platform to support 1024M of memory. You'll see where.
 
 2. After running "ant release" to build the .apk, sign it using this command:
@@ -14,6 +26,107 @@ The keyphrase is simply "ruboto"
 
   ANDROID_HOME/tools/adb -s emulator-5554 install -r bin/IRB-unsigned.apk
 
+(though you might do better to just have those tools in your PATH ...)
+
 Replace "emulator-5554" with the name of your target device.
 
 That's it! Have fun!
+
+
+Appendix 0
+
+Some useful Android stuff:
+
+See http://developer.android.com/guide/developing/other-ide.html for help on running assorted commands from a shell.
+
+Much of what follows was stolen from that site.
+
+You need an emmulator (AKA an AVD, or Android Virtual Device) to test the app (unless you want to actaully deploy to your phone over and over)
+
+If you have already created one, skip this.  Otherwise, here's what to do to get an AVD:
+
+
+ First, you need to select a "deployment target." To view available targets, execute:
+
+    android list targets
+
+For example:
+
+  james@james06:~/ngprojects/ruboto-irb$ android list targets
+  Available Android targets:
+  id: 1
+       Name: Android 1.1
+       Type: Platform
+       API level: 2
+       Skins: HVGA-P, QVGA-L, QVGA-P, HVGA (default), HVGA-L
+  id: 2
+       Name: Android 1.5
+       Type: Platform
+       API level: 3
+       Skins: HVGA-P, QVGA-L, QVGA-P, HVGA (default), HVGA-L
+  id: 3
+       Name: Google APIs
+       Type: Add-On
+       Vendor: Google Inc.
+       Description: Android + Google APIs
+       Based on Android 1.5 (API level 3)
+       Libraries:
+        * com.google.android.maps (maps.jar)
+            API for Google Maps
+       Skins: QVGA-P, HVGA-L, HVGA (default), QVGA-L, HVGA-P
+
+
+Find the target that matches the Android platform upon which you'd like to run your application. Note the integer value of the id — you'll use this in the next step.
+
+  android create avd --name <your_avd_name> --target <targetID>
+
+
+For example:
+
+  android create avd --name super-bad-avd --target 3
+
+You should get prompted to answer a few questions. 
+
+
+Now kick off an AVD ...
+
+   emulator -avd <your_avd_name>
+
+
+... and install the .apk on the emulator:
+
+    adb install /path/to/your/application.apk
+
+The path is typically in the ./bin directory of your project folder
+
+
+    adb install ./bin/MySuperBadApp.apk
+
+
+If there is more than one emulator running, you must specify the emulator upon which to install the application, 
+by its serial number, with the -s option. For example:
+
+  adb -s emulator-5554 install ./bin/MySuperBadApp.apk
+
+
+If you don't know serial numbers of the running emulators, you can get a list using
+
+  adb devices
+
+
+As you develop your app, you'll need to reploy to the emulator.  If you get an error saying the app is
+already installed ...
+
+    Failure [INSTALL_FAILED_ALREADY_EXISTS]
+
+... you can try using the -r option (reinstall, keeping data)
+
+    adb install -r ./bin/MySuperBadApp.apk
+
+to replace it.
+
+Or uninstall it (use the -k option to keep data and cache directories, if you want that)
+
+    adb uninstall -k com.your.app.package.Name 
+
+More help at http://developer.android.com/guide/developing/tools/adb.html