使用此内容来排查运行时资源叠加 (RRO) 可能无法在 Android Automotive 实现中按预期运行的原因。
相关文档
要了解有关 Android 中 RRO 的更多信息，请参阅在运行时更改应用资源的价值。请务必持续关注 logcat 输出，它可以提供有关整个过程发生情况的良好信息。
步骤 1：列出 RRO
要列出 RRO，请执行以下操作
运行以下命令
adb shell cmd overlay list --user current将显示如下所示的输出
com.android.systemui [ ] com.android.theme.icon_pack.rounded.systemui [ ] com.android.theme.icon_pack.filled.systemui [ ] com.android.theme.icon_pack.circular.systemui com.android.permissioncontroller --- com.android.permissioncontroller.googlecarui.rro验证您的 RRO 是否出现在列表中。以下指示符表示 RRO 状态
指示符 RRO 状态 [ ]已安装并准备好激活。 [X]已安装并已激活。 ---已安装但包含错误。 如果您的 RRO 未在您要叠加的目标软件包名称下列出，则说明您的 RRO 未安装。
步骤 2：启用和停用 RRO
如果已安装 RRO
使用以下命令启用（或停用）RRO
adb shell cmd overlay [enable/disable] --user current [your RRO package name]
步骤 3：确认 RRO 已安装
要确认 RRO 是否安装在设备上，或排查 RRO 未启用的原因
运行以下命令
adb shell cmd overlay dump [your RRO package name]将显示如下所示的输出
com.android.car.rotaryplayground.googlecarui.rro:0 { mPackageName...........: com.android.car.rotaryplayground.googlecarui.rro mUserId................: 0 mTargetPackageName.....: com.android.car.rotaryplayground mTargetOverlayableName.: car-ui-lib mBaseCodePath..........: /product/overlay/googlecarui-com-android-car-rotaryplayground/googlecarui-com-android-car-rotaryplayground.apk mState.................: STATE_MISSING_TARGET mIsEnabled.............: true mIsMutable.............: true mPriority..............: 10 mCategory..............: BypassIdMapV1 } com.android.car.rotaryplayground.googlecarui.rro:10 { mPackageName...........: com.android.car.rotaryplayground.googlecarui.rro mUserId................: 10 mTargetPackageName.....: com.android.car.rotaryplayground mTargetOverlayableName.: car-ui-lib mBaseCodePath..........: /product/overlay/googlecarui-com-android-car-rotaryplayground/googlecarui-com-android-car-rotaryplayground.apk mState.................: STATE_MISSING_TARGET mIsEnabled.............: true mIsMutable.............: true mPriority..............: 10 mCategory..............: BypassIdMapV1 }确定安装 RRO 的用户。（或多个用户）。在前面的示例中，RRO 适用于用户
0和用户10（请参阅顶部代码块中mUserId的值）。要为用户启用（或停用）RRO，请转到步骤 2。
要检查
mState的值STATE_ENABLED和STATE_ENABLED_IMMUTABLE。RRO 已启用并应用于您的目标。STATE_MISSING_TARGET。您的目标未安装。STATE_NO_IDMAP。AndroidManifest.xml、overlays.xml或overlayable.xml文件的设置方式存在问题。使用adb logcat运行日志并搜索关键字idmap以确定错误。请参阅步骤 4 和 5。STATE_UNKNOWN。OverlayManagerService存在问题。
步骤 4：检查 AndroidManifest.xml
要验证 AndroidManifest.xml
检查
targetName和targetPackage。android:targetName应具有目标应用中定义的 overlayable 组的相同值。仅当以叠加层为目标时，才需要这样做。android:targetPackage始终是必需的，并且应包含目标应用的软件包名称。检查您的 RRO 是静态的（还是动态的）。静态 RRO 在启动时默认启用。动态 RRO 在启动时默认不启用。有关启用动态 RRO 的其他方法，请参阅在运行时更改应用资源的价值。
检查静态 RRO 的优先级（动态 RRO 优先级始终设置为
Integer.MAX_VALUE，并且应用它们的顺序取决于启用它们的时间）。多个 RRO 可以应用于同一目标。优先级较高的 RRO 最后应用。在 0 到 10 的范围内，10 最高，0 最低。
步骤 5：检查 overlays.xml
检查
overlays.xml以确认您打算叠加的所有资源都在此文件中定义。例如，考虑以下overlays.xml<overlay> <item target="string/app_name" value="@string/overlaid_app_name" /> </overlay>您必须确保
- 目标应用中存在名为
app_name的string资源。 - 您的 RRO 中存在名为
overlaid_app_name的string资源。
- 目标应用中存在名为
如果您的目标具有
overlayable.xml文件，请确保app_name包含在该文件中。确保在AndroidManifest.xml文件（步骤 4）中使用正确的targetName。例如
<overlay> <item target="layout/car_ui_base_layout_toolbar" value="@layout/car_ui_base_layout_toolbar" /> <item target="id/car_ui_toolbar_background" value="@id/car_ui_toolbar_background" /> <item target="attr/layout_constraintTop_toBottomOf" value="@attr/layout_constraintTop_toBottomOf" /> </overlay>
步骤 6：转储 idmap
在此阶段，您 RRO 的所有问题都应已解决。接下来，转储 RRO 的 idmap，以了解资源的解析方式以及为何解析为与您预期不同的值。
要在您的设备上查找
idmap的路径adb shell su ls data/resource-cache要转储该文件的内容
adb root adb shell idmap2 dump --idmap-path [path to your RRO idmap file]示例
adb shell idmap2 dump --idmap-path data/resource-cache/system@app@CarUiPortraitLauncherReferenceRRO@CarUiPortraitLauncherReferenceRRO.apk@idmap输出结果类似于以下内容。输出显示了 RRO 中的哪个 ID 映射到目标中的哪个 ID，以及叠加资源的名称。
target apk path : /system/priv-app/CarMediaApp/CarMediaApp.apk overlay apk path : /product/overlay/googlecarui-com-android-car-media/googlecarui-com-android-car-media.apk 0x7f040008 -> 0x7f010000 bool/car_ui_toolbar_logo_fills_nav_icon_space 0x7f040009 -> 0x7f010001 bool/car_ui_toolbar_nav_icon_reserve_space 0x7f04000b -> 0x7f010002 bool/car_ui_toolbar_tab_flexible_layout 0x7f04000c -> 0x7f010003 bool/car_ui_toolbar_tabs_on_second_row 0x7f09006c -> 0x7f020000 id/car_ui_base_layout_content_container 0x7f090073 -> 0x7f020001 id/car_ui_recycler_view 0x7f090074 -> 0x7f020002 id/car_ui_scroll_bar 0x7f090075 -> 0x7f020003 id/car_ui_scrollbar_page_down 0x7f090076 -> 0x7f020004 id/car_ui_scrollbar_page_up 0x7f090077 -> 0x7f020005 id/car_ui_scrollbar_thumb 0x7f090078 -> 0x7f020006 id/car_ui_scrollbar_track 0x7f09007a -> 0x7f020007 id/car_ui_toolbar_background 0x7f09007e -> 0x7f020008 id/car_ui_toolbar_logo 0x7f090084 -> 0x7f020009 id/car_ui_toolbar_menu_items_container 0x7f090085 -> 0x7f02000a id/car_ui_toolbar_nav_icon 0x7f090086 -> 0x7f02000b id/car_ui_toolbar_nav_icon_container 0x7f090087 -> 0x7f02000c id/car_ui_toolbar_progress_bar 0x7f090089 -> 0x7f02000d id/car_ui_toolbar_row_separator_guideline 0x7f09008d -> 0x7f02000e id/car_ui_toolbar_search_view_container 0x7f09008f -> 0x7f02000f id/car_ui_toolbar_subtitle 0x7f090092 -> 0x7f020010 id/car_ui_toolbar_tabs 0x7f090093 -> 0x7f020011 id/car_ui_toolbar_title 0x7f090094 -> 0x7f020012 id/car_ui_toolbar_title_container 0x7f090095 -> 0x7f020013 id/car_ui_toolbar_title_logo 0x7f090096 -> 0x7f020014 id/car_ui_toolbar_title_logo_container 0x7f0c0024 -> 0x7f030000 layout/car_ui_base_layout_toolbar 0x7f0c0035 -> 0x7f030001 layout/car_ui_recycler_view 0x7f0c0038 -> 0x7f030002 layout/car_ui_toolbar 0x7f0c003f -> 0x7f030003 layout/car_ui_toolbar_two_row
使用以下命令查找特定资源，以查看它们的映射方式
adb shell cmd overlay lookup --verbose --user 10 com.android.car.ui.paintbooth com.android.car.ui.paintbooth:color/widget_background输出是资源的最终值
#ff7986cb
您还可以从您的 apk 转储您的布局文件，以查看已解析的 ID 以匹配上述输出
aapt2 dump xmltree $OUT/system/priv-app/sharedlibraryclient/sharedlibraryclient.apk --file res/layout/activity_main.xml将返回如下所示的输出
N: android=http://schemas.android.com/apk/res/android (line=2)
N: app=http://schemas.android.com/apk/res-auto (line=2)
N: lib=http://schemas.android.com/apk/com.android.car.ui.sharedlibrary.test (line=2)
E: androidx.constraintlayout.widget.ConstraintLayout (line=2)
A: http://schemas.android.com/apk/res/android:layout_width(0x010100f4)=-1
A: http://schemas.android.com/apk/res/android:layout_height(0x010100f5)=-1
E: TextView (line=19)
A: http://schemas.android.com/apk/res/android:layout_width(0x010100f4)=-2
A: http://schemas.android.com/apk/res/android:layout_height(0x010100f5)=-2
A: http://schemas.android.com/apk/res/android:text(0x0101014f)=@0x020f0000
A: http://schemas.android.com/apk/res-auto:layout_constraintBottom_toBottomOf(0x7f0200fb)=0
A: http://schemas.android.com/apk/res-auto:layout_constraintLeft_toLeftOf(0x7f02010e)=0
A: http://schemas.android.com/apk/res-auto:layout_constraintRight_toRightOf(0x7f020112)=0
A: http://schemas.android.com/apk/res-auto:layout_constraintTop_toTopOf(0x7f020118)=0
E: com.android.car.ui.sharedlibrary.test.MyRecyclerView (line=28)
A: http://schemas.android.com/apk/res/android:layout_width(0x010100f4)=-2
A: http://schemas.android.com/apk/res/android:layout_height(0x010100f5)=-2
A: http://schemas.android.com/apk/com.android.car.ui.sharedlibrary.test:implClass="HelloWorld!" (Raw: "HelloWorld!")
E: com.android.car.ui.sharedlibraryclient.CustomView (line=34)
A: http://schemas.android.com/apk/res/android:layout_width(0x010100f4)=-2
A: http://schemas.android.com/apk/res/android:layout_height(0x010100f5)=-2
A: http://schemas.android.com/apk/res-auto:implClass2(0x7f0200e8)="HelloWorld!!" (Raw: "HelloWorld!!")
无法解析映射通过三个问号 (???) 由 idmap2 指示。
在此示例中，RRO 在公共资源之上叠加了一个硬编码的颜色值
$ idmap2 dump --idmap-path [file]
0x00010402 -> color 0xff00ff00 (???)在此示例中，RRO 通过将公共资源指向同一共享库中的内部（私有）颜色资源来叠加该资源
$ idmap2 dump --idmap-path [file]
0x00010402 -> 0x7f010000 (??? -> color/item_background_new)