Mais tipos de recursos

Esta página define os seguintes tipos de recursos que você pode externalizar:

Booleano
Recurso XML que carrega um valor booleano.
Cor
Recurso XML que carrega um valor de cor (uma cor hexadecimal).
Dimensão
Recurso XML que carrega um valor de dimensão (com uma unidade de medida).
ID
Recurso em XML que fornece um identificador exclusivo para recursos e componentes do aplicativo.
Número inteiro
Recurso XML que carrega um valor inteiro.
Matriz de números inteiros
Recurso XML que fornece uma matriz de números inteiros.
Matriz tipada
Recurso XML que fornece uma TypedArray, que você pode usar para uma matriz de drawables.

Booleano

Um valor booleano definido em XML.

Observação: um booleano é um recurso simples que é referenciado usando o valor fornecido no atributo name, não no nome do arquivo XML. Dessa forma, você pode combinar recursos booleanos com outros recursos simples em um arquivo XML em um elemento <resources>.

local do arquivo:
res/values/filename.xml
O nome do arquivo é arbitrário. O name do elemento <bool> é usado como o ID do recurso.
referência de recurso:
Em Java: R.bool.bool_name
Em XML: @[package:]bool/bool_name
sintaxe:
<?xml version="1.0" encoding="utf-8"?>
<resources>
    <bool
        name="bool_name"
        >[true | false]</bool>
</resources>
elementos:
<resources>
Obrigatório. Este é o nó raiz.

Nenhum atributo.

<bool>
Um valor booleano: true ou false.

Atributos:

name
String. Um nome para o valor booleano. Esse nome é usado como o ID do recurso.
exemplo:
Arquivo XML salvo em res/values-small/bools.xml:
<?xml version="1.0" encoding="utf-8"?>
<resources>
    <bool name="screen_small">true</bool>
    <bool name="adjust_view_bounds">true</bool>
</resources>

O código do aplicativo a seguir recupera o booleano:

Kotlin

val screenIsSmall: Boolean = resources.getBoolean(R.bool.screen_small)

Java

Resources res = getResources();
boolean screenIsSmall = res.getBoolean(R.bool.screen_small);

Este XML de layout usa o booleano para um atributo:

<ImageView
    android:layout_height="fill_parent"
    android:layout_width="fill_parent"
    android:src="@drawable/logo"
    android:adjustViewBounds="@bool/adjust_view_bounds" />

Cor

Um valor de cor definido em XML. A cor é especificada por um valor RGB e um canal Alfa. Você pode usar um recurso de cor em qualquer lugar que aceite um valor de cor hexadecimal. Também é possível usar um recurso de cor quando um recurso drawable é esperado em XML, como android:drawable="@color/green".

O valor sempre começa com um caractere cerquilha (#), que é seguido pela informação Alpha-Red-Green-Blue em um dos formatos abaixo:

  • #RGB
  • #ARGB
  • #RRGGBB
  • #AARRGGBB

Observação: uma cor é um recurso simples que é referenciado usando o valor fornecido no atributo name, não no nome do arquivo XML. Dessa forma, você pode combinar os recursos de cor com outros recursos simples em um arquivo XML em um elemento <resources>.

local do arquivo:
res/values/colors.xml
O nome do arquivo é arbitrário. O name do elemento <color> é usado como o ID do recurso.
referência de recurso:
Em Java: R.color.color_name
Em XML: @[package:]color/color_name
sintaxe:
<?xml version="1.0" encoding="utf-8"?>
<resources>
    <color
        name="color_name"
        >hex_color</color>
</resources>
elementos:
<resources>
Obrigatório. Este é o nó raiz.

Nenhum atributo.

<color>
Uma cor expressa em hexadecimal.

Atributos:

name
String. Um nome para a cor. Esse nome é usado como o ID do recurso.
exemplo:
Arquivo XML salvo em res/values/colors.xml:
<?xml version="1.0" encoding="utf-8"?>
<resources>
   <color name="opaque_red">#f00</color>
   <color name="translucent_red">#80ff0000</color>
</resources>

O código do aplicativo a seguir recupera o recurso de cor:

Kotlin

val color: Int = resources.getColor(R.color.opaque_red)

Java

Resources res = getResources();
int color = res.getColor(R.color.opaque_red);

Este XML de layout aplica a cor a um atributo:

<TextView
    android:layout_width="fill_parent"
    android:layout_height="wrap_content"
    android:textColor="@color/translucent_red"
    android:text="Hello"/>

Dimensão

Um valor de dimensão definido em XML. Uma dimensão é especificada por um número seguido por uma unidade de medida, como 10 px, 2 pol ou 5 sp. As unidades de medida abaixo têm suporte no Android:

dp
Pixel de densidade independente: unidade abstrata baseada na densidade física da tela. Essas unidades são relativas a uma tela de 160 pontos por polegada (DPI), em que 1 dp é aproximadamente igual a 1 px. Quando o app é executado em uma tela de densidade mais alta, o número de pixels usados para renderizar 1 dp é aumentado por um fator adequado para o DPI da tela.

Da mesma forma, quando uma tela de densidade menor é usada, o número de pixels usados para 1 dp é reduzido. A taxa de dps para pixels muda com a densidade da tela, mas não necessariamente em uma proporção direta. Usar unidades dp em vez de px é uma solução simples para fazer com que as dimensões de visualização do seu layout sejam redimensionadas corretamente para diferentes densidades de tela. Elas oferecem consistência para tamanhos reais dos elementos de interface em diferentes dispositivos.

sp
Pixel de escala independente: como a unidade dp, mas dimensionada pela preferência do usuário pelo tamanho da fonte. É recomendado usar essa unidade ao especificar os tamanhos de fonte para que eles sejam ajustados para a densidade da tela e a preferência do usuário.
pt
Pontos: 1/72 de polegada com base no tamanho físico da tela, supondo uma tela de densidade de 72 DPI.
px
Pixels: corresponde aos pixels reais na tela. Não recomendamos o uso dessa unidade, já que a representação real pode variar de acordo com o dispositivo. Dispositivos diferentes podem ter um número diferente de pixels por polegada, bem como mais ou menos pixels totais disponíveis na tela.
mm
Milímetros: com base no tamanho físico da tela.
in
Polegadas: com base no tamanho físico da tela.

Observação: uma dimensão é um recurso simples que é referenciado usando o valor fornecido no atributo name, não no nome do arquivo XML. Dessa forma, você pode combinar recursos de dimensão com outros recursos simples em um arquivo XML em um elemento <resources>.

local do arquivo:
res/values/filename.xml
O nome do arquivo é arbitrário. O name do elemento <dimen> é usado como o ID do recurso.
referência de recurso:
Em Java: R.dimen.dimension_name
Em XML: @[package:]dimen/dimension_name
sintaxe:
<?xml version="1.0" encoding="utf-8"?>
<resources>
    <dimen
        name="dimension_name"
        >dimension</dimen>
</resources>
elementos:
<resources>
Obrigatório. Este é o nó raiz.

Nenhum atributo.

<dimen>
Uma dimensão, representada por um valor de ponto flutuante, seguida por uma unidade de medida (dp, sp, pt, px, mm, pol).

Atributos:

name
String. Um nome para a dimensão. Esse nome é usado como o ID do recurso.
exemplo:
Arquivo XML salvo em res/values/dimens.xml:
<?xml version="1.0" encoding="utf-8"?>
<resources>
    <dimen name="textview_height">25dp</dimen>
    <dimen name="textview_width">150dp</dimen>
    <dimen name="ball_radius">30dp</dimen>
    <dimen name="font_size">16sp</dimen>
</resources>

Este código do aplicativo extrai uma dimensão:

Kotlin

val fontSize: Float = resources.getDimension(R.dimen.font_size)

Java

Resources res = getResources();
float fontSize = res.getDimension(R.dimen.font_size);

Este XML de layout aplica dimensões a atributos:

<TextView
    android:layout_height="@dimen/textview_height"
    android:layout_width="@dimen/textview_width"
    android:textSize="@dimen/font_size"/>

ID

Um ID exclusivo de recurso definido em XML. Usando o nome que você fornece no elemento <item>, as ferramentas para desenvolvedores Android criam um número inteiro exclusivo na classe R.java do projeto que pode ser usado como um identificador para recursos de aplicativo, como uma View no seu layout de interface, ou um número inteiro exclusivo para ser usado no código do seu aplicativo (por exemplo, como um ID para uma caixa de diálogo ou um código de resultado).

Observação: um ID é um recurso simples que é referenciado usando o valor fornecido no atributo name, não no nome do arquivo XML. Dessa forma, você pode combinar recursos de ID com outros recursos simples em um arquivo XML em um elemento <resources>. Além disso, um ID de recurso não se refere a um item de recurso real. É simplesmente um ID exclusivo que você pode anexar a outros recursos ou usar como um número inteiro exclusivo no aplicativo.

local do arquivo:
res/values/filename.xml
O nome do arquivo é arbitrário.
referência de recurso:
Em Java: R.id.name
Em XML: @[package:]id/name
sintaxe:
<?xml version="1.0" encoding="utf-8"?>
<resources>
    <item
        type="id"
        name="id_name" />
</resources>
elementos:
<resources>
Obrigatório. Este é o nó raiz.

Nenhum atributo.

<item>
Define um ID exclusivo. Não tem valor, apenas atributos.

Atributos:

type
Precisa ser "id".
name
String. Um nome exclusivo para o ID.
Exemplo:

Arquivo XML salvo em res/values/ids.xml:

<?xml version="1.0" encoding="utf-8"?>
<resources>
    <item type="id" name="button_ok" />
    <item type="id" name="dialog_exit" />
</resources>

O snippet de layout a seguir usa o ID "button_ok" para um widget Button:

<Button android:id="@id/button_ok"
    style="@style/button_style" />

O valor android:id não inclui o sinal de adição na referência do ID porque o ID já existe, conforme definido no exemplo ids.xml acima. Especificar um ID para um recurso XML usando o sinal de adição no formato android:id="@+id/name" significa que o ID "name" ainda não existe e precisa ser criado.

Como outro exemplo, o snippet de código a seguir usa o ID "dialog_exit" como um identificador exclusivo para uma caixa de diálogo:

Kotlin

showDialog(R.id.dialog_exit)

Java

showDialog(R.id.dialog_exit);

No mesmo aplicativo, o ID "dialog_exit" é comparado ao criar uma caixa de diálogo:

Kotlin

override fun onCreateDialog(id: Int): Dialog? {
    return when(id) {
        R.id.dialog_exit -> {
            ...
        }
        else -> {
            null
        }
    }
}

Java

protected Dialog onCreateDialog(int id) {
    Dialog dialog;
    switch(id) {
    case R.id.dialog_exit:
        ...
        break;
    default:
        dialog = null;
    }
    return dialog;
}

Número inteiro

Um número inteiro definido em XML.

Observação: um número inteiro é um recurso simples que é referenciado usando o valor fornecido no atributo name, não no nome do arquivo XML. Dessa forma, você pode combinar recursos de números inteiros com outros recursos simples em um arquivo XML em um elemento <resources>.

local do arquivo:
res/values/filename.xml
O nome do arquivo é arbitrário. O name do elemento <integer> é usado como o ID do recurso.
referência de recurso:
Em Java: R.integer.integer_name
Em XML: @[package:]integer/integer_name
sintaxe:
<?xml version="1.0" encoding="utf-8"?>
<resources>
    <integer
        name="integer_name"
        >integer</integer>
</resources>
elementos:
<resources>
Obrigatório. Este é o nó raiz.

Nenhum atributo.

<integer>
Um número inteiro.

Atributos:

name
String. Um nome para o número inteiro. Esse nome é usado como o ID do recurso.
exemplo:

Arquivo XML salvo em res/values/integers.xml:

<?xml version="1.0" encoding="utf-8"?>
<resources>
    <integer name="max_speed">75</integer>
    <integer name="min_speed">5</integer>
</resources>

Este código do aplicativo extrai um número inteiro:

Kotlin

val maxSpeed: Int = resources.getInteger(R.integer.max_speed)

Java

Resources res = getResources();
int maxSpeed = res.getInteger(R.integer.max_speed);

Matriz de números inteiros

Uma matriz de números inteiros definida em XML.

Observação: uma matriz de números inteiros é um recurso simples que é referenciado usando o valor fornecido no atributo name, não no nome do arquivo XML. Dessa forma, você pode combinar recursos de matriz de números inteiros com outros recursos simples em um arquivo XML em um elemento <resources>.

local do arquivo:
res/values/filename.xml
O nome do arquivo é arbitrário. O name do elemento <integer-array> é usado como o ID do recurso.
tipo de dados do recurso compilado:
Ponteiro de recurso para uma matriz de números inteiros.
referência de recurso:
Em Java: R.array.integer_array_name
Em XML: @[package:]array/integer_array_name
sintaxe:
<?xml version="1.0" encoding="utf-8"?>
<resources>
    <integer-array
        name="integer_array_name">
        <item
            >integer</item>
    </integer-array>
</resources>
elementos:
<resources>
Obrigatório. Este é o nó raiz.

Nenhum atributo.

<integer-array>
Define uma matriz de números inteiros. Contém um ou mais elementos <item> filhos.

Atributos:

android:name
String. Um nome para a matriz. O nome do arquivo é usado como o ID do recurso para referenciar a matriz.
<item>
Um número inteiro. O valor pode ser uma referência a outro recurso de número inteiro. Precisa ser um filho de um elemento <integer-array>.

Nenhum atributo.

Exemplo:
Arquivo XML salvo em res/values/integers.xml:
<?xml version="1.0" encoding="utf-8"?>
<resources>
    <integer-array name="bits">
        <item>4</item>
        <item>8</item>
        <item>16</item>
        <item>32</item>
    </integer-array>
</resources>

Este código do aplicativo extrai a matriz de números inteiros:

Kotlin

val bits: IntArray = resources.getIntArray(R.array.bits)

Java

Resources res = getResources();
int[] bits = res.getIntArray(R.array.bits);

Matriz tipada

Um TypedArray definido em XML. Você pode usá-lo para criar uma matriz de outros recursos, como drawables. Não é necessário que a matriz seja homogênea. Você pode criar uma matriz de tipos de recursos mistos, mas precisa estar ciente dos tipos de dados e onde eles estão na matriz para que seja possível extrair corretamente cada item com os métodos get...() da classe TypedArray.

Observação: uma matriz tipada é um recurso simples que é referenciado usando o valor fornecido no atributo name, não no nome do arquivo XML. Dessa forma, você pode combinar recursos de matriz tipada com outros recursos simples em um arquivo XML em um elemento <resources>.

local do arquivo:
res/values/filename.xml
O nome do arquivo é arbitrário. O name do elemento <array> é usado como o ID do recurso.
tipo de dados do recurso compilado:
Ponteiro do recurso para um TypedArray.
referência de recurso:
Em Java: R.array.array_name
Em XML: @[package:]array/array_name
sintaxe:
<?xml version="1.0" encoding="utf-8"?>
<resources>
    <array
        name="integer_array_name">
        <item>resource</item>
    </array>
</resources>
elementos:
<resources>
Obrigatório. Este é o nó raiz.

Nenhum atributo.

<array>
Define uma matriz. Contém um ou mais elementos <item> filhos.

Atributos:

android:name
String. Um nome para a matriz. O nome do arquivo é usado como o ID do recurso para referenciar a matriz.
<item>
Um recurso genérico. O valor pode ser uma referência a um recurso ou a um tipo de dados simples. Precisa ser um filho de um elemento <array>.

Nenhum atributo.

Exemplo:
Arquivo XML salvo em res/values/arrays.xml:
<?xml version="1.0" encoding="utf-8"?>
<resources>
    <array name="icons">
        <item>@drawable/home</item>
        <item>@drawable/settings</item>
        <item>@drawable/logout</item>
    </array>
    <array name="colors">
        <item>#FFFF0000</item>
        <item>#FF00FF00</item>
        <item>#FF0000FF</item>
    </array>
</resources>

Este código de aplicativo acessa cada matriz e extrai a primeira entrada em cada uma delas:

Kotlin

val icons: TypedArray = resources.obtainTypedArray(R.array.icons)
val drawable: Drawable = icons.getDrawable(0)

val colors: TypedArray = resources.obtainTypedArray(R.array.colors)
val color: Int = colors.getColor(0,0)

Java

Resources res = getResources();
TypedArray icons = res.obtainTypedArray(R.array.icons);
Drawable drawable = icons.getDrawable(0);

TypedArray colors = res.obtainTypedArray(R.array.colors);
int color = colors.getColor(0,0);