This isn't the most exciting release, sorry. The Play Store version of the release notes would be "Bug fixes & performance improvements".

• Upgrade to Yoga 1.7.0. The previous release should be compatible.
• Text styling is supported again.

Declarative Data Handling with Sections

We are all very excited about this release! It includes our new Sections API for declarative data handling for lists. In order to use it, you need to include the three new modules litho-sections-core, litho-sections-annotations and litho-sections-processor.

Read more about Sections in Mihaela's announcement post, watch the announcement talk from Droidcon UK or jump straight into the Sections Tutorial.

New APIs for Sub-Component Testing

We have a brand new set of fluid APIs on top of AssertJ and Hamcrest to help you verify that components build the sub-components you expect. Check out the documentation!

Litho <3 Kotlin

We've made a bunch of smaller changes that make writing Component Specs in Kotlin easier. Most things should Just Work, but you can refer to our meta issue to learn about some remaining necessary workarounds.

There is also a full sample app written in Kotlin for you to check out, as well as updated getting started instructions for Kotlin.

In typical social media app fashion, this release is mostly "bug fixes and performance improvements".

We have also made some improvements to the code generator for Kotlin specs. While we don't officially support Kotlin specs yet, we'd be super interested in your feedback!

It's been 295 commits since the last release! Here are some of the highlights:

• withLayout is now deprecated! Read more in the announcement. Breaking change: This means that certain prop-names that were previously allowed can no longer be used in custom component specs.
• Various Yoga properties now accept floats as values.
• The published javadoc JARs now contain 100% more javadoc.
• A preview of our new sub-component testing APIs. Check out the sample app for examples. But be aware that these are likely going to change!
• Some quality of life fixes for Kotlin component generation. Watch this space!
• Separate left and right padding settings for Recycler.

Well this was a lot faster this time, wasn't it?

Features

This release features one significant long-awaited change: Support for SnapHelper in Recycler.
(46eb25a0a749b7b873cfc116e22ea918ac6df97a)

This means that you can finally implement any kind of snapping behavior by just passing a SnapHelper to a Recycler component as a Prop. Check out 150d3e4c64321778eeaab4b8b3e76e5e4138f for an example of how we use this in our sample App.

Leave your feedback about this in our community group: https://www.facebook.com/groups/litho.android/permalink/111049929590158/

It's been a while! Litho v0.6.0 brings 184 new commits since the last release.

Breaking Changes

• 8452635a5866452faad928faae76733963d08313 changes the way aspect ratios are handled in Yoga. Learn more about how this affects you in Emil's post.
• d539cf7f3b5b671e43a4ca4feb17cef43001ef7f lays the groundwork for requiring unique keys in the 0.7.0 release. Learn how to future-proof your app in Mihaela's post.
• 45bb9911984334a519c8976860091e7f4827d2de: ComponentInfo was renamed RenderInfo.

Other changes

• Changes to visibility handlers: db2b90b2009b5f8149eb9abab6e2ca46af296efe, 264ca5f9c820843908bffac095cb44eecbcd667f
• litho-fresco now works with Fresco 1.5.0: 63499e5ff6a58c0aec9666247cb34b8ef2fae9fa
• The Sample app builds with BUCK again. 😌

Thanks

Thanks to our external contributors this release: @jollycopper and @AllanWang!

Sorry to disappoint, but this release doesn't bring any major changes. :(

Yoga had a big release, however, and got bumped to 1.6.0, which is why we're going up by one minor version as well. You can find the Yoga release notes on their GitHub page.

Bugfixes

• Fixes an issue with the released POM files that didn't include any transitive dependencies.

Highlights

• The sample application now uses Activities and should be closer to what you would expect from a standard Android application.

Features

• fontFamily style support to Text component
• shadowElevation support

Bugfixes

• Handle null for optional vararg properties
• Make preAllocateMountContent thread-safe
• Fix maxLength filter for text inputs

Highlights

Prop Defaults from Resources

Prop defaults now also support default values from Resources via setting a resType and resId.

@PropDefault(resType = ResType.DIMEN_SIZE, resId = R.dimen.default_spacing)
static float prop3;

Massive kudos to @pavlospt for implementing this! 🍰 🎉

Highlights

Espresso Support

We added some basic support for Espresso matchers. Check out the docs and let us know what you think.

Stetho package change

This is a breaking change. All Stetho-related utilities in the litho-stetho package now live in the com.facebook.litho.stetho package namespace. They were previously part of com.facebook.litho.

Miscellaneous

• Yoga definitions are now included in the Javadocs.
• Fixes to how Stetho displays colors + address crashes in rare circumstances.
• Make use of Google's new Maven repository.
• The annotation processor tests have moved to open source.

Release highlights

• Update Yoga dependency to 1.5.0.
• Remove interdependency from litho-widget on litho-fresco.
• Fix dependencies on litho-annotation.

This release removes the license from generated code which was unintentionally present in v0.1.0.

Initial Release