Solución de problemas de superposiciones de recursos en tiempo de ejecución

Utilice este contenido para solucionar el problema de por qué una superposición de recursos de tiempo de ejecución (RRO) puede no funcionar según lo previsto en una implementación de Android Automotive.

Para obtener más información sobre las RRO en Android, consulte Superposiciones de recursos en tiempo de ejecución (RRO) . Asegúrese de mantener una vigilancia constante sobre la salida de logcat , que puede proporcionar buena información sobre lo que sucede durante todo el proceso.

Paso 1: Enumere las RRO

Para enumerar las RRO:

  1. Ejecute el siguiente comando:

    adb shell cmd overlay list --user current

    Aparece una salida como esta:

    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. Verifique que su RRO aparezca en la lista. Los siguientes indicadores indican el estado de RRO:

    Indicador estado de RRO
    [ ] Instalado y listo para ser activado.
    [X] Instalado y activado.
    --- Instalado pero contiene errores.

    Si su RRO no aparece bajo el nombre del paquete del destino que desea superponer, su RRO no está instalado.

Paso 2: habilitar y deshabilitar una RRO

Si hay una RRO instalada:

  1. Use el siguiente comando para habilitar (o deshabilitar) el RRO:

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

Paso 3: Confirme que RRO está instalado

Para confirmar que se instaló una RRO en un dispositivo o solucionar el motivo por el cual la RRO no estaba habilitada:

  1. Ejecute el siguiente comando:

    adb shell cmd overlay dump [your RRO package name]

    Aparece una salida como la siguiente:

    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. Identifique al usuario (o usuarios) que han instalado el RRO. En el ejemplo anterior, el RRO está disponible para el usuario 0 y el usuario 10 (consulte los valores de mUserId en el bloque de código superior.

  3. Para habilitar (o deshabilitar) el RRO para el usuario deseado, vaya al Paso 2.

  4. Para comprobar el valor de mState :

    • STATE_ENABLED y STATE_ENABLED_IMMUTABLE . El RRO está habilitado y aplicado a su objetivo.

    • STATE_MISSING_TARGET . Su destino no está instalado.

    • STATE_NO_IDMAP . Hay algún problema con la configuración de los archivos AndroidManifest.xml , overlays.xml o overlayable.xml . Use adb logcat para ejecutar los registros y busque la palabra clave idmap para identificar el error. Ver pasos 4 y 5

    • STATE_UNKNOWN . Algo está mal con OverlayManagerService .

Paso 4: Comprobar AndroidManifest.xml

Para verificar AndroidManifest.xml :

  1. Compruebe targetName y targetPackage .

    android:targetName debe tener el mismo valor del grupo superponible definido en la aplicación de destino. Esto es necesario solo cuando se orienta a una superposición.

    android:targetPackage siempre es obligatorio y debe contener el nombre del paquete de la aplicación de destino.

  2. Comprueba que tu RRO sea estático (o no). Las RRO estáticas están habilitadas de forma predeterminada en el momento del arranque. Las RRO dinámicas no están habilitadas de forma predeterminada en el arranque. Se proporcionan formas adicionales de habilitar las RRO dinámicas en Superposiciones de recursos de tiempo de ejecución (RRO) .

  3. Verifique la prioridad de su RRO estático (no puede verificar la prioridad de un RRO dinámico).

    Múltiples RRO pueden aplicarse al mismo objetivo. Las RRO con mayor prioridad se aplican en último lugar. En una escala de 0 a 10, 0 es lo más alto y 10 lo más bajo.

Paso 5: Comprobar overlays.xml

Esta verificación se aplica solo a Android 11 (y superior).

  1. Verifique overlays.xml para confirmar que todos los recursos que desea superponer estén definidos en este archivo. Por ejemplo, considere el siguiente overlays.xml :

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

  2. Debe asegurarse de que:

    • El recurso de string con el nombre app_name existe en la aplicación de destino.
    • existe un recurso de string con el nombre overlaid_app_name en su RRO.

  3. Si su objetivo tiene un archivo overlayable.xml , asegúrese de que app_name esté contenido en ese archivo. Asegúrese de usar el targetName correcto en su archivo AndroidManifest.xml (Paso 4).

    Por ejemplo:

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

Paso 6: volcar el idmap

En esta etapa, se deben resolver todos los problemas con su RRO. A continuación, descargue el idmap de su RRO para saber cómo se resuelve un recurso y por qué se resuelve en un valor diferente al esperado.

  1. Para encontrar la ruta al idmap en su dispositivo:

    adb shell
su
ls data/resource-cache

  2. Para volcar el contenido de ese archivo:

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

    La salida parece similar a la siguiente. El resultado muestra qué identificación de su RRO se asigna a qué identificación en su objetivo, así como el nombre del recurso superpuesto.

    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

También puede volcar sus archivos de diseño de sus aplicaciones para ver las identificaciones resueltas para que coincidan con el resultado anterior:

aapt2 dump xmltree $OUT/system/priv-app/sharedlibraryclient/sharedlibraryclient.apk --file res/layout/activity_main.xml

Se devuelve una salida como la siguiente:

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