FAQ

Is the quality production-ready?

Seems like the code it's pretty stable. I'm testing it heavily on different devices and on real projects. If you're experiencing any issues, please let me know.

How often does the API change?

The API changes from time to time, as I discover better ways of implementing things. I always try to deprecate things first to give the users time to switch.

Are you using Lollipop's API on Lollipop devices?

Partially. On 5.+ Carbon uses Lollipop's native ripples, shadows and rounded corners. Also, the Carbon themes remap some of Material attributes.

My minApi is 21, is there something useful in Carbon for me?

I think there is. Carbon simplifies many things, like specifying corner radius or stroke color. Some of widgets are different, like DropDown which shows its menu placed nicely over the selected item. You may also like additional widgets, layouts, predefined styles, easy animations, RecyclerView's components and many other things.

Are you thinking about uploading the library to Maven?

Done!

Do you plan to offer your Material elements as separate modules? I would prefer not to include the whole project only to use ripples.

I thought about it, but it's not that easy, because almost everything is tightly integrated with other components. For example the ripple. Due to clipping issues in Android < 5.0 it's not possible to draw borderless backgrounds just by setting the background drawable. That's why I would have to export the ripple with all layouts only to make the borderless mode work.

If you wish, you can copy RippleDrawable.java to your project and integrate it with your code manually.

Can you add [put your feature name here]?

If it's possible and reasonable, sure! Just let me know.

The shadows aren't working. It says something about the RenderScript

You have to add these lines to your android build config:

renderscriptTargetApi 20
renderscriptSupportModeEnabled true

Carbon uses RenderScript for generating shadows. Gradle doesn't support renderscript very well, so it has to be done that way. RenderScript API 21+ is not supported on older platforms. Using newer API will result in compilation error:

Renderscript support mode is not currently supported with renderscript target 21+

The shadows aren't working in one of my layouts

Make sure that your layout's root/parent is a carbon.widget.*Layout. Shadows are drawn by parent layouts, not by views.

What is the debug mode? How to enable it?

Debug mode was replaced with DebugOverlay.

See: carbon_debugMode