覆盖car_ux_restrictions_map.xml修改Android车机UX限制遇阻求助

问题根源分析 #

你遇到的核心问题是CarUxRestrictionsConfigurationXmlParser无法解析R.styleable.UxRestrictions_Restrictions_uxr，最终触发系统 fallback 逻辑（完全限制UI），原因主要有三点：

1. 资源命名空间不匹配
   原uxr属性属于com.android.car.service模块的自定义资源，你直接复制attrs.xml到overlay目录后，系统会将其视为当前overlay包的属性，而非原服务的属性。解析器找不到对应styleable定义，就会判定配置无效。

2. 缺少Overlay的Manifest声明
   系统overlay必须通过AndroidManifest.xml指定目标覆盖的服务包名，否则你的overlay资源根本不会被系统加载，原默认配置依然生效。

3. Overlay部署方式错误
   系统服务的overlay不能仅靠复制文件到vendor路径生效，需要正确编译为系统overlay模块或通过签名安装，否则系统不会识别并应用你的配置。

解决方案 #

1. 补充Overlay的AndroidManifest.xml #

在你的overlay目录<vendor-path>/overlay/packages/services/Car/service/下创建AndroidManifest.xml，内容如下：

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    package="com.android.car.service.uxrestrictions.overlay">

    <application android:hasCode="false">
        <overlay
            android:targetPackage="com.android.car.service"
            android:category="android.car.overlay"
            android:priority="10" />
    </application>
</manifest>

• targetPackage必须严格对应原服务包名com.android.car.service
• priority设为较高值（比如10），确保你的overlay优先级高于默认配置
• android:hasCode="false"标记这是纯资源overlay，无需代码逻辑

2. 修正XML中的属性命名空间 #

修改你的car_ux_restrictions_map.xml，添加原服务的资源命名空间，并指定uxr属性的归属：

<?xml version="1.0" encoding="utf-8"?>
<UxRestrictions xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:car="http://schemas.android.com/apk/res/com.android.car.service">

    <!-- 示例：禁用所有限制的基准配置 -->
    <Restrictions
        android:name="base"
        car:uxr="none" />

    <!-- 其他驾驶模式配置 -->
    <Restrictions
        android:name="driving"
        car:uxr="none" />
</UxRestrictions>

这样解析器就能正确识别uxr属性对应的原服务styleable定义，避免解析失败。

3. 正确编译与部署Overlay #

方式一：AOSP编译环境集成

在overlay目录下创建Android.bp文件：

android_overlay {
    name: "com.android.car.service.uxrestrictions.overlay",
    resource_dirs: ["res"],
    manifest: "AndroidManifest.xml",
    certificate: "platform",
}

将该模块添加到你的设备配置makefile中（比如device/<vendor>/<device>/device.mk），添加：

PRODUCT_PACKAGES += com.android.car.service.uxrestrictions.overlay

重新编译系统镜像并刷入模拟器。

方式二：手动编译测试

使用Android Studio或aapt工具将overlay打包为APK，注意必须使用platform签名（与系统签名一致）。然后通过命令安装：

adb install -r com.android.car.service.uxrestrictions.overlay.apk

安装后重启模拟器，通过以下命令验证overlay状态：

adb shell dumpsys overlay | grep com.android.car.service.uxrestrictions.overlay

如果输出中包含ENABLED，说明overlay已生效。

关键注意点 #

• 不要复制完整的原attrs.xml到overlay，仅需在XML中指定正确的命名空间即可，避免资源冲突。
• 系统在解析配置失败时会触发完全限制的 fallback 逻辑，这是车机系统的安全设计，所以确保配置文件语法和属性引用完全正确。

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