Flutter Android TV应用Play Console不识别uses-feature非必填设置致不兼容

问题核心 #

你用Flutter开发的Android TV应用，上传App Bundle到Google Play封闭测试轨道后，Android 9 TV设备显示不兼容。手动在AndroidManifest.xml中将不必要的<uses-feature>设为android:required="false"，但Play Console仍显示这些特性为必填；注释掉所有这类声明后，Play Console仅显示3项必填特性，兼容问题缓解。

可能原因 #

• Flutter框架自动注入特性声明：Flutter针对TV应用的默认配置或相关库，会自动添加部分硬件特性要求，这些自动生成的声明优先级高于你手动设置的required="false"，导致Play Console识别为必填项。
• Manifest合并冲突：Android构建过程会合并主Manifest、Flutter库Manifest、第三方依赖Manifest。如果第三方插件或库声明的<uses-feature>未设required="false"，合并后会覆盖你手动设置的属性，最终Manifest里这些特性仍为必填。
• required="false"的解析问题：部分情况下，手动添加的<uses-feature android:required="false"可能因构建工具的合并逻辑，未被正确识别为非必填，反而被Play Console判定为应用依赖该特性。

解决步骤 #

1. 查看合并后的Manifest
   在Android Studio中打开AndroidManifest.xml，切换到「Merged Manifest」标签，查看最终生成的所有<uses-feature>条目，确认哪些是被标记为required="true"的，定位来源（比如来自哪个依赖库）。

2. 移除不必要的特性声明
   如果发现某个依赖自动添加了不需要的硬件特性，不要手动设置required="false"，而是用tools:node="remove"彻底移除该声明：

   <uses-feature
       android:name="android.hardware.xxx"
       tools:node="remove" />
   

   注意：需在Manifest根标签中添加xmlns:tools="http://schemas.android.com/tools"命名空间。

3. 检查第三方依赖
   运行以下命令查看所有依赖，排查是否有插件强制添加了硬件特性要求：

   ./gradlew app:dependencies
   

   若发现可疑依赖，考虑替换或联系开发者调整其Manifest配置。

4. 确认TV应用核心配置
   确保Manifest中保留TV应用必须的特性声明，避免误移除：

   <uses-feature
       android:name="android.software.leanback"
       android:required="true" />
   <application
       android:banner="@drawable/tv_banner"
       ...>
       <!-- TV相关组件配置 -->
   </application>
   

总结 #

Play Console显示的是最终构建后App Bundle中的合并Manifest内容，而非你手动编写的原文件。你的问题本质是手动添加的required="false"声明未被正确处理，或与Flutter自动注入的内容冲突。注释掉这些声明后，合并后的Manifest仅保留必要特性，因此设备兼容问题得到解决。

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