عیب یابی همپوشانی منابع زمان اجرا

از این محتوا برای عیب یابی اینکه چرا همپوشانی منابع زمان اجرا (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]
   

   توجه: می توانید current با کاربر خود جایگزین کنید. به عنوان مثال، 0 یا 10 یا مقدار را بدون تغییر بگذارید.
   توجه: RRO های ثابت به طور پیش فرض در زمان بوت فعال هستند. RROهای پویا به طور پیش فرض در هنگام بوت فعال نمی شوند. برخی استثناها برای این رفتارهای پیش فرض وجود دارد. برای جزئیات، به تغییر مقدار منابع برنامه در زمان اجرا مراجعه کنید. .

مرحله 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 با اولویت بالاتر در آخر اعمال می شود. در مقیاس 0 تا 10، 10 بالاترین و 0 کمترین است.

مرحله 5: overlays.xml را بررسی کنید

این بررسی فقط برای اندروید 11 (و بالاتر) اعمال می شود.

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).

   توجه: اگر یک فایل طرح‌بندی را هم‌پوشانی می‌کنید، مطمئن شوید که همه شناسه‌ها و ویژگی‌های فضای نام برنامه در هر دو overlays.xml و overlayable.xml گنجانده شده‌اند.

   به عنوان مثال:

   <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]
   

   مثال: posix-terminal adb shell idmap2 dump --idmap-path data/resource-cache/system@app@[e-mail]@idmap

   خروجی مشابه شکل زیر به نظر می رسد. خروجی نشان می دهد که کدام شناسه از RRO شما به کدام 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‌های خود حذف کنید تا شناسه‌های حل‌شده را برای مطابقت با خروجی بالا مشاهده کنید:

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