1page.title=Visão geral dos recursos 2@jd:body 3 4<div id="qv-wrapper"> 5<div id="qv"> 6 <h2>Tópicos</h2> 7 <ol> 8 <li><a href="providing-resources.html">Fornecimento de recursos</a></li> 9 <li><a href="accessing-resources.html">Acesso aos recursos</a></li> 10 <li><a href="runtime-changes.html">Tratamento de alterações em tempo de execução</a></li> 11 <li><a href="localization.html">Localização</a></li> 12 </ol> 13 14 <h2>Referência</h2> 15 <ol> 16 <li><a href="available-resources.html">Tipos de recursos</a></li> 17 </ol> 18</div> 19</div> 20 21 22<p>Deve-se sempre exteriorizar os recursos do aplicativo, como imagens e strings do código do aplicativo, 23para que você possa mantê-los independentemente. Exteriorizar os recursos 24também permite fornecer recursos alternativos que sejam compatíveis com configurações 25de dispositivos específicos, como idiomas ou tamanhos de tela diferentes, que se tornam cada vez 26mais importantes à medida que mais dispositivos com Android são disponibilizados com configurações diferentes. Para fornecer 27compatibilidade com diferentes configurações, é preciso organizar recursos no 28diretório {@code res/} de seu projeto usando vários subdiretórios que agrupem recursos por tipo e 29configuração.</p> 30 31<div class="figure" style="width:429px"> 32<img src="{@docRoot}images/resources/resource_devices_diagram1.png" height="167" alt="" /> 33<p class="img-caption"> 34<strong>Figura 1.</strong> Dois dispositivos diferentes, cada um usando o layout padrão 35(o aplicativo não fornece layouts alternativos).</p> 36</div> 37 38<div class="figure" style="width:429px"> 39<img src="{@docRoot}images/resources/resource_devices_diagram2.png" height="167" alt="" /> 40<p class="img-caption"> 41<strong>Figura 2.</strong> Dois dispositivos diferentes, cada um usando um layout diferente fornecido 42para diferentes tamanhos de tela.</p> 43</div> 44 45<p>Para qualquer tipo de recurso, é possível especificar recursos <em>padrão</em> e vários recursos 46<em>alternativos</em> para o aplicativo:</p> 47<ul> 48 <li>Recursos padrão são aqueles que devem ser usados independentemente 49da configuração do dispositivo ou quando não há recursos alternativos que correspondam à 50configuração atual.</li> 51 <li>Recursos alternativos são aqueles projetados para uso com uma configuração 52específica. Para definir que um grupo de recursos é para uma configuração específica, 53anexe um qualificador de configuração apropriado ao nome do diretório.</li> 54</ul> 55 56<p>Por exemplo, enquanto o layout da IU padrão 57é salvo no diretório {@code res/layout/}, é possível especificar um layout diferente 58a ser usado quando a tela está na orientação de paisagem salvando-o no diretório {@code res/layout-land/} 59. O Android automaticamente aplica os recursos adequados correspondendo 60a configuração atual do dispositivo com os nomes de diretórios de recursos.</p> 61 62<p>A figura 1 ilustra como o sistema aplica o mesmo layout para dois 63dispositivos diferentes quando não há recursos alternativos disponíveis. A figura 2 mostra 64o mesmo aplicativo quando é adicionado um recurso de layout alternativo para telas maiores.</p> 65 66<p>Os documentos a seguir fornecem um guia completo sobre como organizar os recursos do aplicativo, 67especificar recursos alternativos, acessá-los no aplicativo e muito mais:</p> 68 69<dl> 70 <dt><strong><a href="providing-resources.html">Como fornecer recursos</a></strong></dt> 71 <dd>Os tipos de recursos que você pode fornecer no aplicativo, onde salvá-los e como criar 72recursos alternativos para configurações específicas de dispositivos.</dd> 73 <dt><strong><a href="accessing-resources.html">Acesso aos recursos</a></strong></dt> 74 <dd>Como usar os recursos que você forneceu referenciando-os no código do aplicativo 75ou de outros recursos XML.</dd> 76 <dt><strong><a href="runtime-changes.html">Tratar alterações no tempo de execução</a></strong></dt> 77 <dd>Como gerenciar alterações de configuração que ocorrem enquanto a Atividade está em execução.</dd> 78 <dt><strong><a href="localization.html">Localização</a></strong></dt> 79 <dd>Um guia ascendente para localizar o aplicativo usando recursos alternativos. Apesar de esse ser 80apenas um uso específico de recursos alternativos, ele é muito importante para atingir mais 81usuários.</dd> 82 <dt><strong><a href="available-resources.html">Tipos de recursos</a></strong></dt> 83 <dd>Uma referência a vários tipos de recursos que você pode fornecer, descrevendo os elementos XML, 84os atributos e a sintaxe. Por exemplo, esta referência mostra como criar um recurso 85para menus do aplicativo, desenháveis, animações e mais.</dd> 86</dl> 87 88<!-- 89<h2>Raw Assets</h2> 90 91<p>An alternative to saving files in {@code res/} is to save files in the {@code 92assets/} directory. This should only be necessary if you need direct access to original files and 93directories by name. Files saved in the {@code assets/} directory will not be given a resource 94ID, so you can't reference them through the {@code R} class or from XML resources. Instead, you can 95query data in the {@code assets/} directory like an ordinary file system, search through the 96directory and 97read raw data using {@link android.content.res.AssetManager}. For example, this can be more useful 98when dealing with textures for a game. However, if you only need to read raw data from a file 99(such as a video or audio file), then you should save files into the {@code res/raw/} directory and 100then read a stream of bytes using {@link android.content.res.Resources#openRawResource(int)}. This 101is uncommon, but if you need direct access to original files in {@code assets/}, refer to the {@link 102android.content.res.AssetManager} documentation.</p> 103--> 104
