Android库模块可被App修改的属性声明问题（API 21+）

嘿，我之前也踩过这个模拟器正常、真机拉胯的坑，给你梳理几个大概率的原因和对应的解决办法：

1. 命名空间没搞对，属性等于白设 #

很多时候真机失效都是因为App模块在设置属性时，命名空间引用错了。模拟器可能对命名空间的容错性更高，但真机就认死理。

• 正确操作：在App的styles.xml或者布局文件里，一定要声明正确的命名空间。最简单的方式是用xmlns:app="http://schemas.android.com/apk/res-auto"，这个会自动匹配你依赖的库的自定义属性。比如：

  <resources xmlns:app="http://schemas.android.com/apk/res-auto">
      <style name="AppTheme" parent="Theme.MaterialComponents.DayNight.NoActionBar">
          <item name="app:appSharedKey">MY_REAL_BUSINESS_KEY</item>
          <item name="app:appDebugMode">true</item>
      </style>
  </resources>
  

2. 获取属性的Context不对，读的是默认主题 #

如果你在库初始化时用的是ApplicationContext，但App的自定义主题是设置在Activity上的，那ApplicationContext的主题是系统默认的，根本没包含你设置的属性。模拟器可能因为缓存或者默认主题的兼容逻辑，碰巧读到了值，但真机就不行。

• 解决办法二选一：
  • 让App在初始化库的时候，传Activity的Context（别传ApplicationContext），因为Activity的Context绑定了当前App的自定义主题；
  • 要求App在AndroidManifest.xml的<application>标签里指定自定义主题，确保ApplicationContext的主题也包含这些属性：

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

3. 资源混淆搞事情，属性ID找不到 #

如果App开了资源混淆（比如用了AndResGuard），或者R类引用错了，真机上就会找不到属性对应的ID，自然读不到值。

• 解决步骤：
  1. 在App的混淆规则里，把库的自定义属性相关的R类成员保留下来：

     -keepclassmembers class **.R$styleable {
         public static <fields>;
     }
     -keep class **.R$attr { *; }
     

  2. 确保库中获取属性时，用的是库自己的R类，别不小心引用了App的R类（比如要写com.mylibrary.R.styleable，不是com.myapp.R.styleable）。

4. API21的兼容细节没注意 #

虽然你是支持API21+，但某些属性格式或者获取方式在老版本真机上可能有兼容问题。比如复杂类型的属性，或者没有设置默认值导致读取失败。

• 优化建议：
  • 尽量用API21完全支持的基础属性格式，比如string、boolean、integer，别用太复杂的；
  • 读取属性时一定要设置默认值，防止获取失败时直接拿不到值：

    val sharedKey = ta.getString(R.styleable.LibraryConfig_appSharedKey) ?: "DEFAULT_FALLBACK_KEY"
    val debugMode = ta.getBoolean(R.styleable.LibraryConfig_appDebugMode, false)
    

最后验证一下 #

你可以在库的初始化代码里加个Log，打印获取到的属性值，去真机的Logcat里看看，到底是没读到值，还是后续逻辑有问题：

Log.d("LibInit", "sharedKey: $sharedKey, debugMode: $debugMode")

也可以试试手动从主题解析属性，确认流程没问题：

val theme = context.theme
val attrs = intArrayOf(R.attr.appSharedKey, R.attr.appDebugMode)
val ta = theme.obtainStyledAttributes(attrs)
// 读取属性逻辑...
ta.recycle()

内容的提问来源于stack exchange，提问作者Pepa Novotný