guide/components/fundamentals.jd

page.title=Fundamentos de aplicativos
@jd:body

<div id="qv-wrapper">
<div id="qv">

<h2>Neste documento</h2>
<ol>
<li><a href="#Components">Componentes de aplicativo</a>
  <ol>
    <li><a href="#ActivatingComponents">Ativao de componentes</a></li>
  </ol>
</li>
<li><a href="#Manifest">O arquivo de manifesto</a>
  <ol>
    <li><a href="#DeclaringComponents">Declarao de componentes</a></li>
    <li><a href="#DeclaringRequirements">Declarao de requisitos do aplicativo</a></li>
  </ol>
</li>
<li><a href="#Resources">Recursos do aplicativo</a></li>
</ol>
</div>
</div>

<p>Os aplicativos do Android so programados em linguagem de programao Java. As ferramentas Android SDK compilam
o cdigo &mdash; em conjunto com todos os arquivos de dados e recursos &mdash; em um APK, que  o <i>pacote do Android</i>,
um arquivo de arquivamento com sufixo {@code .apk}. Os arquivos de APK contm todo o contedo
de um aplicativo do Android e so os arquivos que os dispositivos desenvolvidos para Android usam para instalar o aplicativo.</p>

<p>Depois de instalado em um dispositivo, cada aplicativo do Android  ativado em sua prpria rea de segurana: </p>

<ul>
 <li>O sistema operacional Android  um sistema Linux multiusurio em que cada aplicativo
 um usurio diferente.</li>

<li>Por padro, o sistema atribui a cada aplicativo um ID de usurio do Linux exclusivo (o ID  usado somente
pelo sistema e  desconhecido para o aplicativo). O sistema define permisses para todos os arquivos
em um aplicativo, de modo que somente o ID de usurio atribudo quele aplicativo pode acess-los. </li>

<li>Cada processo tem sua prpria mquina virtual (VM), portanto o cdigo de um aplicativo  executado isoladamente
de outros aplicativos.</li>

<li>Por padro, cada aplicativo  executado em seu prprio processo Linux. O Android inicia o processo quando  preciso
executar algum componente do aplicativo; em seguida, encerra-o quando no mais
necessrio ou quando o sistema precisa recuperar memria para outros aplicativos.</li>
</ul>

<p>Assim, o sistema Android implementa o <em>princpio do privilgio mnimo</em>. Ou seja,
cada aplicativo, por padro, tem acesso somente aos componentes necessrios para a execuo do seu trabalho
e nada mais. Isso cria um ambiente muito seguro em que o aplicativo no pode acessar partes
do sistema para o qual no tem permisso.</p>

<p>No entanto, sempre existe uma maneira de um aplicativo compartilhar dados com outros aplicativos
e acessar servios do sistema:</p>

<ul>
  <li> impossvel fazer com que dois aplicativos compartilhem o mesmo ID de usurio do Linux, caso em que
eles so capazes de acessar os arquivos um do outro.  Para preservar os recursos do sistema, os aplicativos com o mesmo
ID de usurio tambm podem ser combinados para serem executados no mesmo processo Linux e compartilhar a mesma VM
(tambm  preciso atribuir o mesmo certificado aos aplicativos).</li>
  <li>Um aplicativo pode solicitar permisso para acessar dados de dispositivo como
contatos do usurio, mensagens SMS, o sistema montvel (carto SD), cmera, Bluetooth etc. Todas
as permisses de aplicativo devem ser concedidas pelo usurio no momento da instalao.</li>
</ul>

<p>Essas so as informaes bsicas de como um aplicativo do Android existe dentro do sistema. O restante
deste documento apresenta o leitor a:</p>
<ul>
  <li>Componentes fundamentais de estrutura que definem o aplicativo.</li>
  <li>O arquivo de manifesto em que os componentes so declarados e os recursos de dispositivo necessrios
ao aplicativo.</li>
  <li>Recursos separados do cdigo do aplicativo que permitem
otimizar o comportamento de uma variedade de configuraes de dispositivo.</li>
</ul>


<h2 id="Components">Componentes de aplicativo</h2>

<p>Os componentes de aplicativo so os blocos de construo fundamentais de um aplicativo do Android.
Cada componente  um ponto diferente pelo qual o sistema pode entrar no aplicativo. Nem todos
os componentes so pontos de entrada reais para o usurio e alguns dependem uns dos outros, mas cada um existe
como uma entidade independente e desempenha uma funo especfica &mdash; cada um  um bloco de construo exclusivo
que ajuda a definir o comportamento geral do aplicativo.</p>

<p>H quatro tipos diferentes de componentes de aplicativo. Cada tipo tem uma finalidade distinta
e tem um ciclo de vida especfico que define a forma pela qual o componente  criado e destrudo.</p>

<p>A seguir apresentam-se os quatro tipos de componentes de aplicativos:</p>

<dl>

<dt><b>Atividades</b></dt>

<dd>As <i>atividades</i> representam uma tela nica com uma interface do usurio. Por exemplo:
um aplicativo de e-mails pode ter uma atividade que mostra uma lista de novos
e-mails, outra atividade que compe um e-mail e outra ainda que l e-mails. Embora
essas atividades funcionem juntas para formar uma experincia de usurio coesa no aplicativo de e-mails,
elas so independentes entre si. Portanto, um aplicativo diferente pode iniciar qualquer uma
dessas atividades (se o aplicativo de e-mails permitir). Por exemplo: um aplicativo de cmera pode iniciar
a atividade no aplicativo de e-mail que compe o novo e-mail para que o usurio compartilhe uma foto.

<p>Uma atividade  implementada como uma subclasse de {@link android.app.Activity}  saiba mais sobre isso
no guia do desenvolvedor
<a href="{@docRoot}guide/components/activities.html">Atividades</a>.</p>
</dd>


<dt><b>Servios</b></dt>

<dd>Os <i>servios</i> so componentes executados em segundo plano para realizar operaes
de execuo longa ou para realizar trabalho para processos remotos. Eles
no apresentam uma interface do usurio. Por exemplo: um servio pode tocar msica em segundo plano
enquanto o usurio est em um aplicativo diferente ou buscar dados na rede sem bloquear
a interao do usurio com uma atividade. Outro componente, como uma atividade, pode iniciar
o servio e deix-lo executar ou vincular-se a ele para interagir.

<p>Um servio  implementado como uma subclasse de {@link android.app.Service}  saiba mais sobre isso
no guia do desenvolvedor
<a href="{@docRoot}guide/components/services.html">Servios</a>.</p>
</dd>


<dt><b>Provedores de contedo</b></dt>

<dd>Os <i>provedores de contedo</i> gerenciam um conjunto compartilhado de dados do aplicativo.  possvel armazenar os dados
no sistema de arquivos, em um banco de dados SQLite ou em qualquer local de armazenamento persistente
que o aplicativo possa acessar. Por meio do provedor de contedo, outros aplicativos podem consultar ou at modificar
os dados (se o provedor de contedo permitir). Por exemplo: o sistema Android oferece um provedor
de contedo que gerencia as informaes de contato do usurio. Assim, qualquer aplicativo
com as permisses adequadas pode consultar parte do provedor de contedo (como {@link
android.provider.ContactsContract.Data}) para ler e gravar informaes sobre uma pessoa especfica.

<p>Os provedores de contedo so teis para ler e gravar dados privados
no aplicativo e no compartilhados. Por exemplo: o exemplo de aplicativo <a href="{@docRoot}resources/samples/NotePad/index.html">Note Pad</a> usa
um provedor de contedo para salvar notas.</p>

<p>Um provedor de contedo  implementado como uma subclasse de {@link android.content.ContentProvider}
e precisa implementar um conjunto padro de APIs que permitem a outros aplicativos
realizar transaes. Para obter mais informaes, consulte o guia de desenvolvedor
<a href="{@docRoot}guide/topics/providers/content-providers.html">Provedores de contedo</a>.</p>
</dd>


<dt><b>Receptores de transmisso</b></dt>

<dd>Os <i>receptores de transmisso</i> so componentes que respondem a anncios de transmisso
por todo o sistema.  Muitas transmisses se originam do sistema &mdash; por exemplo, uma transmisso que anuncia
que uma tela foi desligada, a bateria est baixa ou uma tela foi capturada.
Os aplicativos tambm podem iniciar transmisses &mdash; por exemplo, para comunicar a outros dispositivos
que alguns dados foram baixados no dispositivo e esto disponveis para uso. Embora os receptores
de transmisso no exibam nenhuma interface do usurio, eles podem <a href="{@docRoot}guide/topics/ui/notifiers/notifications.html">criar uma notificao na barra de status</a>
para alertar ao usurio quando ocorre uma transmisso. Mais comumente, no entanto, um receptor de transmisso
 somente um "portal" para outros componentes e realiza uma quantidade mnima de trabalho. Por
exemplo: ele pode iniciar um servio para executar um trabalho baseado no evento.

<p>Os receptores de transmisso so implementados como subclasses de {@link android.content.BroadcastReceiver}
e cada transmisso  entregue como um objeto {@link android.content.Intent}. Para obter mais informaes,
consulte a classe {@link android.content.BroadcastReceiver}.</p>
</dd>

</dl>


<p>Um aspecto exclusivo do projeto do sistema Android  que qualquer aplicativo pode iniciar
um componente de outro aplicativo. Por exemplo: se voc quiser que o usurio capture
uma foto com a cmera do dispositivo, provavelmente haver outro aplicativo que faz isso
e o seu aplicativo poder us-lo, ou seja, no ser necessrio desenvolver uma atividade para capturar uma foto. No
necessrio incorporar nem mesmo vincul-lo do aplicativo da cmera ao cdigo.
Em vez disso, basta iniciar a atividade no aplicativo da cmera que captura
uma foto. Quando concluda, a foto at retorna ao aplicativo em questo para ser usada. Para o usurio,
parece que a cmera  realmente parte do aplicativo.</p>

<p>Quando o sistema inicia um componente, ele inicia o processo daquele aplicativo (se ele j
no estiver em execuo) e instancia as classes necessrias para o componente. Por exemplo: se o aplicativo
iniciar a atividade no aplicativo da cmera que captura uma foto, aquele aplicativo
 executado no processo que pertence ao aplicativo da cmera e no no processo do aplicativo.
Portanto, ao contrrio dos aplicativos na maioria dos outros sistemas, os aplicativos do Android no tm um ponto
de entrada nico (no h a funo {@code main()}, por exemplo).</p>

<p>Como o sistema executa cada aplicativo em um processo separado com permisses de arquivo
que restringem o acesso a outros aplicativos, o aplicativo no pode ativar diretamente um componente
a partir de outro aplicativo. No entanto, o sistema Android pode. Portanto, para ativar um componente
em outro aplicativo,  preciso enviar uma mensagem ao sistema que especifique a <em>inteno</em>
de iniciar um componente especfico. Em seguida, o sistema ativa o componente.</p>


<h3 id="ActivatingComponents">Ativao de componentes</h3>

<p>Trs dos quatro tipos de componente &mdash; atividades, servios
e receptores de transmisso &mdash; so ativados por uma mensagem assncrona chamada <em>inteno</em>.
As intenes vinculam componentes individuais entre si em tempo de execuo (como
mensageiros que solicitam uma ao de outros componentes), seja o componente pertencente
ao aplicativo ou no.</p>

<p>A inteno  criada com um objeto {@link android.content.Intent}, que define uma mensagem
para ativar um componente especfico ou um <em>tipo</em> especfico de componente &mdash; as intenes
podem ser explcitas ou implcitas, respectivamente.</p>

<p>Para atividades e servios, as intenes definem a ao a executar (por exemplo, "exibir" ou
"enviar" algo) e podem especificar a URI dos dados usados na ao (entre outras coisas
que o componente a iniciar precisa saber). Por exemplo: uma inteno pode transmitir uma solicitao
de uma atividade para exibir uma imagem ou abrir uma pgina da web. Em alguns casos,  preciso iniciar
uma atividade para receber um resultado; nesse caso, a atividade tambm retorna
o resultado em um {@link android.content.Intent} (por exemplo,  possvel emitir uma inteno para
que o usurio selecione um contato pessoal e o retorne a voc &mdash; a inteno de retorno contm
uma URI que aponta para o contato selecionado).</p>

<p>Para receptores de transmisso, a inteno simplesmente define
o anncio que est sendo transmitido (por exemplo, uma transmisso para indicar que a bateria do dispositivo est acabando
contm uma string de ao conhecida que indica "nvel baixo da bateria").</p>

<p>O outro tipo de componente, o provedor de contedo, no  ativado por intenes. Em vez disso,
ele  ativado por uma solicitao de um {@link android.content.ContentResolver}. O resolvedor
de contedo manipula todas as transaes diretas com o provedor de contedo para que o componente
que executa as transaes com o provedor no precise e, em vez disso, chama os mtodos no objeto {@link
android.content.ContentResolver}. Isso deixa uma camada de abstrao entre o provedor
de contedo e o componente que solicita informaes (por segurana).</p>

<p>H dois mtodos separados para ativar cada tipo de componente:</p>
<ul>
  <li> possvel iniciar uma atividade (ou dar-lhe algo novo para fazer)
passando uma {@link android.content.Intent} a {@link android.content.Context#startActivity
startActivity()} ou {@link android.app.Activity#startActivityForResult startActivityForResult()}
(para que, quando desejado, a atividade retorne um resultado).</li>
  <li> possvel iniciar um dispositivo (ou dar novas instrues a um servio em andamento)
passando uma {@link android.content.Intent} a {@link android.content.Context#startService
startService()}. Ou ento,  possvel vincular ao servio passando uma{@link android.content.Intent}
a {@link android.content.Context#bindService bindService()}.</li>
  <li> possvel iniciar uma transmisso passando uma{@link android.content.Intent} a mtodos como
{@link android.content.Context#sendBroadcast(Intent) sendBroadcast()}, {@link
android.content.Context#sendOrderedBroadcast(Intent, String) sendOrderedBroadcast()} ou {@link
android.content.Context#sendStickyBroadcast sendStickyBroadcast()}.</li>
  <li> possvel iniciar uma consulta a um provedor de contedo chamando {@link
android.content.ContentProvider#query query()} em um {@link android.content.ContentResolver}.</li>
</ul>

<p>Para obter mais informaes sobre intenes, consulte o documento
<a href="{@docRoot}guide/components/intents-filters.html">Intenes e filtros de intenes</a>. Veja mais informaes sobre a ativao de componentes especficos
nos seguintes documentos: <a href="{@docRoot}guide/components/activities.html">Atividades</a>, <a href="{@docRoot}guide/components/services.html">Servios</a>, {@link
android.content.BroadcastReceiver} e <a href="{@docRoot}guide/topics/providers/content-providers.html">Provedores de contedo</a>.</p>


<h2 id="Manifest">O arquivo de manifesto</h2>

<p>Antes de o sistema Android iniciar um componente de aplicativo,  preciso ler o arquivo {@code AndroidManifest.xml}
(o arquivo de "manifesto")
do aplicativo para que o sistema saiba se o componente existe. O aplicativo precisa declarar todos os seus componentes nesse arquivo, que deve estar na raiz
do diretrio do projeto do aplicativo.</p>

<p>O manifesto faz outras coisas alm de declarar os componentes do aplicativo,
por exemplo:</p>
<ul>
  <li>Identifica todas as permisses do usurio de que o aplicativo precisa, como acesso  internet
ou acesso de somente leitura aos contatos do usurio.</li>
  <li>Declara o <a href="{@docRoot}guide/topics/manifest/uses-sdk-element.html#ApiLevels">nvel de API</a> mnimo
exigido pelo aplicativo com base nas APIs que o aplicativo usa.</li>
  <li>Declara os recursos de hardware e software usados ou exigidos pelo aplicativo, como cmera,
servios de bluetooth ou tela multitoque.</li>
  <li>As bibliotecas de API s quais o aplicativo precisa vincular-se (outras alm das APIs
de estrutura do Android), como a <a href="http://code.google.com/android/add-ons/google-apis/maps-overview.html">biblioteca
Google Maps</a>.</li>
  <li>E outros.</li>
</ul>


<h3 id="DeclaringComponents">Declarao de componentes</h3>

<p>A principal tarefa do manifesto  informar ao sistema os componentes do aplicativo. Por
exemplo: um arquivo de manifesto pode declarar uma atividade da seguinte forma: </p>

<pre>
&lt;?xml version="1.0" encoding="utf-8"?&gt;
&lt;manifest ... &gt;
    &lt;application android:icon="@drawable/app_icon.png" ... &gt;
        &lt;activity android:name="com.example.project.ExampleActivity"
                  android:label="@string/example_label" ... &gt;
        &lt;/activity&gt;
        ...
    &lt;/application&gt;
&lt;/manifest&gt;</pre>

<p>No elemento <code><a
href="{@docRoot}guide/topics/manifest/application-element.html">&lt;application&gt;</a></code>
, o atributo {@code android:icon} aponta para recursos de um cone que identifica
o aplicativo.</p>

<p>No elemento <code><a
href="{@docRoot}guide/topics/manifest/activity-element.html">&lt;activity&gt;</a></code>,
o atributo {@code android:name} especifica o nome da classe totalmente qualificada da subclasse de {@link
android.app.Activity} e o atributo {@code android:label} especifica uma string
a usar como a etiqueta da atividade visvel ao usurio.</p>

<p> preciso declarar todos os componentes desta forma:</p>
<ul>
  <li>Elementos <code><a
href="{@docRoot}guide/topics/manifest/activity-element.html">&lt;activity&gt;</a></code>
para atividades</li>
  <li>Elementos <code><a
href="{@docRoot}guide/topics/manifest/service-element.html">&lt;service&gt;</a></code>
para servios</li>
  <li>Elementos <code><a
href="{@docRoot}guide/topics/manifest/receiver-element.html">&lt;receiver&gt;</a></code>
para receptores de transmisso</li>
  <li>Elementos <code><a
href="{@docRoot}guide/topics/manifest/provider-element.html">&lt;provider&gt;</a></code>
para provedores de contedo</li>
</ul>

<p>Atividades, servios e provedores de contedo includos na fonte, mas no declarados
no manifesto, no ficam visveis para o sistema e, consequentemente, podem no ser executados.  No entanto, receptores
de transmisso
podem ser declarados no manifesto dinamicamente no cdigo (como objetos
{@link android.content.BroadcastReceiver}) e registrados no sistema chamando-se
{@link android.content.Context#registerReceiver registerReceiver()}.</p>

<p>Para obter mais informaes sobre a estrutura do arquivo de manifesto de aplicativos, consulte a documentao
<a href="{@docRoot}guide/topics/manifest/manifest-intro.html">O arquivo AndroidManifest.xml</a>. </p>


<h3 id="DeclaringComponentCapabilities">Declarao de recursos de componentes</h3>

<p>Conforme abordado acima, em <a href="#ActivatingComponents">Ativao de componentes</a>,  possvel usar
uma {@link android.content.Intent} para iniciar atividades, servios e receptores de transmisso. Isso pode ser feito
nomeando-se explicitamente o componente-alvo (usando o nome da classe do componente) na inteno. No entanto,
a verdadeira fora das intenes reside no conceito de <em>intenes implcitas</em>. As intenes implcitas
descrevem simplesmente o tipo de ao a executar (e, opcionalmente, os dados em que
a ao deve ser executada) e permitem ao sistema encontrar e iniciar um componente no dispositivo que pode executar
a ao. Se houver mais de um componente que possa executar a ao descrita
pela inteno, o usurio selecionar qual deles usar.</p>

<p>Para o sistema identificar os componentes que podem responder a uma inteno, compara-se
a inteno recebida com os <i>filtros de intenes</i> fornecidos no arquivo de manifesto de outros aplicativos
do dispositivo.</p>

<p>Ao declarar uma atividade no manifesto do aplicativo, pode-se incluir
filtros de intenes que declarem os recursos da atividade para que ela responda
a intenes de outros aplicativos. Para declarar um filtro de intenes no componentes,
adiciona-se um elemento <a href="{@docRoot}guide/topics/manifest/intent-filter-element.html">{@code
&lt;intent-filter&gt;}</a> como filho do elemento de declarao do componente.</p>

<p>Por exemplo: se voc estiver programando um aplicativo de e-mail com uma atividade de compor um novo e-mail,
 possvel declarar um filtro de intenes para responder a intenes "enviar" (para enviar um novo e-mail), assim:</p>
<pre>
&lt;manifest ... >
    ...
    &lt;application ... &gt;
        &lt;activity android:name="com.example.project.ComposeEmailActivity">
            &lt;intent-filter>
                &lt;action android:name="android.intent.action.SEND" />
                &lt;data android:type="*/*" />
                &lt;category android:name="android.intent.category.DEFAULT" />
            &lt;/intent-filter>
        &lt;/activity>
    &lt;/application&gt;
&lt;/manifest>
</pre>

<p>Em seguida, se outro aplicativo criar uma inteno com a ao {@link
android.content.Intent#ACTION_SEND} e pass-la para {@link android.app.Activity#startActivity
startActivity()}, o sistema poder iniciar a atividade de forma que o usurio possa rascunhar e enviar
um e-mail.</p>

<p>Para obter mais informaes sobre filtros de intenes, consulte o documento <a href="{@docRoot}guide/components/intents-filters.html">Intenes e filtros de intenes</a>.
</p>


<h3 id="DeclaringRequirements">Declarao de requisitos do aplicativo</h3>

<p>Existem vrios dispositivos desenvolvidos para Android e nem todos apresentam os mesmos
recursos e caractersticas. Para evitar que o aplicativo seja instalado em dispositivos
que no contenham os recursos que o aplicativo necessita,  importante definir um perfil
para os tipos de dispositivo compatveis com o aplicativo.  preciso declarar os requisitos de dispositivo e software
no arquivo de manifesto. A maior parte dessas declaraes  somente informativa e o sistema no as l,
mas servios externos, como o Google Play, as leem para oferecer uma filtragem
aos usurios quando buscam esses aplicativos para seu dispositivo.</p>

<p>Por exemplo: se o aplicativo exige uma cmera e usa APIs introduzidas no Android 2.1 (<a href="{@docRoot}guide/topics/manifest/uses-sdk-element.html#ApiLevels">API de nvel</a> 7),
deve-se declarar esses requisitos no arquivo de manifesto da seguinte forma:</p>

<pre>
&lt;manifest ... >
    &lt;uses-feature android:name="android.hardware.camera.any"
                  android:required="true" />
    &lt;uses-sdk android:minSdkVersion="7" android:targetSdkVersion="19" />
    ...
&lt;/manifest>
</pre>

<p>Assim, dispositivos que <em>no</em> tenham cmera e tenham
verso Android <em>anterior</em> a 2.1 no podero instalar o aplicativo a partir do Google Play.</p>

<p>No entanto, tambm  possvel declarar que o aplicativo usa a cmera como recurso
<em>no obrigatrio</em>. Nesse caso, o aplicativo precisa definir o atributo <a href="{@docRoot}guide/topics/manifest/uses-feature-element.html#required">{@code required}</a>
 como {@code "false"} e verificar em tempo de execuo
se o dispositivo tem cmera e desativar os recursos da cmera conforme o necessrio.</p>

<p>Veja mais informaes sobre o gerenciamento da compatibilidade do aplicativo com diferentes dispositivos
no documento <a href="{@docRoot}guide/practices/compatibility.html">Compatibilidade
do dispositivo</a>.</p>


<h2 id="Resources">Recursos do aplicativo</h2>

<p>Os aplicativos Android so compostos por mais do que somente cdigos &mdash; eles requerem recursos
separados do cdigo-fonte, como imagens, arquivos de udio e tudo o que se relaciona
com a apresentao visual do aplicativo. Por exemplo: deve-se definir animaes, menus, estilos, cores
e o layout das interfaces do usurio da atividade com arquivos XML. O uso de recursos de aplicativo facilita
a atualizao de diversas caractersticas do aplicativo sem a necessidade de modificar
o cdigo e &mdash; fornecendo conjuntos de recursos alternativos &mdash; permite otimizar o aplicativo
para diversas configuraes de dispositivo (como idiomas e tamanhos de tela diferentes).</p>

<p>Para todo recurso includo no projeto Android, as ferramentas de programao SDK definem
um ID inteiro exclusivo que o programador pode usar para referenciar o recurso do cdigo do aplicativo
ou de outros recursos definidos no XML. Por exemplo: se o aplicativo contiver um arquivo de imagem de nome {@code
logo.png} (salvo no diretrio {@code res/drawable/}), as ferramentas de SDK geraro um ID de recurso
chamado {@code R.drawable.logo}, que pode ser usado para referenciar a imagem e inseri-la
na interface do usurio.</p>

<p>Um dos aspectos mais importantes de fornecer recursos separados do cdigo-fonte
 a capacidade de fornecer recursos alternativos para diferentes configuraes
de dispositivo. Por exemplo: ao definir strings de IU em XML,  possvel converter as strings em outros
idiomas e salv-las em arquivos separados. Em seguida, com base em um <em>qualificador</em> de idioma
acrescentado ao nome do diretrio do recurso (como {@code res/values-fr/} para valores
de string em francs) e a configurao de idioma do usurio, o sistema Android aplica as strings de idioma adequadas
 IU.</p>

<p>O Android aceita vrios <em>qualificadores</em> para recursos alternativos. O qualificador
 uma string curta includa no nome dos diretrios de recurso para definir
a configurao de dispositivo em que esses recursos sero usados. Outro exemplo:
deve-se criar diferentes layouts para as atividades conforme a orientao
e o tamanho da tela do dispositivo. Por exemplo: quando a tela do dispositivo est em orientao
retrato (vertical), pode ser desejvel um layout com botes na vertical, mas, quando a tela est em orientao
paisagem (horizontal), os botes devem estar alinhados horizontalmente. Para alterar o layout
conforme a orientao, pode-se definir dois layouts diferentes e aplicar o qualificador
adequado ao nome do diretrio de cada layout. Em seguida, o sistema aplica automaticamente o layout adequado
conforme a orientao atual do dispositivo.</p>

<p>Para obter mais informaes sobre os diferentes tipos de recursos a incluir no aplicativo
e como criar recursos alternativos para diferentes configuraes de dispositivo, leia <a href="{@docRoot}guide/topics/resources/providing-resources.html">Como fornecer recursos</a>.</p>


<div class="next-docs">
<div class="col-6">
  <h2 class="norule">Continue lendo sobre:</h2>
  <dl>
    <dt><a href="{@docRoot}guide/components/intents-filters.html">Intenes e filtros de intenes</a>
    </dt>
    <dd>Informaes sobre o uso de APIs {@link android.content.Intent} para
ativar componentes de aplicativos, como atividades e servios, e como disponibilizar componentes
de aplicativo para uso em outros aplicativos.</dd>
    <dt><a href="{@docRoot}guide/components/activities.html">Atividades</a></dt>
    <dd>Informaes sobre a criao de uma instncia da classe {@link android.app.Activity},
que permite uma tela diferente no aplicativo com uma interface do usurio.</dd>
    <dt><a href="{@docRoot}guide/topics/resources/providing-resources.html">Como fornecer recursos</a></dt>
    <dd>Informaes sobre a estrutura de aplicativos Android para recursos de aplicativo separados do cdigo-fonte
, inclusive como fornecer recursos alternativos para configuraes
de dispositivo especficas.
    </dd>
  </dl>
</div>
<div class="col-6">
  <h2 class="norule">Voc tambm pode se interessar por:</h2>
  <dl>
    <dt><a href="{@docRoot}guide/practices/compatibility.html">Compatibilidade do dispositivo</a></dt>
    <dd>Informaes sobre como o Android funciona em diferentes tipos de dispositivo e uma introduo
a como otimizar o aplicativo para cada dispositivo ou restringir a disponibilidade
a diferentes dispositivos.</dd>
    <dt><a href="{@docRoot}guide/topics/security/permissions.html">Permisses do sistema</a></dt>
    <dd>Informaes sobre como o aplicativo restringe o acesso do Android a determinadas APIs sem um
sistema de permisso que exija o consentimento do usurio para que o aplicativo use essas APIs.</dd>
  </dl>
</div>
</div>