แก้ปัญหาการวางซ้อนทรัพยากรรันไทม์

ใช้เนื้อหานี้เพื่อแก้ปัญหาที่อาจทำให้การวางซ้อนทรัพยากรรันไทม์ (RRO) ไม่ทำงานตามที่ตั้งใจไว้ในการใช้งาน Android Automotive

ดูข้อมูลเพิ่มเติมเกี่ยวกับ RRO ใน Android ได้ที่หัวข้อเปลี่ยนค่าของทรัพยากรของแอปขณะรันไทม์ โปรดตรวจสอบเอาต์พุต logcat อย่างต่อเนื่อง ซึ่งจะให้ข้อมูลที่ดีเกี่ยวกับสิ่งที่เกิดขึ้นตลอดกระบวนการ

ขั้นตอนที่ 1: แสดงรายการ RRO

วิธีแสดงรายการ RRO

  1. เรียกใช้คำสั่งต่อไปนี้

    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

  2. ตรวจสอบว่า RRO ปรากฏในรายการ ตัวบ่งชี้ต่อไปนี้แสดงสถานะ RRO

    สัญลักษณ์บอกสถานะ สถานะ RRO
    [ ] ติดตั้งแล้วและพร้อมเปิดใช้งาน
    [X] ติดตั้งและเปิดใช้งานแล้ว
    --- ติดตั้งแล้ว แต่มีข้อผิดพลาด

    หาก RRO ไม่แสดงอยู่ในชื่อแพ็กเกจของเป้าหมายที่คุณต้องการวางซ้อน แสดงว่ายังไม่ได้ติดตั้ง RRO

ขั้นตอนที่ 2: เปิดและปิดใช้ RRO

หากติดตั้ง RRO แล้ว ให้ทำดังนี้

  1. ใช้คำสั่งต่อไปนี้เพื่อเปิดใช้ (หรือปิดใช้) RRO

    adb shell cmd overlay [enable/disable] --user current [your RRO package name]

ขั้นตอนที่ 3: ยืนยันว่าได้ติดตั้ง RRO แล้ว

วิธียืนยันว่ามีการติดตั้ง RRO ในอุปกรณ์หรือแก้ปัญหาสาเหตุที่ RRO ไม่เปิดใช้

  1. เรียกใช้คำสั่งต่อไปนี้

    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
}

  2. ระบุผู้ใช้ (หรือผู้ใช้) ที่ติดตั้ง RRO ในตัวอย่างก่อนหน้านี้ RRO พร้อมใช้งานสําหรับผู้ใช้ 0 และผู้ใช้ 10 (ดูค่าของ mUserId ในบล็อกโค้ดด้านบน)

  3. หากต้องการเปิดใช้ (หรือปิดใช้) RRO สำหรับผู้ใช้ ให้ไปที่ขั้นตอนที่ 2

  4. วิธีตรวจสอบค่าของ 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

  1. โปรดอ่านtargetNameและtargetPackage

    android:targetName ควรมีค่าเดียวกับกลุ่มที่วางซ้อนกันได้ซึ่งกำหนดไว้ในแอปเป้าหมาย โดยจะต้องระบุค่านี้เฉพาะเมื่อกำหนดเป้าหมายเป็นการวางซ้อน

    android:targetPackage ต้องระบุเสมอและควรมีชื่อแพ็กเกจของแอปเป้าหมาย

  2. ตรวจสอบว่า RRO เป็นแบบคงที่ (หรือไม่) ระบบจะเปิดใช้ RRO แบบคงที่โดยค่าเริ่มต้นขณะบูต ระบบจะไม่เปิดใช้ RRO แบบไดนามิกโดยค่าเริ่มต้นเมื่อบูต ดูวิธีอื่นๆ ในการเปิดใช้ RRO แบบไดนามิกได้ที่เปลี่ยนค่าของทรัพยากรของแอปขณะรันไทม์

  3. ตรวจสอบลําดับความสําคัญของ RRO แบบคงที่ (ระบบจะตั้งค่าลําดับความสําคัญของ RRO แบบไดนามิกเป็น Integer.MAX_VALUE เสมอ และลําดับที่ RRO มีผลขึ้นอยู่กับเวลาที่เปิดใช้)

    คุณใช้ RRO หลายรายการกับเป้าหมายเดียวกันได้ ระบบจะใช้ RRO ที่มีลําดับความสําคัญสูงกว่าเป็นลําดับสุดท้าย ในระดับ 0 ถึง 10 ค่า 10 คือสูงสุดและ 0 คือต่ำสุด

ขั้นตอนที่ 5: ตรวจสอบ overlays.xml

  1. เลือก overlays.xml เพื่อยืนยันว่าทรัพยากรทั้งหมดที่คุณต้องการวางซ้อนถูกกำหนดในไฟล์นี้ ตัวอย่างเช่นoverlays.xml

    <overlay>
    <item target="string/app_name" value="@string/overlaid_app_name" />
</overlay>

  2. คุณต้องตรวจสอบว่า

    • มีทรัพยากร string ที่ใช้ชื่อ app_name ในแอปเป้าหมายแล้ว
    • มีทรัพยากร string ชื่อ overlaid_app_name ใน RRO ของคุณ

  3. หากเป้าหมายมีไฟล์ overlayable.xml ให้ตรวจสอบว่า app_name อยู่ในไฟล์นั้น ตรวจสอบว่าคุณใช้ targetName ที่ถูกต้องในไฟล์ AndroidManifest.xml (ขั้นตอนที่ 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 ควรได้รับการแก้ไขแล้ว ถัดไป ให้วางไฟล์ idmap ของ RRO เพื่อดูวิธีแก้ไขทรัพยากรและสาเหตุที่แก้ไขเป็นค่าอื่นนอกเหนือจากที่คุณคาดไว้

  1. วิธีค้นหาเส้นทางไปยัง idmap ในอุปกรณ์

    adb shell
su
ls data/resource-cache

  2. วิธีดัมพ์เนื้อหาของไฟล์นั้น

    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 ที่เชื่อมโยงกับรหัสในเป้าหมาย รวมถึงชื่อของทรัพยากรที่วางซ้อน

    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 เพื่อดูรหัสที่แก้ไขแล้วให้ตรงกับเอาต์พุตด้านบนได้ด้วย โดยทำดังนี้

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!!")