1 page.title=Viso geral dos recursos 2 @jd:body 3 4 <div id="qv-wrapper"> 5 <div id="qv"> 6 <h2>Tpicos</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 alteraes em tempo de execuo</a></li> 11 <li><a href="localization.html">Localizao</a></li> 12 </ol> 13 14 <h2>Referncia</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 cdigo do aplicativo, 23 para que voc possa mant-los independentemente. Exteriorizar os recursos 24 tambm permite fornecer recursos alternativos que sejam compatveis com configuraes 25 de dispositivos especficos, como idiomas ou tamanhos de tela diferentes, que se tornam cada vez 26 mais importantes medida que mais dispositivos com Android so disponibilizados com configuraes diferentes. Para fornecer 27 compatibilidade com diferentes configuraes, preciso organizar recursos no 28 diretrio {@code res/} de seu projeto usando vrios subdiretrios que agrupem recursos por tipo e 29 configurao.</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 padro 35 (o aplicativo no 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 42 para diferentes tamanhos de tela.</p> 43 </div> 44 45 <p>Para qualquer tipo de recurso, possvel especificar recursos <em>padro</em> e vrios recursos 46 <em>alternativos</em> para o aplicativo:</p> 47 <ul> 48 <li>Recursos padro so aqueles que devem ser usados independentemente 49 da configurao do dispositivo ou quando no h recursos alternativos que correspondam 50 configurao atual.</li> 51 <li>Recursos alternativos so aqueles projetados para uso com uma configurao 52 especfica. Para definir que um grupo de recursos para uma configurao especfica, 53 anexe um qualificador de configurao apropriado ao nome do diretrio.</li> 54 </ul> 55 56 <p>Por exemplo, enquanto o layout da IU padro 57 salvo no diretrio {@code res/layout/}, possvel especificar um layout diferente 58 a ser usado quando a tela est na orientao de paisagem salvando-o no diretrio {@code res/layout-land/} 59 . O Android automaticamente aplica os recursos adequados correspondendo 60 a configurao atual do dispositivo com os nomes de diretrios de recursos.</p> 61 62 <p>A figura 1 ilustra como o sistema aplica o mesmo layout para dois 63 dispositivos diferentes quando no h recursos alternativos disponveis. A figura 2 mostra 64 o 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, 67 especificar 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 72 recursos alternativos para configuraes especficas 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 cdigo do aplicativo 75 ou de outros recursos XML.</dd> 76 <dt><strong><a href="runtime-changes.html">Tratar alteraes no tempo de execuo</a></strong></dt> 77 <dd>Como gerenciar alteraes de configurao que ocorrem enquanto a Atividade est em execuo.</dd> 78 <dt><strong><a href="localization.html">Localizao</a></strong></dt> 79 <dd>Um guia ascendente para localizar o aplicativo usando recursos alternativos. Apesar de esse ser 80 apenas um uso especfico de recursos alternativos, ele muito importante para atingir mais 81 usurios.</dd> 82 <dt><strong><a href="available-resources.html">Tipos de recursos</a></strong></dt> 83 <dd>Uma referncia a vrios tipos de recursos que voc pode fornecer, descrevendo os elementos XML, 84 os atributos e a sintaxe. Por exemplo, esta referncia mostra como criar um recurso 85 para menus do aplicativo, desenhveis, animaes 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 92 assets/} directory. This should only be necessary if you need direct access to original files and 93 directories by name. Files saved in the {@code assets/} directory will not be given a resource 94 ID, so you can't reference them through the {@code R} class or from XML resources. Instead, you can 95 query data in the {@code assets/} directory like an ordinary file system, search through the 96 directory and 97 read raw data using {@link android.content.res.AssetManager}. For example, this can be more useful 98 when 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 100 then read a stream of bytes using {@link android.content.res.Resources#openRawResource(int)}. This 101 is uncommon, but if you need direct access to original files in {@code assets/}, refer to the {@link 102 android.content.res.AssetManager} documentation.</p> 103 --> 104
