Android项目引入AAR库后Application及Activity主题失效如何解决

问题根因 #

Android资源匹配规则中，带特定配置限定符的资源优先级高于无匹配限定符的默认资源，且相同限定符场景下，主应用模块的资源优先级始终高于第三方依赖库的资源。
你仅在默认res/values路径下定义了AppTheme，而引入的AAR库在横屏、大屏等高优先级限定符路径下也定义了同名的AppTheme，当设备运行场景匹配到这些限定符时，系统会优先加载库中对应限定符的主题，导致你自定义的默认主题失效。

解决方案 #

• 方案1：补充对应限定符的主题定义（无需修改现有引用，兼容性最好）
  在你的主应用模块中新建和AAR库对应的带限定符资源目录：res/values-land、res/values-sw600dp-v13，每个目录下新建styles.xml文件，在文件内定义和默认配置完全一致的AppTheme即可，示例：

  <resources>
      <style name="AppTheme" parent="@style/AppTheme" />
      <!-- 也可以直接复制默认values下AppTheme的所有配置 -->
  </resources>
  

  同限定符下主应用资源优先级更高，系统会优先加载你定义的主题。

• 方案2：重命名自定义主题（彻底规避重名冲突）
  将你自己的主题重命名为不会和库冲突的名称，比如改为MyAppTheme，然后修改Manifest中android:theme属性的引用为@style/MyAppTheme。这种方案完全避开了重名问题，后续不管库更新新增多少限定符的同名主题，都不会影响你的应用配置。

• 方案3：配置Gradle资源合并规则
  如果你不想修改业务代码，可以在app模块的build.gradle中配置资源合并优先级，强制优先使用主应用的主题资源：

  android {
      // 其他配置...
      packagingOptions {
          resources {
              // 优先保留主应用下的styles.xml资源
              pickFirst "res/values/styles.xml"
              pickFirst "res/values-land/styles.xml"
              pickFirst "res/values-sw600dp-v13/styles.xml"
              // 也可以直接排除库中的冲突主题文件，需根据库的实际文件路径调整匹配规则
              // exclude "**/values*/values*.xml"
          }
      }
  }
  

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