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 Yakuchev, 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 usingemacs with the 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 (Sep 25, 2013) and may introduce breaking changes. For your information, here are the versions of the tools that I am using:
Now that you have been forewarned, let's begin.
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.
Our app will be based off of this simple idea.
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-droidcommands.
This is how my ~/.lein/profiles.clj looks like:
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:
This will create a template file structure for an Android app. Open the project.clj file and change the neko version in :dependenciesto "3.0.0-preview1".
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 you device, and open an nREPL server within our running app.
Define the Layout
Let's open the main Clojure source file located at https://blog.csdn.net/weixin_33910460/article/details/src/events/src/clojure.main.clj in emacs and start defining the layout and the application. Now run this in emacs: M-x nrepl and enter the local machine for 'Host' and '9999' for 'Port'. Now you have a REPL inemacs which is connected to your running app. As you will see in a bit, this is neat-o torpedo.
To start evaluating definitions within our app's namespace, enter this command into the REPL: (in-ns 'org.stuff.events.main) Then, evaluate the ns form in the source file 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:
Evaluate this def form. Let's change the defactivity form to look like this:
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.
[pic here]
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-layoutshould now look like this:
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.)
[pic]
Adding Functionality
The app doesn't really do anything right now. Let's add attributes to our layout elements for functionality.
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 then try these at the REPL:
[pic here]
Let's write a helper function for our convenience:
Now let's have that button do some work.
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 use an atom4 to hold the current state of the listing.
Here, we have a constructor which returns a new atom (an empty string). This enables us to have multiple listing objects to work with if we want to. In this tutorial, we will have one listing defined by (def listing (mt-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:
[pic here]
Next, we want to update the ui with the listing.
Let's write another helper function for setting the text of our elements.
Let's have our callback function perform these two tasks:
Now try hitting that button. Cool, huh?
[pic here]
If you need to clear your listing, just run (def listing (mt-listing)).
Hitting the button should also clear the edit fields. Let's write a function to take care of all that.
And let's have our add-event function call this.
If you're coding along at home (and I hope you are!), here is what our code should look like so far:
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
If you rotated your screen, you may have noticed that the listing disappears. Let's fix that, shall we?
Rotate your screen. 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:
Before we continue, let's change the defactivity form a bit so we can access our activity outside of this form.
Note that when the :def attribute is removed, we can refer to our MyActivity by myActivity. This is how we will refer to our activity in the upcoming function. 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!
Now we will use proxy to create an instance of an anonymous class:
Calling this function creates an instance of a date-picker object. Let's add a new button to the layout that will create then show this dialog.
Update your ui and try hitting that ... button. Now let's have that dialog update a :text-view with that chosen date.
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.
Now try the date-picker again. Let's change add-event to include the date.
Here's what our source file looks like so far:
Sorting and Formatting the Listing
Now that we have dates, we can sort our listing. Let's change our mt-listing constructor to return a sorted-map atom.
We will now make a huge 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.
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 nested loops. To prevent this code from looking like a monstrosity, let's split it into two functions: one to loop over the dates and another to loop over the events within each date. Here we go.
Let's replace all occurrences in our code that assumes @listing to be a string with (format-listing @listing). In our layout:
And in update-ui:
Succinctness is Power
Here is the source code so far:
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:
neko provides logging capabilities. Add this to the :use directive in the ns form:
Add this line near the top of your source file:
Now you can write lines to adb logcat by calling something like:
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:
And in emacs: M-x nrepl, local machine for 'Host', and '9999' for 'Port'. Now in the REPL, run:
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) oflein is also pretty responsive.
Feel free to get in touch and follow me on Twitter.
Notes
1 http://steve-yegge.blogspot.com/2007/12/codes-worst-enemy.html
2 http://www.niemanlab.org/2011/11/in-praise-of-impractical-programming/
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 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.