Google Git
Sign in
android / platform / external / lottie / de498aa4
commitde498aa4289058278cea4e60bcf26d10f967f2d0[log] [tgz]
authorNathanael Silverman <nathanael.silverman@airbnb.com>Tue Nov 08 14:29:16 2016 -0800
committerNathanael Silverman <nathanael.silverman@airbnb.com>Tue Nov 08 14:29:16 2016 -0800
tree53b82d810329b7656c10c1df86ad06b587c2b384
parent3ad920b6011b0abc9192f03c985d77976498f5db [diff]
Delay setProgress(...) if animation is loading
1 file changed
tree: 53b82d810329b7656c10c1df86ad06b587c2b384
  1. gifs/
  2. gradle/
  3. lottie/
  4. LottieSample/
  5. .gitignore
  6. build.gradle
  7. gradle.properties
  8. gradlew
  9. gradlew.bat
  10. LICENSE
  11. README.md
  12. settings.gradle
README.md

Lottie for Android (and iOS)

Lottie is a mobile library for Andorid and iOS that parses Adobe After Effects animations exported as json with bodymovin and renders them natively on mobile!

For the first time, designers can create and ship beautiful animations without an enginineer painstakingly recreating it be hand.

They say a picture is worth 1,000 words so here are 6,000

Alarm Diamond Lightbulb Business AllSet

Selfie

Download

Gradle is the only supported build configuration, so just add the dependency to your project build.gradle file:

dependencies {
  compile 'com.airbnb.android:lottie-android:1.0.0'
}

Alternatives

  1. Build animations by hand. Building animations by hand is a huge time commitment for design and engingeering across Android and iOS. It's often hard or even impossible to justify spending so much time to get an animation right.
  2. Gifs. Gifs are more than double the size of a bodymovin JSON and are rendered at a fixed size that can't be scaled up to match large and high density screens.
  3. Png sequences. Png sequences are even worse than gifs in that their file sizes are often 30-50x the size of the bodymovin json and also can't be scaled up.

Using Lottie

Using Lottie is as simple as adding an image to an ImageView. LottieAnimationView can consume JSON stored in one of two ways:

  1. By specifying the JSON filename in the /assets directory of your app.
  2. By passing in the raw JSONObject. With this, you have the option of hosting your animations on your server and downloading them through a network request! This opens up the possibility of a/b testing animations or providing animations that are very specific to the user such as an animated Eifel Tower when an Airbnb traveler books a listing in Paris.

Why is it called Lottie?

Lottie is named after a German film director and the foremost pioneer of silhouette animation. Her best known films are The Adventures of Prince Achmed (1926) – the oldest surviving feature-length animated film, preceding Walt Disney's feature-length Snow White and the Seven Dwarfs (1937) by over ten years The art of Lotte Reineger

##Try it out Clone this repository and run the LottieSample module to see a bunch of sample animations. The JSON files for them are located in /assets.

Contributing

Contributers are more than welcome. Just upload a PR with a description of your changes. Lottie uses Facebook screenshot tests for Android to identify pixel level changes/breakages. Please run ./gradlew --daemon recordMode screenshotTests before uploading a PR to ensure that nothing has broken.

If you would like to add more JSON files and screenshot tests, feel free to do so and add the test to LottieTest.