Эта страница переведена с помощью Cloud Translation API.

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

Используйте это содержимое для устранения неполадок, почему наложение ресурсов времени выполнения (RRO) может не работать должным образом в реализации Android Automotive.

Связанная документация

Дополнительные сведения о RRO в 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]
```
Примечание. Вы можете заменить current своим пользователем. Например, 0 или 10 или оставить значение без изменений.

Шаг 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 должно иметь то же значение, что и накладываемая группа, определенная в целевом приложении. Это требуется только при нацеливании на оверлей.
android:targetPackage требуется всегда и должен содержать имя пакета целевого приложения.
Убедитесь, что ваш RRO является статическим (или нет). Статические RRO включены по умолчанию во время загрузки. Динамические RRO не включены по умолчанию при загрузке. Дополнительные способы включения динамических RRO представлены в наложениях ресурсов времени выполнения (RRO) .
Проверьте приоритет вашего статического RRO (вы не можете проверить приоритет динамического RRO).
Несколько RRO могут применяться к одной и той же цели. RRO с более высоким приоритетом применяются последними. По шкале от 0 до 10, 0 — самый высокий показатель, а 10 — самый низкий.

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

Эта проверка применима только к Android 11 (и выше).

Проверьте файл overlays.xml , чтобы убедиться, что все ресурсы, которые вы собираетесь накладывать, определены в этом файле. Например, рассмотрим следующий overlays.xml :
```
<overlay>
    <item target="string/app_name" value="@string/overlaid_app_name" />
</overlay>
```
Вы должны убедиться, что:
- string ресурс с именем app_name существует в целевом приложении.
- string ресурс с именем overlaid_app_name существует в вашем RRO.
Если у вашей цели есть файл 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

На этом этапе все вопросы с вашим РРО должны быть решены. Затем сделайте дамп idmap вашего RRO, чтобы узнать, как ресурс разрешается и почему он разрешается в другое значение, чем вы ожидаете.

Чтобы найти путь к idmap на вашем устройстве:
```
adb shell
su
ls data/resource-cache
```

Чтобы сбросить содержимое этого файла:

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

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

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