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

Utilice este contenido para solucionar problemas por los cuales una superposición de recursos en 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 Cambiar el valor de los recursos de una aplicación en tiempo de ejecución . Asegúrese de mantener una vigilancia constante sobre la salida logcat , que puede proporcionar buena información sobre lo que sucede durante todo el proceso.

Paso 1: enumerar 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 un RRO

Si se instala un RRO:

  1. Utilice 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 un RRO está instalado en un dispositivo o solucionar el problema por el cual el RRO no estaba habilitado:

  1. Ejecute el siguiente comando:

    adb shell cmd overlay dump [your RRO package name]

    Aparece un resultado como el 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 el usuario (o usuarios) que ha 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 objetivo no está instalado.

    • STATE_NO_IDMAP . Algo anda mal con la forma en que se configuran los archivos AndroidManifest.xml , overlays.xml o overlayable.xml . Utilice adb logcat para ejecutar los registros y busque la palabra clave idmap para identificar el error. Ver los pasos 4 y 5

    • STATE_UNKNOWN . Algo anda mal con OverlayManagerService .

Paso 4: verifique AndroidManifest.xml

Para verificar AndroidManifest.xml :

  1. Verifique targetName y targetPackage .

    android:targetName debe tener el mismo valor que el grupo superpuesto definido en la aplicación de destino. Esto sólo es necesario cuando se apunta 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). Los RRO estáticos están habilitados de forma predeterminada en el momento del arranque. Los RRO dinámicos no están habilitados de forma predeterminada en el arranque. Se proporcionan formas adicionales de habilitar RRO dinámicos en Cambiar el valor de los recursos de una aplicación en tiempo de ejecución .

  3. Verifique la prioridad de su RRO estático (la prioridad de RRO dinámica siempre se establece en Integer.MAX_VALUE y el orden en el que se aplican se basa en cuándo están habilitados).

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

Paso 5: Verifique 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 string con el nombre app_name existe en la aplicación de destino.
    • El recurso string con el nombre overlaid_app_name existe 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 utilizar 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 mapa de identificación

En esta etapa, todos los problemas con su RRO deberían estar resueltos. A continuación, descargue el idmap de su RRO para saber cómo se resuelve un recurso y por qué se resuelve con 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]

    El resultado es similar al siguiente. El resultado muestra qué ID de su RRO está asignado a qué ID en su destino, 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

Utilice el siguiente comando para buscar un recurso específico y ver cómo están asignados:

adb shell cmd overlay lookup --verbose --user 10 com.android.car.ui.paintbooth com.android.car.ui.paintbooth:color/widget_background

La salida es el valor final del recurso:

#ff7986cb

También puede volcar sus archivos de diseño desde sus aplicaciones para ver los ID resueltos que coincidan con el resultado anterior:

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

Se devuelve un resultado como el 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!!")