Android Studio多模块项目Fragment布局预览无法识别Leanback主题

问题场景 #

你碰到的是Android多模块项目里，Library模块的Fragment布局预览无法识别Leanback自定义主题的典型问题，具体细节如下：

• 项目包含app（应用模块，负责Activity与导航逻辑）、common（Library模块，存放字符串和样式资源）、home/details（Library模块，包含测试Fragment）
• 所有Fragment模块均依赖common模块，依赖配置如下：

  // Modules
  implementation project(path: ':navigation')
  implementation project(path: ':common')
  

• common模块中定义了基于Theme.Leanback.Browse的自定义主题AppTheme，代码如下：

  <?xml version="1.0" encoding="utf-8"?>
  <resources>
  <style name="AppTheme" parent="Theme.Leanback.Browse">
  <!-- Theme.AppCompat compatibility: -->
  <item name="windowActionBar">false</item>
  <item name="windowNoTitle">true</item>
  <!-- Theme.MaterialComponents compatibility: -->
  <item name="colorPrimary">#171717</item>
  <item name="colorPrimaryVariant">#212121</item>
  <item name="colorAccent">#DD1C1A</item>
  <item name="colorOnPrimary">#eeeeee</item>
  <item name="colorSecondary">#FFEB3B</item>
  <item name="colorSecondaryVariant">#FFC107</item>
  <item name="colorOnSecondary">#eeeeee</item>
  <item name="colorSurface">#2196F3</item>
  <item name="colorOnSurface">#eeeeee</item>
  </style>
  </resources>
  

• 异常现象：app模块的Activity布局预览能正常选择并显示自定义主题，但HomeFragment等Library模块的布局预览里找不到该主题选项；实际运行时样式完全正常，仅布局预览功能异常；将主题父类改为Theme.AppCompat时预览恢复正常，但业务需求必须使用Leanback主题。
• 测试环境：Windows 10、Android Studio 4 Canary 8（Android Studio 4 Canary 2也存在相同问题）

解决方案 #

感谢@Martin Zeitler提供的思路，核心是给每个Library模块的AndroidManifest.xml明确指定默认应用主题，让布局编辑器能识别Leanback主题的上下文：

在home、details这类Library模块的Manifest文件中添加默认主题配置：

<manifest xmlns:android="http://schemas.android.com/apk/res/android" package="com.example.home">
    <application android:theme="@style/AppTheme" />
</manifest>

补充说明 #

Library模块不像App模块会默认带有application节点的主题配置，布局编辑器在渲染Library模块的布局时，缺少明确的主题上下文。对于Leanback这类特殊主题，编辑器无法自动关联识别；而AppCompat主题因为Android Studio编辑器的默认兼容逻辑，能被自动识别，所以会出现切换父类后预览正常的情况。给Library模块Manifest添加主题配置后，编辑器就能正确加载Leanback主题进行预览了。

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