Android如何排除com.google.android.material对应用的影响但保留给第三方依赖使用

问题根因 #

你遇到的UI错乱是因为项目引入Material Components库后，AppCompat默认会将全局的AppCompat控件（比如Button、TextView）自动替换为Material库的对应实现，这些控件的默认样式和你原有项目使用的AppCompat样式不一致，才会出现UI异常。因为Android的Runtime类路径是全局共享的，无法单独隔离XYZ依赖使用的Material库，所以我们可以通过禁用全局控件替换的方式，保证你原有项目的UI不受影响，同时XYZ内部依然可以正常使用Material库。

可行方案 #

方案1：禁用全局Material控件自动替换（成本最低，优先推荐） #

在你的应用主主题文件（通常为res/values/themes.xml或res/values/styles.xml中你的App使用的顶层主题）中添加如下配置，强制使用AppCompat的控件和样式：

<style name="你的App主主题名" parent="Theme.AppCompat.xxx"> <!-- 确保父主题明确指定为AppCompat系列，不要使用Material系列主题 -->
    <!-- 原有主题配置保持不变 -->
    <item name="viewInflaterClass">androidx.appcompat.app.AppCompatViewInflater</item>
    <!-- 强制对应控件使用AppCompat默认样式，有其他异常控件可对应补充配置 -->
    <item name="materialButtonStyle">@style/Widget.AppCompat.Button</item>
    <item name="materialTextViewStyle">@style/Widget.AppCompat.TextView</item>
    <item name="materialEditTextStyle">@style/Widget.AppCompat.EditText</item>
    <item name="materialCheckBoxStyle">@style/Widget.AppCompat.CompoundButton.CheckBox</item>
</style>

改完后清理项目重新构建即可，你的原有UI会恢复到引入依赖前的效果，XYZ内部的UI如果使用了自定义的Material主题，依然可以正常调用Material库的功能。

方案2：强制指定Material库版本（适用于XYZ依赖的Material版本过旧/过新导致兼容性问题的场景） #

如果你希望控制Material库的版本避免未知兼容性问题，可以在应用级build.gradle中显式依赖指定版本的Material库并强制生效：

dependencies {
    // 显式依赖你需要的Material版本，force=true强制全局使用该版本
    implementation("com.google.android.material:material:1.9.0") {
        force = true
    }
    // XYZ依赖不需要加exclude配置，保留原有的依赖声明即可
    implementation "XYZ:1.0.7"
}

修改后依然需要配合方案1的主题配置，保证你的应用原有UI不受影响。

验证步骤 #

1. 执行Build -> Clean Project清理旧的构建缓存
2. 重新构建安装App，检查原有页面UI是否恢复正常
3. 进入XYZ依赖提供的页面，检查功能和UI是否正常加载

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