Android SDK库样式跨模块引用崩溃问题求助

我之前也碰到过一模一样的问题！这种跨模块引用SDK库样式导致的UnsupportedOperationException: Failed to resolve attribute崩溃，大多是因为主题属性没有正确传递或者库的资源没有被正确依赖，下面给你几个实用的排查和解决方向：

• 确保引用模块的主题包含库样式依赖的所有属性
  库的样式里如果用到了像?attr/colorPrimary、?attr/toolbarStyle这类主题属性，引用该库的模块必须在自己的主题中为这些属性赋值。举个例子：
  假设SDK库的样式是这样的：

  <style name="LibraryCardStyle" parent="Widget.MaterialComponents.CardView">
      <item name="cardBackgroundColor">?attr/colorSurface</item>
      <item name="android:elevation">?attr/cardElevation</item>
  </style>
  

  那引用模块的styles.xml里的App主题必须定义这些属性：

  <style name="AppTheme" parent="Theme.MaterialComponents.Light.NoActionBar">
      <item name="colorSurface">@color/app_surface_color</item>
      <item name="cardElevation">4dp</item>
      <!-- 其他库样式依赖的属性也要逐一定义 -->
  </style>
  

  同时要保证引用库的Activity/Fragment所在的组件，在Manifest里指定了这个主题：

  <activity android:name=".features.home.HomeActivity"
            android:theme="@style/AppTheme" />
  

• 检查模块依赖配置是否正确
  在引用SDK库的模块的build.gradle（或build.gradle.kts）中，要确保正确添加了库的依赖：
  如果是本地模块依赖：
  Groovy：

  dependencies {
      implementation project(':your-sdk-library-module')
  }
  

  Kotlin DSL：

  dependencies {
      implementation(project(":your-sdk-library-module"))
  }
  

  如果是远程Maven库，要确保引用了正确的groupId、artifactId和版本号，并且同步了依赖。

• 避免库样式使用未声明的自定义属性
  如果SDK库中使用了自定义属性，必须在库的attrs.xml中声明，同时引用模块的主题要为这些属性赋值（或者库的样式提供默认值）。比如：
  库的attrs.xml声明自定义属性：

  <declare-styleable name="LibraryThemeAttrs">
      <attr name="libraryAccentColor" format="color" />
  </declare-styleable>
  

  库的样式可以给属性设置默认值，避免引用模块未赋值时崩溃：

  <style name="LibraryButtonStyle" parent="Widget.AppCompat.Button">
      <item name="android:textColor">@color/library_default_accent</item>
      <item name="android:textColor">?attr/libraryAccentColor</item>
  </style>
  

• 清理缓存并重建项目
  有时候是Android Studio的资源缓存导致的问题，执行File -> Invalidate Caches...，选择Invalidate and Restart，然后重新Build整个项目，很多奇怪的资源解析问题都能通过这个方法解决。

• 排查资源混淆问题
  如果引用模块开启了资源混淆（比如AndResGuard），要确保SDK库的资源没有被误混淆，需要在混淆规则中添加库的资源白名单，避免属性或样式被删除。

总的来说，核心问题就是引用模块的主题没有提供库样式所依赖的属性值，或者依赖配置错误导致库资源未被正确加载。按照上面的步骤逐一排查，应该能解决这个崩溃问题。

内容的提问来源于stack exchange，提问作者Mohamed Zakaria El-Zoghbi