Project Lombok - android instructions

Feature Overview

Version: @VERSION@ | changelog

Android development with lombok is possible. Lombok should be a compile-time only dependency, as otherwise the entirety of lombok will end up in your DEX files, wasting precious space on android devices. Also, errors will occur due to the native libraries present in lombok.jar itself. Unfortunately, android does not (yet) understand the concept of a compile-time-only dependency, so you need to mess with your build files to make it work.

Android also does not have a complete JRE library stack; in particular, it does not have the @java.beans.ConstructorProperties annotation, therefore you have to stop lombok from generating these:

The suppressConstructorProperties property can be set to false when using @XArgsConstructor Annotations.
Starting with Lombok >= 1.14.0 you can instead a lombok.config file to the root of your project to disable ConstructorProperties project wide. Add the following line to lombok.config:
```
lombok.anyConstructor.suppressConstructorProperties = true
```
See the configuration documentation for more information on how to set up your project with a lombok config file.

The instructions listed below are excerpts from The AndroidAnnotations project cookbook. You may wish to refer to that documentation for complete instructions; lombok is just the equivalent to androidannotations-VERSION.jar; there is no -api aspect.

Eclipse

In eclipse, create a 'lightweight' lombok jar that contains only the annotations by running:

java -jar lombok.jar publicApi

Then, add the lombok-api.jar file created by running this command to your android project instead of the complete lombok.jar, and, as usual, install lombok into eclipse by double-clicking lombok.jar.

Ant

Find build.xml in ${ANDROID_SDK_ROOT}/tools/ant/build.xml and copy the -compile target into the paste buffer.
Copy this to the build.xml of your own project, right before the <import file="${sdk.dir}/tools/ant/build.xml"> line.
Create a compile-libs directory in your own project and copy the complete lombok.jar to it.
Now modify the <classpath> entry inside the <javac> task in the -compile target you just copied:
add <fileset dir="compile-libs" includes="*.jar" /> to it.

Maven

You should be able to just follow the normal lombok with maven instructions.
Note that if you use android, eclipse, and maven together you may have to replace lombok.jar in your eclipse android project's build path (which you can modify in that project's properties page) with lombok-api.jar, as produced in the procedure explained for Eclipse, above.

Gradle

Make sure that the version of your android plugin is >= 0.4.3
Add Lombok to your application's dependencies block:
```
	provided "org.projectlombok:lombok:1.12.6"
```
When using android-apt, you also have to specify Lombok as an annotation processor (with the apt directive) in the dependencies block:
```
	provided "org.projectlombok:lombok:1.12.6"
	apt "org.projectlombok:lombok:1.12.6"
```

Android Studio

Follow the previous instructions (Gradle). In addition to setting up your gradle project correctly, you need to add the Lombok IntelliJ plugin to add lombok support to Android Studio:

Go to File > Settings > Plugins
Click on Browse repositories...
Search for Lombok Plugin
Click on Install plugin
Restart Android Studio