AOSP资源overlay修改Launcher3默认应用不生效排查方案

核心排查方向 #

• 路径拼写错误：你当前存放Launcher3 overlay的路径写的是overaly，少了第二个字母l，正确目录名是overlay，和你framework层overlay的父目录名保持一致。编译系统扫描静态overlay时严格匹配路径，拼写错误会直接导致该目录下所有资源被忽略。
• 资源配置限定符不匹配
• 不是所有设备都会加载default_workspace_4x4.xml，Launcher3会根据屏幕尺寸、密度、横竖屏配置选择对应带资源限定符的布局文件，比如小屏设备可能加载default_workspace.xml，大屏设备可能加载default_workspace_5x6.xml，部分厂商定制版本还会加产品专属限定符。
• 你可以反编译构建产物中out/target/product/<product>/system/priv-app/Launcher3/Launcher3.apk，查看res/xml目录下实际存在的workspace配置文件名，确保你的overlay文件和目标加载的文件名、路径完全一致。
• Overlay优先级被覆盖
• AOSP编译系统中静态overlay的优先级规则是PRODUCT_PACKAGE_OVERLAYS > DEVICE_PACKAGE_OVERLAYS > 原生源码资源，你需要检查产品mk配置中有没有其他位置通过PRODUCT_PACKAGE_OVERLAYS引用了包含Launcher3配置的overlay目录，高优先级配置会覆盖你当前的device层配置。
• Android 10及以上版本还要检查有没有预装针对Launcher3的RRO（运行时资源覆盖）包，RRO优先级高于所有静态overlay，会直接覆盖资源值。
• Launcher3布局缓存干扰：Launcher3第一次启动完成后，会把解析到的桌面布局写入本地数据库，后续系统升级如果不清除应用数据，不会重新解析default_workspace系列xml文件，验证overlay效果必须执行adb shell pm clear com.android.launcher3或者恢复出厂设置清空缓存。
• XML语法与命名空间不匹配：你写的布局文件中命名空间为http://schemas.android.com/apk/res-auto/com.android.launcher3，不同Android版本的Launcher3命名空间存在差异，部分版本直接使用http://schemas.android.com/apk/res-auto作为命名空间，命名空间不匹配会导致Launcher3解析xml时直接跳过所有favorite节点。你需要对照原生Launcher3源码中对应workspace xml的头部命名空间，完全保持一致。

修正验证步骤 #

• 第一步：修正路径拼写错误，将overaly目录重命名为overlay，确保文件路径为<aosp_root>/device/<company>/<product>/overlay/packages/apps/Launcher3/res/xml/default_workspace_4x4.xml，和framework层overlay的目录层级完全对齐。
• 第二步：全编系统后，检查Launcher3的编译中间产物out/target/product/<product>/obj/APPS/Launcher3_intermediates/package-export.apk，反编译后确认对应xml文件内容是否为你自定义的配置，如果是则说明静态overlay已经正确打包。
• 第三步：烧录镜像后清空Launcher3数据或者恢复出厂设置，验证布局是否生效。
• 补充：针对多硬件差异化展示应用的需求，除了静态overlay方案，更稳定的实现方式是修改Launcher3的布局加载逻辑，在解析workspace配置时读取设备硬件属性（如ro.hardware、自定义系统属性），过滤掉当前硬件不适配的应用项，避免资源匹配错误导致的布局异常。

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