How to use device default theme for app?

Question

I have an app that I want to develop for Android 2.1, 2.2, 2.3.3, 3.0/3.1 and 4.0.x. Between those API levels, there are about 3 different types of Themes. The latest 4.0.x theme is Holo.

Anyways, I want my app to use the default Android theme for whatever device it's on. If it's on a 4.0.x device, I want it to use Holo. If it's on 2.3.3 I want it to use the theme from that version of Android. etc...

Is there a simple way to approach this? I noticed that with 4.0, they added a Theme.DeviceDefault theme that you can use, but this doesn't help me for older API levels. What is the best approach to this?

Answer 1

There are currently up to 3, sometimes 4 Themes available for Android devices (.Light variations and similar not included)

Theme

the default for the earliest versions of Android up to 2.3 Gingerbread(10), including some minor style changes in those versions

---

Theme.Holo

introduced with Android 3.0 Honeycomb (11)

---

Theme.Material

new in Android 5.0 Lollipop (21)

---

Theme.DeviceDefault

(Could be anything)

introduced with 4.0 Ice Cream Sandwich (14), a theme that can be customized by the device manufacturer. It represents the native look of the device - i.e. Holo or Material on Nexus devices (& in Android Studio's design editor), maybe something custom on other devices. In case "something custom" isn't an option, those devices must come with the stock themes. Apps that want the stock theme have to specify it though.

---

What is the best approach to this?

No theme + targetSdkVersion >= 14

The simplest, but not necessarily best option is to define no theme at all. Android will then select the default for you. But Android does not want to surprise your app with themes you're not expecting so it falls back to the Theme you probably had designed your app for. It does so by looking at the android:targetSdkVersion within AndroidManifest.xml (which can nowadays be set via gradle).

• Apps that target old platforms, which had only Theme (i.e. API levels 3-10), will get only Theme.
• Apps targeting 11-13 get Theme.Holo.
• 14 or above will get Theme.DeviceDefault.

Since this is just for backwards compatibility, you won't get Theme.Material on your old Gingerbread phone. Therefore no theme + target 14+ = device default.

Specifying different themes

Android's resource overlay system allows to specify styles based on device API level. For example different versions of a style in res/values-v11 and res/values-v21. This is also what any newly created apps via Android Studio will setup for you.

As an example, the most basic setup for a .Light themed app looks like this:

/res/values/styles.xml is applied to every device and serves as base

<resources>     <style name="AppTheme" parent="android:Theme.Light"/> </resources> 

---

/res/values-v11/styles.xml is loaded on all devices that have API level 11 and above (including those that are 21 and above). But just the newest version of "AppTheme" is actually used.

<resources>     <style name="AppTheme" parent="android:Theme.Holo.Light"/> </resources> 

---

/res/values-v21/styles.xml

<resources>     <style name="AppTheme" parent="android:Theme.Material.Light"/> </resources> 

Note: alternatively specifying Theme.DeviceDefault in /res/values-v14/styles.xml should be enough for having a default look but that doesn't allow to fine tune the design. Doesn't hurt to add the v14 override. DeviceDefault and Holo could be different after all.

---

AndroidManifest.xml is the place where the custom theme is put to use. E.g. as application wide default:

... <application     android:theme="@style/AppTheme"     ... 

---

Links to official documentation

Select a theme based on platform version - Official doc for defining different styles via resource configurations

Holo Everywhere - blog post that explains the default mechanism and DeviceDefault / Holo theme

Using the Material Theme - material documentation