Il tag "include" di Android XML Layout funziona davvero?

Non riesco a sovrascrivere gli attributi quando utilizzo <include> nei miei file di layout Android. Quando ho cercato bug, ho trovato il problema rifiutato 2863 :

"include tag non funzionante (l'override dei parametri di layout non funziona mai)"

Poiché Romain indica che questo funziona nelle suite di test e nei suoi esempi, devo fare qualcosa di sbagliato.

Il mio progetto è organizzato in questo modo:

res/layout
  buttons.xml

res/layout-land
  receipt.xml

res/layout-port
  receipt.xml

Il buttons.xml contiene qualcosa del genere:

<LinearLayout 
    xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="wrap_content"
    android:layout_height="wrap_content"
    android:orientation="horizontal">

  <Button .../>

  <Button .../>
</LinearLayout>

E i file ricezioni.xml verticale e orizzontale hanno un aspetto simile a:

<LinearLayout
    xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="fill_parent"
    android:layout_height="fill_parent"
    android:orientation="vertical">

  ...

  <!-- Overridden attributes never work. Nor do attributes like
       the red background, which is specified here. -->
  <include
      android:id="@+id/buttons_override"
      android:background="#ff0000"
      android:layout_width="fill_parent"
      layout="@layout/buttons"/>

</LinearLayout>

Cosa mi manca?

Ho appena trovato il problema. Innanzitutto, puoi solo sovrascrivere gli attributi layout_ *, quindi lo sfondo non funzionerà. Questo è un comportamento documentato e semplicemente una mia svista.

Il vero problema si trova in LayoutInflater.java:

// We try to load the layout params set in the <include /> tag. If
// they don't exist, we will rely on the layout params set in the
// included XML file.
// During a layoutparams generation, a runtime exception is thrown
// if either layout_width or layout_height is missing. We catch
// this exception and set localParams accordingly: true means we
// successfully loaded layout params from the <include /> tag,
// false means we need to rely on the included layout params.
ViewGroup.LayoutParams params = null;
try {
   params = group.generateLayoutParams(attrs);
} catch (RuntimeException e) {
   params = group.generateLayoutParams(childAttrs);
} finally {
   if (params != null) {
     view.setLayoutParams(params);
   }
}

Se il tag <include> non include sia layout_width che layout_height, la RuntimeException si verifica e viene gestita silenziosamente, senza alcuna istruzione di log.

La soluzione è includere sempre sia layout_width che layout_height quando si utilizza il tag <include>, se si desidera sovrascrivere uno qualsiasi degli attributi layout_ *.

Il mio esempio dovrebbe cambiare in:

<include
      android:id="@+id/buttons_override"
      android:layout_width="fill_parent"
      android:layout_height="wrap_content"
      layout="@layout/buttons"/>

Ho inviato una richiesta di miglioramento per consentire la sostituzione di tutti gli attributi inclusi:

Supponiamo di avere due layout identici diversi dai valori di un TextViewcampo. Al momento, ho modificato il layout in fase di esecuzione o duplicato l'XML.

Ad esempio, per passare due parametri con valori "hello" e "world" a layout1:

<include layout="@layout/layout1a" params="textView=hello|editText=world" />

layout1a.xml:

<merge><TextView text="@param/textView"><EditText hint="@param/editText"></merge>

Un'implementazione alternativa romperebbe l'incapsulamento e consentirebbe all'istruzione include di sovrascrivere valori come:

<include layout="@layout/layout1b" overrides="@id/textView.text=hello|@id/editText.hint=world" />

layout1b.xml:

<merge><TextView id="@+id/textView"><EditText hint="@+id/editText"></merge>

Ho scoperto che a volte mi manca l'inclusione del tag android: id quando si utilizza il generatore di GUI in Eclipse. Assicurandomi (quando noto) di aggiungere in un TextView dal builder, l'id che sto usando nel layout ListView.

<TextView android:text="@+id/textView1"
        android:layout_width="wrap_content" 
        android:layout_height="wrap_content" />
...

diventa

<TextView android:id="@+id/textView1"
        android:layout_width="wrap_content" 
        android:layout_height="wrap_content" />
...

Invece di ottenere "false", "false" ottengo :) e include il funzionamento corretto.