使用此內容來排除執行時間資源覆蓋 (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 狀態:
指標 遠端遙控狀態 [ ]
已安裝並準備啟動。 [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 和 5STATE_UNKNOWN
。OverlayManagerService
有問題。
步驟4:檢查AndroidManifest.xml
驗證AndroidManifest.xml
:
檢查
targetName
和targetPackage
。android:targetName
應與目標應用程式中定義的可覆寫群組具有相同的值。僅當定位覆蓋層時才需要此操作。android:targetPackage
始終是必需的,並且應包含目標應用程式的套件名稱。檢查您的 RRO 是否靜態。靜態 RRO 在啟動時預設為啟用。預設情況下,啟動時不啟用動態 RRO。在運行時更改應用程式資源的值中提供了啟用動態 RRO 的其他方法。
檢查靜態 RRO 的優先權(動態 RRO 優先權始終設定為
Integer.MAX_VALUE
,並且它們的應用順序取決於它們的啟用時間)。多個 RRO 可能適用於相同目標。優先順序較高的 RRO 最後應用。在 0 到 10 的範圍內,10 最高,0 最低。
步驟5:檢查overlays.xml
此檢查僅適用於 Android 11(及更高版本)。
檢查
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
檔案中使用正確的targetName
(步驟 4)。例如:
<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
若要轉儲該文件的內容:
idmap2 dump --idmap-path [path to your RRO idmap file]
輸出類似以下內容。輸出顯示 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!!")