Android AutoParcel

Port of Google AutoValue for Android with Parcelable generation goodies.

Why AutoValue?

Because it's awesome. I can't explain it better than that.

Ok then why a fork for Android?

Because AutoValue is not extensible yet. This fork adds automatic Parcelable implementation for your POJOS. It's easy as just adding implements Parcelable.

Fine, how do I use it?

@AutoParcel
abstract class SomeModel implements Parcelable {
  abstract String name();
  abstract List<SomeSubModel> subModels();
  abstract Map<String, OtherSubModel> modelsMap();

  static SomeModel create(String name, List<SomeSubModel> subModels, Map<String, OtherSubModel> modelsMap) {
    return new AutoParcel_SomeModel(name, subModels, modelsMap);
  }
}

That's that simple. And you get Parcelable, hashCode, equals and toString implementations for free. As your models evolve you don't need to worry about keeping all the boilerplate in sync with the new implementation, it's already taken care of.

Sounds great, where can I download it?

The easy way is to use Gradle.

buildscript {
  repositories {
    mavenCentral()
    jcenter()
  }
  dependencies {
    classpath 'com.android.tools.build:gradle:0.14.4'
    classpath 'com.neenbedankt.gradle.plugins:android-apt:1.4'
  }
}

apply plugin: 'com.android.application'
apply plugin: 'com.neenbedankt.android-apt'

dependencies {
  compile 'com.github.frankiesardo:auto-parcel:0.3'
  apt 'com.github.frankiesardo:auto-parcel-processor:0.3'
}

repositories {
  mavenCentral()
  jcenter()
}

I recommend using the android-apt plugin so that Android Studio picks up the generated files. Check out the sample project for a working example.

License