docs/html-intl/intl/pt-br/guide/topics/resources/overview.jd

page.title=Visão geral dos recursos
@jd:body

<div id="qv-wrapper">
<div id="qv">
  <h2>Tópicos</h2>
  <ol>
    <li><a href="providing-resources.html">Fornecimento de recursos</a></li>
    <li><a href="accessing-resources.html">Acesso aos recursos</a></li>
    <li><a href="runtime-changes.html">Tratamento de alterações em tempo de execução</a></li>
    <li><a href="localization.html">Localização</a></li>
  </ol>

  <h2>Referência</h2>
  <ol>
    <li><a href="available-resources.html">Tipos de recursos</a></li>
  </ol>
</div>
</div>


<p>Deve-se sempre exteriorizar os recursos do aplicativo, como imagens e strings do código do aplicativo,
para que você possa mantê-los independentemente. Exteriorizar os recursos
também permite fornecer recursos alternativos que sejam compatíveis com configurações
de dispositivos específicos, como idiomas ou tamanhos de tela diferentes, que se tornam cada vez
mais importantes à medida que mais dispositivos com Android são disponibilizados com configurações diferentes. Para fornecer
compatibilidade com diferentes configurações, é preciso organizar recursos no
diretório {@code res/} de seu projeto usando vários subdiretórios que agrupem recursos por tipo e
configuração.</p>

<div class="figure" style="width:429px">
<img src="{@docRoot}images/resources/resource_devices_diagram1.png" height="167" alt="" />
<p class="img-caption">
<strong>Figura 1.</strong> Dois dispositivos diferentes, cada um usando o layout padrão
(o aplicativo não fornece layouts alternativos).</p>
</div>

<div class="figure" style="width:429px">
<img src="{@docRoot}images/resources/resource_devices_diagram2.png" height="167" alt="" />
<p class="img-caption">
<strong>Figura 2.</strong> Dois dispositivos diferentes, cada um usando um layout diferente fornecido
para diferentes tamanhos de tela.</p>
</div>

<p>Para qualquer tipo de recurso, é possível especificar recursos <em>padrão</em> e vários recursos
<em>alternativos</em> para o aplicativo:</p>
<ul>
  <li>Recursos padrão são aqueles que devem ser usados independentemente
da configuração do dispositivo ou quando não há recursos alternativos que correspondam à
configuração atual.</li>
  <li>Recursos alternativos são aqueles projetados para uso com uma configuração
específica. Para definir que um grupo de recursos é para uma configuração específica,
anexe um qualificador de configuração apropriado ao nome do diretório.</li>
</ul>

<p>Por exemplo, enquanto o layout da IU padrão
é salvo no diretório {@code res/layout/}, é possível especificar um layout diferente
a ser usado quando a tela está na orientação de paisagem salvando-o no diretório {@code res/layout-land/}
. O Android automaticamente aplica os recursos adequados correspondendo
a configuração atual do dispositivo com os nomes de diretórios de recursos.</p>

<p>A figura 1 ilustra como o sistema aplica o mesmo layout para dois
dispositivos diferentes quando não há recursos alternativos disponíveis. A figura 2 mostra
o mesmo aplicativo quando é adicionado um recurso de layout alternativo para telas maiores.</p>

<p>Os documentos a seguir fornecem um guia completo sobre como organizar os recursos do aplicativo,
especificar recursos alternativos, acessá-los no aplicativo e muito mais:</p>

<dl>
  <dt><strong><a href="providing-resources.html">Como fornecer recursos</a></strong></dt>
  <dd>Os tipos de recursos que você pode fornecer no aplicativo, onde salvá-los e como criar
recursos alternativos para configurações específicas de dispositivos.</dd>
  <dt><strong><a href="accessing-resources.html">Acesso aos recursos</a></strong></dt>
  <dd>Como usar os recursos que você forneceu referenciando-os no código do aplicativo
ou de outros recursos XML.</dd>
  <dt><strong><a href="runtime-changes.html">Tratar alterações no tempo de execução</a></strong></dt>
  <dd>Como gerenciar alterações de configuração que ocorrem enquanto a Atividade está em execução.</dd>
  <dt><strong><a href="localization.html">Localização</a></strong></dt>
  <dd>Um guia ascendente para localizar o aplicativo usando recursos alternativos. Apesar de esse ser
apenas um uso específico de recursos alternativos, ele é muito importante para atingir mais
usuários.</dd>
  <dt><strong><a href="available-resources.html">Tipos de recursos</a></strong></dt>
  <dd>Uma referência a vários tipos de recursos que você pode fornecer, descrevendo os elementos XML,
os atributos e a sintaxe. Por exemplo, esta referência mostra como criar um recurso
para menus do aplicativo, desenháveis, animações e mais.</dd>
</dl>

<!--
<h2>Raw Assets</h2>

<p>An alternative to saving files in {@code res/} is to save files in the {@code
assets/} directory. This should only be necessary if you need direct access to original files and
directories by name. Files saved in the {@code assets/} directory will not be given a resource
ID, so you can't reference them through the {@code R} class or from XML resources. Instead, you can
query data in the {@code assets/} directory like an ordinary file system, search through the
directory and
read raw data using {@link android.content.res.AssetManager}. For example, this can be more useful
when dealing with textures for a game. However, if you only need to read raw data from a file
(such as a video or audio file), then you should save files into the {@code res/raw/} directory and
then read a stream of bytes using {@link android.content.res.Resources#openRawResource(int)}. This
is uncommon, but if you need direct access to original files in {@code assets/}, refer to the {@link
android.content.res.AssetManager} documentation.</p>
-->