A Poor Default (Or: Why Your Button Does Not Work)
Android Studio 4.1’s new-project wizard creates projects that include
the Material Components for Android library by default, and sets up
the default theme to use
a base, at least when using many of the templates.
For an experienced developer, this is a reasonable choice. However, a new-project wizard should not be aimed at experienced developers, as experienced developers probably already have their project. A new-project wizard should be aimed at newcomers, because their very first experience with Android app development will come from the project that the wizard creates.
And for newcomers, Material Components for Android is a dreadful choice, in part because newcomers have no idea that this library exists, what it is for, or how it impacts app development.
For example, suppose you are a brand-new Android app developer. You install
Android Studio 4.1 and use the new-project wizard. You add a
<Button> to your
activity_main layout resource, and you want to change its background.
At this point, you’re already screwed, and you are only a few minutes into your first attempt at app development.
Suppose you decide that reading the documentation is the thing to do.
You go to the documentation for
and you see a helpful paragraph on just your topic of concern:
Every button is styled using the system’s default button background, which is often different from one version of the platform to another. If you are not satisfied with the default button style, you can customize it. For more details and code samples, see the Styling Your Button guide.
So you click that “Styling Your Button” link
and proceed to read about how you might consider setting your theme to
because that page has not been updated in six years or so.
But, it goes on to say:
To customize individual buttons with a different background, specify the
android:backgroundattribute with a drawable or color resource.
Fantastic! So you set up a color for your
android:background, or maybe even a
drawable resource, as this developer did…
and you find that your background does not take effect.
Why? Because Material Components for Android does not work that way.
If you happen to know where
the Material Components for Android documentation for
resides, you will stumble upon:
<Button>is auto-inflated as
MaterialComponentsViewInflaterwhen using a non-
Even experienced developers might have a difficult time interpreting that.
But that might lead you to this page on
where it says:
Do not use the
So, the documentation says to use
android:background, and the documentation says not to use
MaterialButton documentation does not do a particularly good job of explaining
what the alternative is (hint: use
android:backgroundTint or adjust
your theme to change the color).
So, we have to wander to multiple sites and deal with conflicting documentation, just to set a background color on a button.
AppCompat is far from perfect. But, it at least works fairly conventionally. Yes,
inflater magic means that
<Button> turns into an
tends to behave like a regular
Button, at least in terms of things like
setting the background color. Newcomers to Android, reading the documentation or Medium
posts or Stack Overflow, are more likely to succeed in what they are trying to do
with AppCompat than with the Material Components for Android.
Moreover, AppCompat has been the official Google recommended choice for quite a few years now. Quite a bit has been written specifically for AppCompat. So, answers to questions like “how do I BLEEP-ing well set a background color on a button?” are likely to exist. Far fewer of those answers will exist for Material Components for Android… and that even assume the newcomer has any idea that Material Components for Android has something to do with their project.
This is not to hate on Material Components for Android as a library. It is a perfectly cromulent set of widgets for experienced developers. IMHO, it is a poor choice to inflict upon newcomers, and that’s why I think it is a poor choice as the default for Android Studio’s new-project wizard.
Interested in Jetpack Compose?
jetc.dev has a weekly newsletter of the latest articles, samples, and other details of Compose development!