Android全局样式规则未生效，求排查解决方法

问题说明 #

开发简易Android应用时，在全局主题中配置的文本样式未自动应用到TextView，仅为每个TextView显式设置android:textAppearance时样式才生效，希望实现全局统一生效。

现有代码 #

res/values/styles.xml #

<resources>
    <style name="Theme.XXXXX" parent="Theme.MaterialComponents">
        <item name="android:textAppearance">@style/Theme.XXXXX.TextAppearance</item>
    </style>
    <style name="Theme.XXXXX.TextAppearance" parent="TextAppearance.MaterialComponents.Body1">
        <item name="android:textSize">24sp</item>
    </style>
</resources>

AndroidManifest.xml（应用主题配置） #

<application
    android:dataExtractionRules="@xml/data_extraction_rules"
    android:fullBackupContent="@xml/backup_rules"
    android:icon="@drawable/ic_launcher"
    android:label="@string/app_name"
    android:supportsRtl="true"
    android:theme="@style/Theme.XXXXX">

Fragment布局（TextView部分） #

<LinearLayout
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:orientation="vertical"
    android:padding="@dimen/dialog_padding">

    <TextView
        android:id="@+id/introduction_overview"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:text="@string/introduction_overview" />
</LinearLayout>

排查方向与修改方案 #

1. 适配Material Components主题的属性规则 #

使用Theme.MaterialComponents时，全局文本样式不能直接通过android:textAppearance设置，需要针对Material Design定义的文本类型（如Body1、Headline等）配置对应属性：
修改styles.xml中的主题配置：

<style name="Theme.XXXXX" parent="Theme.MaterialComponents">
    <!-- 针对Body1类型文本设置全局样式，对应TextView默认的文本外观 -->
    <item name="textAppearanceBody1">@style/Theme.XXXXX.TextAppearance</item>
</style>

Material Components的TextView默认会使用textAppearanceBody1作为默认文本样式，因此配置该属性后，所有使用默认样式的TextView都会自动应用你定义的Theme.XXXXX.TextAppearance。

2. 全局覆盖TextView默认样式 #

如果希望所有TextView无论文本类型都统一应用该样式，可以通过android:textViewStyle全局配置TextView的默认样式：

<resources>
    <style name="Theme.XXXXX" parent="Theme.MaterialComponents">
        <item name="android:textViewStyle">@style/CustomTextViewStyle</item>
    </style>

    <style name="CustomTextViewStyle" parent="Widget.MaterialComponents.TextView">
        <item name="android:textAppearance">@style/Theme.XXXXX.TextAppearance</item>
    </style>

    <style name="Theme.XXXXX.TextAppearance" parent="TextAppearance.MaterialComponents.Body1">
        <item name="android:textSize">24sp</item>
    </style>
</resources>

该方式会让所有TextView继承CustomTextViewStyle，从而应用指定的文本外观。

补充说明 #

早期Android版本支持直接在主题中设置android:textAppearance全局生效，但Material Components主题调整了样式架构，采用分场景的文本外观属性设计，目的是更好地贴合Material Design的层级化文本规范，区分不同用途的文本样式（如标题、正文、辅助文本等）。因此直接设置android:textAppearance不再生效，需要使用对应场景的属性或全局覆盖TextView样式来实现需求。

内容的提问来源于stack exchange，提问作者arkascha