android.media.tv.tuner包缺失及自定义构建失败问题咨询

1. 为什么android.media.tv.tuner包默认不被构建进android.jar？ #

这个包属于系统受限API，仅面向硬件厂商的系统应用或定制ROM开发，而非普通第三方应用：

• 它依赖Android TV设备的硬件调谐器驱动支持，多数普通Android设备不具备该硬件；
• 相关API调用需要系统级权限，普通第三方应用无法获取；
• 官方SDK提供的android.jar仅包含面向第三方开发者的公开API，这类系统级API仅在源码中提供参考，不纳入默认编译依赖。

2. 如何创建/配置包含调谐器模块的Android TV项目？ #

注意：仅在带硬件调谐器的定制Android TV设备或系统应用场景下可用，普通第三方应用无法直接调用：

• 项目基础配置：确保build.gradle中compileSdkVersion和targetSdkVersion不低于30（对应源码中该包的最低版本），并指定Android TV作为目标平台（新建项目时选择Android TV模板，或手动设置android:required="true"针对com.android.tv功能）；
• 权限配置：在AndroidManifest.xml中添加系统权限：<uses-permission android:name="android.permission.ACCESS_TV_TUNER" />，该权限需系统签名或定制ROM中放开权限限制；
• 代码兼容：使用@TargetApi(30)注解标记相关代码，添加硬件存在性判断（通过PackageManager.hasSystemFeature(PackageManager.FEATURE_TV_TUNER)），避免在无调谐器的设备上崩溃；
• 部署要求：需将应用以系统签名编译，部署到带硬件调谐器的Android TV设备，普通模拟器无法测试该功能。

3. soong_build构建报错解决办法 #

报错panic: Found two Blueprint files in directory . : Copyright (C) 2016 The Android Open Source Project and .是因为当前目录存在冲突的Blueprint配置文件：

• 检查执行命令的目录：必须在Android源码根目录，且根目录下仅保留官方原生的Android.bp文件，删除手动创建或复制的额外Android.bp或类似命名的配置文件；
• 清理构建缓存：删除out/soong目录，避免旧缓存干扰；
• 使用官方构建命令：不要手动执行soong_build，建议使用Android源码官方构建命令make android-sdk来生成包含系统API的SDK包，该命令会自动处理Soong配置。

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