Esta página define mais tipos de recursos que você pode externalizar, incluindo:
- 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 único 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>
.
- localização do arquivo:
res/values/filename.xml
O nome do arquivo é arbitrário. Oname
do elemento<bool>
vai ser 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:
- 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>
Este código do aplicativo extrai 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 com um valor RGB e um canal Alfa. Você pode usar um recurso de cor
em qualquer lugar que aceite um valor de cor hexadecimal. Você também pode usar um recurso de cor quando um
recurso drawable é esperado em XML (por exemplo, android:drawable="@color/green"
).
O valor sempre começa com um caractere cerquilha (#) 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>
.
- localização do arquivo:
res/values/colors.xml
O nome do arquivo é arbitrário. Oname
do elemento<color>
vai ser 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:
- 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>
Este código do aplicativo extrai 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. Por exemplo: 10 px, 2 pol, 5 sp. As unidades de medida abaixo têm suporte no Android:
dp
- Pixel de densidade independente: unidade abstrata que é baseada na densidade física da tela. Essas unidades são relativas a uma tela de 160 pontos por polegada (DPI, na sigla em inglês), em que 1 dp é, aproximadamente, igual a 1 px. Quando o app estiver sendo executado em uma tela de densidade mais alta, o número de pixels usado para renderizar 1 dp vai ser aumentado por um fator apropriado para o DPI da tela. Da mesma forma, quando uma tela de densidade menor for usada, o número de pixels usados para 1 dp vai ser reduzido. A proporção de dp para pixels vai ser alterada para a densidade da tela, mas não necessariamente em uma proporção direta. Usar unidades dp (em vez de unidades 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. Em outras palavras, elas oferecem consistência para tamanhos dos seus elementos de IU no mundo real em diferentes dispositivos.
sp
- Pixel de escala independente: é uma unidade como a unidade dp, mas também é dimensionada pela preferência do usuário pelo do tamanho da fonte. É recomendado usar essa unidade ao especificar os tamanhos da fonte, para que sejam ajustados para a densidade da tela e para 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. Essa unidade de medida não é recomendada porque a representação real pode variar entre os dispositivos. Cada dispositivo pode ter um número diferente de pixels por polegada e pode ter 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
(e 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>
.
- localização do arquivo:
res/values/filename.xml
O nome do arquivo é arbitrário. Oname
do elemento<dimen>
vai ser 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:
- 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);Esse 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 (por exemplo, uma View
no seu layout de IU)
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, não esqueça que 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.
- localização 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:
- 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>
Esse snippet de layout usa o ID "button_ok" para um widget de botão:
<Button android:id="@id/button_ok" style="@style/button_style" />
Observe que o valor
android:id
não inclui o sinal de adição na referência do ID, porque o ID já existe, como definido no exemploids.xml
acima. Quando você especifica um ID para um recurso XML usando o sinal de adição, no formatoandroid:id="@+id/name"
, significa que o "nome" do ID não existe e precisa ser criado.Como outro exemplo, o snippet de código abaixo 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>
.
- localização do arquivo:
res/values/filename.xml
O nome do arquivo é arbitrário. Oname
do elemento<integer>
vai ser 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:
- 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>
.
- localização do arquivo:
res/values/filename.xml
O nome do arquivo é arbitrário. Oname
do elemento<integer-array>
vai ser 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:
- 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. Observe que a matriz
não é obrigatoriamente 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 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>
.
- localização do arquivo:
res/values/filename.xml
O nome do arquivo é arbitrário. Oname
do elemento<array>
vai ser 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:
- 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);