Skip to content

Latest commit

 

History

History
executable file
·
796 lines (614 loc) · 32.9 KB

tutorial.md

File metadata and controls

executable file
·
796 lines (614 loc) · 32.9 KB

#Android App Development with Clojure:
An Interactive Tutorial forever in love by Kris Calabio (@zangderak)

###Is there a better way?

I've been programming in Java since I was an undergrad in college in 2006. While working a contract job in 2011-2012 in which I was hired to work with a huge mess of Java code1, I was left wondering if Java was rotting my brain. Surely, there has got to be a better way. After an impractical detour2, I decided to take on learning Clojure, a Lisp dialect for the JVM. After a two-year journey of hacking personal projects, Clojure is now my general programming language of choice.

While learning how to write apps for Android, I was back to programming in Java and again was left thinking that there has got to be a better way! I looked into developing Android apps using Clojure. Although there is still much room for maturation, the efforts of Daniel Solano Gómez, Alex Yakushev, and Zach Oakes show a promising future for Clojure in Android development.

Prerequisites

This tutorial is directed towards Clojure programmers who are seeking an alternative to the Java language for Android development. I will assume that you already know the basics of Clojure3 and Android.

We will be using Alex Yakushev's lein-droid tool for project management. We will also be using Alex's fork of Daniel Solano Gómez's neko library which provides function wrappers and alternatives to the Android Java API. However, neko does not replace everything as of the time of this writing and is subject to change so keep the Android docs handy. There will be some Java interop in this tutorial. We will be using emacs with the [nrepl] (https://github.com/clojure/tools.nrepl) plugin for this tutorial.

Be forewarned: some tools in this setup are still very young and are in fast development. New versions may pop up as of the time of this writing (May 21, 2014) and may introduce breaking changes. For your information, here are the versions of the tools that I am using:

Arch Linux
Java 1.7.0_51
clojure-android/clojure 1.6.0-RC1
Leiningen 2.3.3
lein-droid 0.2.3
Android SDK Tools 22.6.3
nrepl 0.2.3
neko 3.0.1
compliment 0.0.3

Now that you have been forewarned, let's begin. If you run into problems, please open an issue on GitHub, and I'll try my best to help you out.

What are we making?

Let's make a simple event listing app. This will not be a full-fledged calendar app, but rather a simple tool to pencil in events and have them sorted in chronological order. I have a text file on my desktop that I use to pencil in dates for gigs, practices, and other events.

text document of event listing

Our app will be based off of this simple idea.

our app

Using lein-droid to setup our project

Alex's Tutorial is a good introduction to lein-droid. Skim through the tutorial to familiarize yourself with the basic lein-droid commands.

This is how my ~/.lein/profiles.clj looks like:

{:user {:plugins [ [lein-droid "0.2.3"] ]
        :android {:sdk-path "/home/kris/adt-bundle-linux-x86_64-20130522/sdk/"}}}

NOTE: Change the directory to reflect your own sdk's path. And if there is a later version of lein-droid, consider using that.

Run this command at the terminal:

lein droid new events org.stuff.events :activity MyActivity :target-sdk 15 :app-name EventsListing

This will create a template file structure for an Android app. Open the project.clj file and change the neko version in :dependencies to "3.0.0-preview4".

If you have an actual Android device at hand, connect it to your computer. If not, you can setup an emulator. Now run lein droid doall at the terminal. This will build the app, install the app to your device, and open an nREPL server within the running app.

Define the Layout

Let's open the main Clojure source file located at ./src/clojure/org/stuff/events/main.clj in emacs and start defining the layout and the application.

If you don't already have Cider installed, you can install it by running this in emacs: M-x package-install cider. Now run this in emacs: M-x cider and enter the local machine for 'Host' and '9999' for 'Port'. Now you have a REPL in emacs which is connected to your running app. As you will see in a bit, this is neat-o torpedo.

To enter the namespace, type this command into the REPL: (in-ns 'org.stuff.events.main) To start evaluating definitions within our app's namespace, evaluate the ns form in the source file by entering the emacs command C-c C-n (or by moving the cursor after the closing parenthesis of the ns form and hitting C-x C-e).

Let's now code a definition for the layout of the app. The make-ui macro takes in a vector of elements which will be transformed into XML (learn more here). This structure can be anonymously passed into make-ui, but let's give it a named definition:

(def main-layout [:linear-layout {:orientation :vertical}
                  [:edit-text {:hint "Event name"}]
                  [:edit-text {:hint "Event location"}]])

Evaluate this def form. Let's change the defactivity form to look like this:

(defactivity org.stuff.events.MyActivity
  :def a
  :on-create
  (fn [this bundle]
    (on-ui
     (set-content-view! a
      (make-ui main-layout)))))

Interactive Development

To demonstrate the power of REPL driven development, move your cursor after the closing parenthesis of the on-ui form (after the third-to-last ) from the end), then hit C-x C-e.

screen 1

And just like that, the layout has changed. After you have finished geeking out on how cool what just happened was, let's add a button to the layout. Our def form for main-layout should now look like this:

(def main-layout [:linear-layout {:orientation :vertical}
                  [:edit-text {:hint "Event name"}]
                  [:edit-text {:hint "Event location"}]
                  [:button {:text "+ Event"}]])

Evaluate this form. Then evaluate the on-ui form to update the app. (From now on, you can assume that newly added code should be evaluated.)

screen 2

Adding Functionality

The app doesn't really do anything right now. Let's add attributes to our layout elements for functionality.

(declare ^android.widget.LinearLayout mylayout)

(def main-layout [:linear-layout {:orientation :vertical,
     		 		  :id-holder true
                                  :def `mylayout}
                  [:edit-text {:hint "Event name",
                               :id ::name}]
                  [:edit-text {:hint "Event location",
                               :id ::location}]
                  [:button {:text "+ Event"}]])

In order to access the layout by name, we added a :def attribute to our main-layout, an :id-holder flag, and a forward declaration form near the top of the source file. Additionally, our edit-text elements have :id attributes with a keyword value. The declare form allows us later to compile this code using AOT (more on using lein to build later).

With these additions, we can now access the values of these elements using .getTag. Enter some text into the edit-text fields in the running app:

screen 3

Then try these at the REPL:

org.stuff.events.main> (.getTag mylayout)
{:org.stuff.events.main/location #<EditText android.widget.EditText@42315c30>, :org.stuff.events.main/name #<EditText android.widget.EditText@42206a18>}
org.stuff.events.main> (str (.getText (::name (.getTag mylayout))))
"Party"
org.stuff.events.main> (str (.getText (::location (.getTag mylayout))))
"Your Place"

Note that the return value for the widget objects will probably be different for you. Now let's write a helper function for our convenience:

(defn get-elmt [elmt]
  (str (.getText (elmt (.getTag mylayout)))))

Now let's have that button do some work.

(declare ^android.widget.LinearLayout mylayout)
(declare add-event)

(def main-layout [:linear-layout {:orientation :vertical,
                                  :id-holder true,
                                  :def `mylayout}
                  [:edit-text {:hint "Event name",
                               :id ::name}]
                  [:edit-text {:hint "Event location",
                               :id ::location}]
                  [:button {:text "+ Event",
                            :on-click (fn [_] (add-event))}]])

We added an :on-click attribute to our :button element whose value is a callback function. Note the forward declaration for that callback function.

Well, we know that we need to add an event to the listing. First, let's add a new element to the layout that will contain the listing. We will also create an atom4 to hold the current state of the listing.

(def listing (atom ""))

(def main-layout [:linear-layout {:orientation :vertical,
                                  :id-holder true,
                                  :def `mylayout}
                  [:edit-text {:hint "Event name",
                               :id ::name}]
                  [:edit-text {:hint "Event location",
                               :id ::location}]
                  [:button {:text "+ Event",
                            :on-click (fn [_] (add-event))}]
                  [:text-view {:text @listing,
                              :id ::listing}]])

The value of the listing atom is used for the :text attribute of the newly added :text-view element.

Before we define the callback function, let's play with the REPL and figure out what we actually want to do when the user hits that button. First, we want to update the listing atom with the contents of the :edit-text fields. Enter an event in the running app then run this in the REPL:

org.stuff.events.main> (swap! listing str (get-elmt ::location) " - " 
		       (get-elmt ::name) "\n")
"Your Place - Party\n"

Next, we want to update the ui with the listing. We can use the config macro in neko.ui to achieve this. Let's update the ns form at the top of the source:

...
[neko.ui :only [make-ui config]]
...

Run C-c C-n to evaluate the ns form then evaluate that on-ui form in the defactivity. Next, enter this into the REPL:

org.stuff.events.main> (on-ui (config (::listing (.getTag mylayout)) :text @listing))

Let's write another helper function for setting the text of our elements.

(defn set-elmt [elmt s]
  (on-ui (config (elmt (.getTag mylayout)) :text s)))

Let's have our callback function perform these two tasks:

(defn add-event []
  (swap! listing str (get-elmt ::location) " - " 
		   (get-elmt ::name) "\n")
  (set-elmt ::listing @listing))

Now try hitting that button. Cool, huh?

screen 5

If you need to clear your listing, just run (def listing (atom "")).

Hitting the button should also clear the edit fields. Let's write a function to take care of all that.

(defn update-ui []
  (set-elmt ::listing @listing)
  (set-elmt ::location "")
  (set-elmt ::name ""))

And let's have our add-event function call this.

(defn add-event []
  (swap! listing str (get-elmt ::location) " - " 
		   (get-elmt ::name) "\n")
  (update-ui))

If you're coding along at home (and I hope you are!), here is what our code should look like so far:

(ns org.stuff.events.main
  (:use [neko.activity :only [defactivity set-content-view!]]
        [neko.threading :only [on-ui]]
        [neko.ui :only [make-ui config]]))

(declare ^android.widget.LinearLayout mylayout)
(declare add-event)

(def listing (atom ""))

(def main-layout [:linear-layout {:orientation :vertical,
                                  :id-holder true,
                                  :def `mylayout}
                  [:edit-text {:hint "Event name",
                               :id ::name}]
                  [:edit-text {:hint "Event location",
                               :id ::location}]
                  [:button {:text "+ Event",
                            :on-click (fn [_](add-event))}]
                  [:text-view {:text @listing,
                              :id ::listing}]])

(defn get-elmt [elmt]
  (str (.getText (elmt (.getTag mylayout)))))

(defn set-elmt [elmt s]
  (on-ui (config (elmt (.getTag mylayout)) :text s)))

(defn update-ui []
  (set-elmt ::listing @listing)
  (set-elmt ::location "")
  (set-elmt ::name ""))

(defn add-event []
  (swap! listing str (get-elmt ::location) " - " 
		   (get-elmt ::name) "\n")
  (update-ui))

(defactivity org.stuff.events.MyActivity
  :def a
  :on-create
  (fn [this bundle]
    (on-ui
     (set-content-view! a
      (make-ui main-layout)))))

So far so good... So what? It might be a good idea to build your app right now by running at the terminal lein droid doall. Note that you may have to connect your REPL again after you run this command.

Just One Little Fix

screen 6

If you rotated your screen, you may have noticed that the listing disappears. Let's fix that, shall we?

(defactivity org.stuff.events.MyActivity
  :def a
  :on-create
  (fn [this bundle]
    (on-ui
     (set-content-view! a
      (make-ui main-layout)))
    (on-ui
     (set-elmt ::listing @listing))))

Rotate your screen.

screen 4

Now that's what I'm talking about. The REPL never ceases to amaze me.

The Date Picker

What's the point of an event listing without sorted dates? Let's use java interop to make a date picker5.

pic of datepicker

First, let's add some imports into our ns form:

(ns org.stuff.events.main
  (:use [neko.activity :only [defactivity set-content-view!]]
        [neko.threading :only [on-ui]]
        [neko.ui :only [make-ui config]]
        [neko.application :only [defapplication]])
  (:import (java.util Calendar)
           (android.app Activity)
           (android.app DatePickerDialog DatePickerDialog$OnDateSetListener)
           (android.app DialogFragment)))

Now we will use proxy to create an instance of an anonymous class:

(defn date-picker [activity]
  (proxy [DialogFragment DatePickerDialog$OnDateSetListener] []
    (onCreateDialog [savedInstanceState]
      (let [c (Calendar/getInstance)
            year (.get c Calendar/YEAR)
            month (.get c Calendar/MONTH)
            day (.get c Calendar/DAY_OF_MONTH)]
        (DatePickerDialog. activity this year month day)))
     (onDateSet [view year month day])))

We will finish the onDateSet listener code in a bit. Calling this function creates an instance of a date-picker object. Let's change the definition of main-layout now to be a function and add a new button to the layout that will create then show this dialog.

(declare date-picker)
(defn show-picker [activity dp]
  (. dp show (. activity getFragmentManager) "datePicker"))
  
(defn main-layout [activity]
  [:linear-layout {:orientation :vertical,
                   :id-holder :true,
                   :def `mylayout}
   [:edit-text {:hint "Event name",
                :id ::name}]
   [:edit-text {:hint "Event location",
                :id ::location}]
   [:button {:text "...",
             :on-click (fn [_] (show-picker activity 
                                            (date-picker activity)))}]
   [:button {:text "+ Event",
             :on-click (fn [_](add-event))}]
   [:text-view {:text @listing,
                :id ::listing}]])

Before we continue, we need change the defactivity form since we are now using main-layout as a function with the activity passed in. Note the use of this.

(defactivity org.stuff.events.MyActivity
  :def a
  :on-create
  (fn [this bundle]
    (on-ui
     (set-content-view! this
      (make-ui (main-layout this))))
    (on-ui
     (set-elmt ::listing @listing))))

It is important to note that the :def a line will be ignored for the release build. You may use the a reference when you are debugging, but remember to remove all uses of a before making your release build. Also note that re-evaluating this form may not be enough since the :on-create callback needs to be called. Rotating your screen will do!

Update your ui and try hitting that ... button. Great, it works but doesn't do anything. We want that dialog update a :text-view with that chosen date. First we edit the layout:

(defn main-layout [activity]
  [:linear-layout {:orientation :vertical,
                   :id-holder :true,
                   :def `mylayout}
   [:edit-text {:hint "Event name",
                :id ::name}]
   [:edit-text {:hint "Event location",
                :id ::location}]
   [:linear-layout {:orientation :horizontal}
    [:text-view {:hint "Event date",
                 :id ::date}]
    [:button {:text "...",
              :on-click (fn [_] (show-picker activity
                                            (date-picker activity)))}]]
   [:button {:text "+ Event",
             :on-click (fn [_](add-event))}]
   [:text-view {:text @listing,
                :id ::listing}]])

Note that the new :text-view element and the button that spawns the picker are inside a nested :linear-layout element. Our date string will have the YYYYMMDD format. Now let's fill out that listener function in our proxy object.

(defn date-picker [activity]
  (proxy [DialogFragment DatePickerDialog$OnDateSetListener] []
    (onCreateDialog [savedInstanceState]
      (let [c (Calendar/getInstance)
            year (.get c Calendar/YEAR)
            month (.get c Calendar/MONTH)
            day (.get c Calendar/DAY_OF_MONTH)]
        (DatePickerDialog. activity this year month day)))
     (onDateSet [view year month day]
       (set-elmt ::date
		 (format "%d%02d%02d" year (inc month) day)))))

Now try the date-picker again. Let's change add-event to include the date. And let's clean it up a bit*.

(defn add-event []
  (swap! listing str 
  	 (apply format "%d - %s - %s\n" (map get-elmt [::date ::location ::name])))
  (update-ui))

Go ahead and try it out. Here's what our source file looks like so far:

(ns org.stuff.events.main
  (:use [neko.activity :only [defactivity set-content-view!]]
        [neko.threading :only [on-ui]]
        [neko.ui :only [make-ui config]])
  (:import (java.util Calendar)
           (android.app Activity)
           (android.app DatePickerDialog DatePickerDialog$OnDateSetListener)
           (android.app DialogFragment)))

(declare ^android.widget.LinearLayout mylayout)
(declare add-event)
(declare date-picker)

(defn show-picker [activity dp]
  (. dp show (. activity getFragmentManager) "datePicker"))


(def listing (atom ""))

(defn main-layout [activity]
  [:linear-layout {:orientation :vertical,
                   :id-holder :true,
                   :def `mylayout}
   [:edit-text {:hint "Event name",
                :id ::name}]
   [:edit-text {:hint "Event location",
                :id ::location}]
   [:linear-layout {:orientation :horizontal}
    [:text-view {:hint "Event date",
                 :id ::date}]
    [:button {:text "...",
              :on-click (fn [_] (show-picker activity
                                            (date-picker activity)))}]]
   [:button {:text "+ Event",
             :on-click (fn [_](add-event))}]
   [:text-view {:text @listing,
                :id ::listing}]])

(defn get-elmt [elmt]
  (str (.getText (elmt (.getTag mylayout)))))

(defn set-elmt [elmt s]
  (on-ui (config (elmt (.getTag mylayout)) :text s)))

(defn update-ui []
  (set-elmt ::listing @listing)
  (set-elmt ::location "")
  (set-elmt ::name ""))

(defn add-event []
  (swap! listing str 
  	 (apply format "%d - %s - %s\n" (map get-elmt [::date ::location ::name])))
  (update-ui))

(defn date-picker [activity]
  (proxy [DialogFragment DatePickerDialog$OnDateSetListener] []
    (onCreateDialog [savedInstanceState]
      (let [c (Calendar/getInstance)
            year (.get c Calendar/YEAR)
            month (.get c Calendar/MONTH)
            day (.get c Calendar/DAY_OF_MONTH)]
        (DatePickerDialog. activity this year month day)))
     (onDateSet [view year month day]
       (set-elmt ::date
		 (format "%d%02d%02d" year (inc month) day)))))

(defactivity org.stuff.events.MyActivity
  :def a
  :on-create
  (fn [this bundle]
    (on-ui
     (set-content-view! this
      (make-ui (main-layout this))))
    (on-ui
     (set-elmt ::listing @listing))))

###Sorting and Formatting the Listing Now that we have dates, we can sort our listing. Let's change our listing atom to hold a sorted-map.

(def listing (atom (sorted-map)))

We will now make a major change to the add-event function. Are you ready? Let's leave formatting out of this and only deal with updating our data structure. The keys to our map will be an integer representing the date. Each date should be able to hold multiple events, so the value of the key will be a vector of location and name vectors**.

(defn add-event []
  (let [date-key (try
                   (read-string (get-elmt ::date))
                   (catch RuntimeException e "Date string is empty!"))]
    (when (number? date-key)
      (swap! listing update-in [date-key] (fnil conj []) [(get-elmt ::location) (get-elmt ::name)])
      (update-ui))))

Since our listing atom no longer references a string, we need to format our map. Since our data structure contains a vector of vectors, we will implement this using two functions to prevent this code from looking too ugly: one to format the dates and one to format the events within each date. First, let's add a line to our ns form so we can use clojure.string's join function:

(ns org.stuff.events.main
  (:use [neko.activity :only [defactivity set-content-view!]]
        [neko.threading :only [on-ui]]
        [neko.ui :only [make-ui config]]
        [clojure.string :only [join]])
  (:import (java.util Calendar)
           (android.view View)
           (android.app Activity)
           (android.app DatePickerDialog DatePickerDialog$OnDateSetListener)
           (android.app DialogFragment)))

Now let's write our formatting functions*. Place this code somewhere before the main-layout definition:

(defn format-events [events]
  (->> (map (fn [[location event]]
              (format "%s - %s\n" location event))
            events)
       (join "                      ")))
 
(defn format-listing [lst]
  (->> (map (fn [[date events]]
               (format "%s - %s" date (format-events events)))
             lst)
       join))

Let's replace all occurrences in our code that assumes @listing to be a string with (format-listing @listing). In our layout:

(defn main-layout [activity]
  [:linear-layout {:orientation :vertical,
                   :id-holder :true,
                   :def `mylayout}
   [:edit-text {:hint "Event name",
                :id ::name}]
   [:edit-text {:hint "Event location",
                :id ::location}]
   [:linear-layout {:orientation :horizontal}
    [:text-view {:hint "Event date",
                 :id ::date}]
    [:button {:text "...",
              :on-click (fn [_] (show-picker activity
                                            (date-picker activity)))}]]
   [:button {:text "+ Event",
             :on-click (fn [_](add-event))}]
   [:text-view {:text (format-listing @listing),
                :id ::listing}]])

And in update-ui:

(defn update-ui []
  (set-elmt ::listing (format-listing @listing))
  (set-elmt ::location "")
  (set-elmt ::name "")
  (set-elmt ::date ""))

Depending on when you evaluated your new code and if/when you rotated your screen, your running app may have crashed and lost your REPL. Fear not, as this is expected to happen sooner or later. Just enter lein droid doall again at the command line.

###Succinctness is Power

Here is the source code so far:

(ns org.stuff.events.main
  (:use [neko.activity :only [defactivity set-content-view!]]
        [neko.threading :only [on-ui]]
        [neko.ui :only [make-ui config]]
        [neko.application :only [defapplication]]
        [clojure.string :only [join]])
  (:import (java.util Calendar)
           (android.view View)
           (android.app Activity)
           (android.app DatePickerDialog DatePickerDialog$OnDateSetListener)
           (android.app DialogFragment)))

(declare ^android.widget.LinearLayout mylayout)
(declare add-event)
(declare date-picker)
(defn show-picker [activity dp]
  (. dp show (. activity getFragmentManager) "datePicker"))

(def listing (atom (sorted-map)))

(defn format-events [events]
  (->> (map (fn [[location event]]
              (format "%s - %s\n" location event))
            events)
       (join "                      ")))
 
(defn format-listing [lst]
  (->> (map (fn [[date events]]
               (format "%s - %s" date (format-events events)))
             lst)
       join))

(defn main-layout [activity]
  [:linear-layout {:orientation :vertical,
                   :id-holder :true,
                   :def `mylayout}
   [:edit-text {:hint "Event name",
                :id ::name}]
   [:edit-text {:hint "Event location",
                :id ::location}]
   [:linear-layout {:orientation :horizontal}
    [:text-view {:hint "Event date",
                 :id ::date}]
    [:button {:text "...",
              :on-click (fn [_] (show-picker activity
                                            (date-picker activity)))}]]
   [:button {:text "+ Event",
             :on-click (fn [_](add-event))}]
   [:text-view {:text (format-listing @listing),
                :id ::listing}]])

(defn get-elmt [elmt]
  (str (.getText (elmt (.getTag mylayout)))))

(defn set-elmt [elmt s]
  (on-ui (config (elmt (.getTag mylayout)) :text s)))

(defn update-ui []
  (set-elmt ::listing (format-listing @listing))
  (set-elmt ::location "")
  (set-elmt ::name "")
  (set-elmt ::date ""))

(defn add-event []
  (let [date-key (try
                   (read-string (get-elmt ::date))
                   (catch RuntimeException e "Date string is empty!"))]
    (when (number? date-key)
      (swap! listing update-in [date-key] (fnil conj []) [(get-elmt ::location) (get-elmt ::name)])
      (update-ui))))

(defn date-picker [activity]
  (proxy [DialogFragment DatePickerDialog$OnDateSetListener] []
    (onCreateDialog [savedInstanceState]
      (let [c (Calendar/getInstance)
            year (.get c Calendar/YEAR)
            month (.get c Calendar/MONTH)
            day (.get c Calendar/DAY_OF_MONTH)]
        (DatePickerDialog. activity this year month day)))
     (onDateSet [view year month day]
       (set-elmt ::date
		 (format "%d%02d%02d" year (inc month) day)))))

(defactivity org.stuff.events.MyActivity
  :def a
  :on-create
  (fn [this bundle]
    (on-ui
     (set-content-view! this
      (make-ui (main-layout this))))
    (on-ui
     (set-elmt ::listing (format-listing @listing)))))

This is a bit over 100 lines of code. When I first attempted to write this app using Java, I was well over 1000 lines and didn't even have all this functionality before I gave up. If succinctness really is power6, then I'm never looking back.

The source code and the entire project directory can be found on my GitHub.

###Suggestions and Tips Hopefully this is enough to get you started developing Android apps in Clojure. I leave polishing the app as an exercise for you, dear reader. To make this app actually useful, you might want to make the sorted map data structure persistent using some sort of content provider. It might also help to make the :text-view for the listing scrollable once you have a lot of events listed.

#####Debugging and logging

You will probably run into errors and even bugs with the tools. adb will prove to be very valuable. In a spare terminal, run this command:

<sdk-path>/platform-tools/adb logcat

neko provides logging capabilities. Add this to the :use directive in the ns form:

[neko.log :only [deflog]]

Add this line near the top of your source file:

(deflog "MyTAG")

Now you can write lines to adb logcat by calling something like:

(log-d "My log message")

#####I lost my REPL! Given the instability of the current tools, runtime errors in the code, and other bugs, you will probably lose your connection to the REPL at some point during development. Follow these steps to get back into your groove. In the terminal:

lein do droid run, droid forward-port

And in emacs: M-x nrepl, local machine for 'Host', and '9999' for 'Port'. Now in the REPL, run:

(in-ns 'org.stuff.events.main)

Then evaluate the ns form to get back into your running app's namespace. The important thing to know is that all the new code you wrote after your last build has to be evaluated at the REPL in order to get back to your previous state. Running lein droid doall at the terminal at key points of development can save you some steps whenever you lose your REPL connection.

###Conclusion The tools available for Android development are still young. Needless to say, you will probably run into some issues and bugs along the way. If you are serious about pursuing this bleeding edge stuff, get connected with the maintainers of these tools. Alex Yakushev in particular has been very helpful and quick to respond to me personally as I was learning how to use lein-droid. Phil Hagelberg (a.k.a. technomancy) of lein is also pretty responsive.

Problems? Please open an issue on GitHub, and I'll try my best to help you out. Other comments? Feel free to get in touch and follow me on Twitter.

###Notes

* Thanks to Dave Yarwood for refactoring this to be DRYer (Don't Repeat Yourself).

** Thanks to GitHubber juergenhoetzel for cleaning up my previously imperative (and monstrous) code and making it more Clojure-y. Also, thanks again to Dave Yarwood for helping me refactor this.

1. In "Code's Worst Enemy" Steve Yegge writes:

Bigger is just something you have to live with in Java. Growth is a fact of life. Java is like a variant of the game of Tetris in which none of the pieces can fill gaps created by the other pieces, so all you can do is pile them up endlessly.

2. In "In Praise of Impractical Programming" Jacob Harris writes:

Learning to program is an important skill; learning how to be a programmer requires a far different type of course. For that, I have to thank a truly impractical introduction...

3. If you don't yet know Clojure, I recommend Joy of Clojure and watching Rich Hickey's talks. Despite it's power and simplicity, I wouldn't recommend Clojure to novice programmers. One should probably be fluent in at least two or three other languages before taking on Clojure. If you really want to dive into the rabbit hole, I recommend SICP (these lectures were filmed in 1986 but still relevant) before jumping into Clojure. Learning the Clojure way is quite a journey and deserves it's own blog post.

4. Use mutable state at your own judgment. Learn more about immutability, state, and identity here.

5. For reference, this code was translated from this page.

6. In "Succinctness is Power" Paul Graham writes:

If smaller source code is the purpose of high-level languages, and the power of something is how well it achieves its purpose, then the measure of the power of a programming language is how small it makes your programs.