Hacking the plugin

This documents explains how to setup an environment where you can modify lein-droid, experiment with it, implement new features, fix bugs etc.

Code layout

leiningen.droid is a facade namespace for all other lein-droid subtasks. It is responsible for adding different defaults to the project map by calling leininingen.droid.utils/android-parameters, before it passes the project map to the subtasks.

leiningen.droid.aar contains functions that operate on AAR archives. AAR is a special packaging format for Android libraries that combines compiled code and resources. Lein-droid must first unzip AAR dependencies before they can be used.

leininged.droid.classpath initializes several hooks that modify Leiningen behavior in certain ways. For example, there is a hook that adds a proper android.jar to the classpath every time get-classpath is called; a hook for removing duplicate dependencies from the project etc.

leiningen.droid.(code-gen|compile|build|deploy) mostly consist of subtasks and helper functions that bring the project the whole way from clean target to a deployed application.

leiningen.droid.manifest hosts functions that operate on AndroidManifest.xml and its templates, create and parse manifests.

leiningen.droid.new namespace is a home to new subtask that creates new Clojure-Android projects from a template. Template resources live in res/templates/ directory.

leiningen.droid.sideload is an utility namespace that allows to dynamically load some tooling libraries that can only be obtained from SDK directory, and exposes functionality of those libraries via reflection.

leiningen.droid.test provides a subtask for running local tests in Clojure-Android projects.

leiningen.droid.utils contains general-purpose utilities which are used by other namespaces.

Dev environment

You can develop lein-droid using CIDER or any other REPL provider. If used with CIDER, you’d have to comment :eval-in-leiningen true line, and add [leiningen "2.5.1"] to the dependencies (this is a workaround for a bug in Leiningen). Now you can jack into the plugin.

Another way to use the development plugin is to modify source files and run the lein droid ... commands from the project folder. Follow the steps below to make sure the sources of lein-droid are used, not a packaged jar from Clojars.

1. There is a function leiningen.droid.utils/proj. By default it reads project.clj file of a sample project. Modify it to read any Android project

you want, so that you can call commands on your own project right from the REPL.

1. Call lein droid ... subtasks from lein-droid/ directory, it won’t use

lein-droid JAR from the Maven repository, but the code from the disk.

1. Go to leiningen.droid/droid function and replace this:

(doto project
  sdk-sanity-check
  extract-aar-dependencies
  (execute-subtask cmd args))

with:

(doto (proj)
  sdk-sanity-check
  extract-aar-dependencies
  (execute-subtask cmd args))

Now you are able to execute lein-droid subtasks from lein-droid/ folder like you do from your project folder, and using the latest changes you’ve made to the plugin. But to do that you’ll have to have :eval-in-leiningen true in lein-droid (i.e. plugin)’s project.clj, so you must comment/uncomment that line every time you restart a REPL.