Устранение неполадок с наложением ресурсов среды выполнения

Используйте этот контент, чтобы устранить неполадки, почему наложение ресурсов времени выполнения (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:

    Индикатор Статус РРО
    [ ] Установлено и готово к активации.
    [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 с более высоким приоритетом применяются последними. По шкале от 0 до 10: 10 — самый высокий показатель, а 0 — самый низкий.

Шаг 5. Проверьте файл overlays.xml.

Эта проверка применима только к Android 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).

    Например:

    <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. Чтобы сбросить содержимое этого файла:

    idmap2 dump --idmap-path [path to your RRO idmap file]

    Вывод выглядит следующим образом. В выходных данных отображается, какой идентификатор из вашего 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

Вы также можете сбросить файлы макета из своих приложений, чтобы просмотреть разрешенные идентификаторы, соответствующие приведенному выше выводу:

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