xref: /frameworks/base/docs/html-intl/intl/pt-br/guide/components/tasks-and-back-stack.jd

page.title=Tarefas e pilhas de retorno
parent.title=Atividades
parent.link=activities.html
@jd:body

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

<h2>Neste documento</h2>
<ol>
<li><a href="#ActivityState">Gravao do estado da atividade</a></li></li>
<li><a href="#ManagingTasks">Gerenciamento de tarefas</a>
  <ol>
    <li><a href="#TaskLaunchModes">Definio de modos de inicializao</a></li>
    <li><a href="#Affinities">Tratamento de afinidades</a></li>
    <li><a href="#Clearing">Apagar a pilha de retorno</a></li>
    <li><a href="#Starting">Incio de uma tarefa</a></li>
  </ol>
</li>
</ol>

<h2>Artigos</h2>
<ol>
  <li><a href="http://android-developers.blogspot.com/2010/04/multitasking-android-way.html">
  Multitarefa do modo Android</a></li>
</ol>

<h2>Veja tambm</h2>
<ol>
  <li><a href="{@docRoot}design/patterns/navigation.html">Projeto para Android:
Navegao</a></li>
  <li><a href="{@docRoot}guide/topics/manifest/activity-element.html">Elemento de manifesto
{@code &lt;activity&gt;}</a></li>
  <li><a href="{@docRoot}guide/components/recents.html">Tela de viso geral</a></li>
</ol>
</div>
</div>


<p>Os aplicativos normalmente contm diversas <a href="{@docRoot}guide/components/activities.html">atividades</a>. Cada atividade
deve ser projetada com relao a tipos especficos de aes que o usurio pode realizar e que podem iniciar outras
atividades. Por exemplo: um aplicativo de e-mail pode ter uma atividade para exibir uma lista de novas mensagens.
Quando o usurio seleciona uma mensagem, uma nova atividade abre para exibir essa mensagem.</p>

<p>As atividades podem tambm iniciar atividades existentes em outros aplicativos no dispositivo. Por
exemplo: se o seu aplicativo deseja enviar um e-mail,  possvel definir uma inteno para realizar
uma ao de "enviar" e incluir alguns dados, como um endereo de e-mail e uma mensagem. Uma atividade de outro
aplicativo que se declara para tratar deste tipo de intenes, ento, abre-se. Nesse caso, a inteno
destina-se ao envio de e-mails, portanto inicia-se uma atividade de composio" do aplicativo de e-mail (se diversas atividades
forem compatveis com a mesma inteno, o sistema permitir que o usurio selecione qual usar). Quando o e-mail 
enviado, sua atividade reinicia, parecendo que a atividade de e-mail faz parte do seu aplicativo. Apesar
de as atividades serem de aplicativos diferentes, o Android mantm essa experincia
do usurio retilnea mantendo ambas as atividades na mesma <em>tarefa</em>.</p>

<p>Tarefas so colees de atividades com as quais os usurios interagem
ao realizar determinado trabalho. As atividades so organizadas em uma pilha (a <em>pilha de retorno</em>)
na ordem em que cada atividade  aberta.</p>

<!-- SAVE FOR WHEN THE FRAGMENT DOC IS ADDED
<div class="sidebox-wrapper">
<div class="sidebox">
<h3>Adding fragments to a task's back stack</h3>

<p>Your activity can also include {@link android.app.Fragment}s to the back stack. For example,
suppose you have a two-pane layout using fragments, one of which is a list view (fragment A) and the
other being a layout to display an item from the list (fragment B). When the user selects an item
from the list, fragment B is replaced by a new fragment (fragment C). In this case, it might be
desireable for the user to navigate back to reveal fragment B, using the <em>Back</em> button.</p>
<p>In order to add fragment B to the back stack so that this is possible, you must call {@link
android.app.FragmentTransaction#addToBackStack addToBackStack()} before you {@link
android.app.FragmentTransaction#commit()} the transaction that replaces fragment B with fragment
C.</p>
<p>For more information about using fragments and adding them to the back stack, see the {@link
android.app.Fragment} class documentation.</p>

</div>
</div>
-->

<p>A tela inicial do dispositivo  o ponto de partida para a maioria das tarefas. Quando o usurio toca em um cone no inicializador do 
aplicativo
 (ou em um atalho na tela inicial), essa tarefa do aplicativo acontece em primeiro plano. Se no
existir nenhuma tarefa para o aplicativo (se o aplicativo no tiver sido usado recentemente), uma nova tarefa
ser criada e a atividade "principal" daquele aplicativo abrir como a atividade raiz na pilha.</p>

<p>Quando a atividade atual inicia outra, a nova atividade  colocada no topo da pilha
e recebe foco. A atividade anterior permanece na pilha, mas  interrompida. Quando uma atividade
para, o sistema retm o estado atual da interface do usurio. Quando o usurio pressiona o boto 
<em>Voltar</em>
, a atividade atual  retirada do topo da pilha (a atividade  destruda)
e a atividade anterior reinicia (o estado anterior da IU  restaurado). Atividades na pilha nunca
so reorganizadas, somente colocadas e retiradas da pilha &mdash; colocadas na pilha quando iniciadas
pela atividade atual e retiradas quando o usurio se retira dela usando o boto <em>Voltar</em>. Desse modo, a pilha
de retorno
opera como uma estrutura de objeto UEPS (ltimo que entra, primeiro que sai). A figura 1
ilustra esse comportamento com uma linha cronolgica exibindo o progresso entre atividades junto com a pilha de retorno
atual em cada ponto no tempo.</p>

<img src="{@docRoot}images/fundamentals/diagram_backstack.png" alt="" />
<p class="img-caption"><strong>Figura 1.</strong> Representao de como cada nova atividade
em uma tarefa adiciona um item  pilha de retorno. Quando o usurio pressiona o boto <em>Voltar</em>,
a atividade atual 
destruda e a atividade anterior reinicia.</p>


<p>Se o usurio continua pressionando <em>Voltar</em>, cada atividade na pilha  retirada para 
revelar
a anterior at que o usurio retorne  tela inicial (ou a qualquer atividade que estivesse em execuo
no comeo da tarefa). Quando todas as atividades forem removidas da pilha, a tarefa no existir mais.</p>

<div class="figure" style="width:287px">
<img src="{@docRoot}images/fundamentals/diagram_multitasking.png" alt="" /> <p
class="img-caption"><strong>Figura 2.</strong> Duas tarefas: a tarefa B recebe a interao do usurio
em primeiro plano enquanto a tarefa A est em segundo plano aguardando para ser retomada.</p>
</div>
<div class="figure" style="width:215px">
  <img src="{@docRoot}images/fundamentals/diagram_multiple_instances.png" alt="" /> <p
class="img-caption"><strong>Figura 3.</strong> Uma nica atividade  instanciada diversas vezes.</p>
</div>

<p>As tarefas so unidades coesas que podem mover-se para "segundo plano" quando usurio inicia uma nova tarefa
ou ir para a tela inicial por meio do boto <em>Pgina inicial</em>. Quando em segundo plano, todas as atividades
da tarefa so
interrompidas, mas a pilha de retorno das tarefas continua intacta &mdash; a tarefa simplesmente perdeu o foco,
que foi para outra tarefa, como ilustrado na figura 2. Uma tarefa pode, ento, retornar ao "primeiro plano" para que os usurios
continuem de onde pararam. Suponha, por exemplo, que a tarefa atual (tarefa A) tenha trs
atividades na sua pilha &mdash; duas sob a atividade atual. O usurio pressiona o boto <em>Pgina inicial</em> e,
em seguida,
inicia um novo aplicativo no inicializador do aplicativo. Quando a tela inicial aparece, a tarefa A
vai para segundo plano. Quando o novo aplicativo inicia, o sistema inicia uma tarefa para este aplicativo
(tarefa B) com sua prpria pilha de atividades. Aps interagir
com este aplicativo, o usurio retorna  Pgina inicial novamente e seleciona o aplicativo que originalmente
iniciou a tarefa A. Agora, a tarefa A fica
em primeiro plano &mdash; todas as trs atividades nas pilhas esto intactas e a atividade no topo
da pilha reinicia. Nesse
momento, o usurio pode alternar para a tarefa B acessando a Pgina inicial e selecionando o cone do aplicativo
que iniciou essa tarefa (ou selecionando a tarefa do aplicativo
na <a href="{@docRoot}guide/components/recents.html">tela de viso geral</a>).
Esse  um exemplo de multitarefas no Android.</p>

<p class="note"><strong>Observao:</strong> vrias tarefas podem ser mantidas em segundo plano simultaneamente.
Contudo, se o usurio estiver executando diversas tarefas em segundo plano ao mesmo tempo, o sistema pode comear
a destruir atividades de segundo plano para recuperar memria, fazendo com que o estado das atividades seja perdido.
Consulte a seo a seguir sobre <a href="#ActivityState">Estado de atividades</a>.</p>

<p>Como as atividades na pilha de retorno nunca so reorganizadas, se o seu aplicativo permitir que
usurios iniciem uma determinada atividade a partir de mais de uma atividade, uma nova instncia
dela ser criada e colocada na pilha (em vez de trazer qualquer instncia anterior
dela para o topo). Assim, uma atividade no aplicativo pode ser instanciada diversas
vezes (mesmo a partir de diferentes tarefas), como ilustrado na figura 3. Assim, se o usurio navegar inversamente
usando o boto <em>Voltar</em>, as instncias da atividade sero revelada na ordem em que foram
abertas (cada uma
com o prprio estado da IU). No entanto,  possvel modificar esse comportamento se voc no deseja que uma atividade seja
instanciada mais de uma vez. Esse assunto  abordado na prxima seo sobre <a href="#ManagingTasks">Gerenciamento de tarefas</a>.</p>


<p>Para resumir o comportamento padro de atividades e tarefas:</p>

<ul>
  <li>Quando a atividade A inicia a atividade B, a atividade A  interrompida, mas o sistema retm seu estado
(como posio de rolagem e texto inserido em formulrios).
Se o usurio pressionar o boto <em>Voltar</em> na atividade B, a atividade A reiniciar com seu estado
restaurado.</li>
  <li>Quando o usurio se retira de uma tarefa pressionando o boto <em>Pgina inicial</em>, a atividade atual 
interrompida
e sua tarefa fica em segundo plano. O sistema retm o estado de cada atividade na tarefa. Se,
mais tarde, o usurio reiniciar a tarefa selecionando o cone de inicializao que a inicia, ela ficar
em primeiro plano e reiniciar a atividade no topo da pilha.</li>
  <li>Se o usurio pressionar o boto <em>Voltar</em>, a atividade atual ser retirada da pilha
e
destruda. A atividade anterior na pilha  retomada. Quando uma atividade  destruda, o sistema
<em>no</em> retm seu estado.</li>
  <li>As atividades podem ser instanciadas diversas vezes mesmo a partir de outras tarefas.</li>
</ul>


<div class="note design">
<p><strong>Projeto de navegao</strong></p>
  <p>Para saber mais sobre o funcionamento da navegao de aplicativos no Android, leia o guia <a href="{@docRoot}design/patterns/navigation.html">Navegao</a> do Projeto do Android.</p>
</div>


<h2 id="ActivityState">Gravao do estado da atividade</h2>

<p>Como discutido acima, o comportamento padro do sistema preserva o estado de uma atividade quando ela 
interrompida. Desse modo, quando usurios navegam inversamente a uma atividade anterior, a interface do usurio aparece
na forma em que foi deixada. Entretanto,  possvel &mdash; e <strong>recomendvel</strong> &mdash; reter proativamente
o estado das atividades usando mtodos de retorno de chamada nos casos em que a atividade  destruda e deve
ser recriada.</p>

<p>Quando o sistema interrompe uma das atividades (como quando uma nova atividade inicia ou a tarefa
se move para segundo plano), o sistema pode destruir esta atividade completamente se precisar recuperar
a memria do sistema. Quando isso ocorre, as informaes sobre o estado da atividade so perdidas. Se isso acontecer,
o sistema ainda
saber que a atividade tem um lugar na pilha de retorno, mas quando a atividade for levada
ao topo da pilha, o sistema precisar recri-la (em vez de reinici-la). Para
evitar perder o trabalho do usurio, deve-se ret-la proativamente implementando
mtodos de retorno de chamada {@link android.app.Activity#onSaveInstanceState onSaveInstanceState()}
na atividade.</p>

<p>Para obter mais informaes sobre a gravao do estado da atividade, consulte o documento
<a href="{@docRoot}guide/components/activities.html#SavingActivityState">Atividades</a>.</p>



<h2 id="ManagingTasks">Gerenciamento de tarefas</h2>

<p>O modo com que o Android gerencia tarefas e a pilha de retorno, como descrito abaixo &mdash; posicionando todas
as atividades iniciadas em sucesso na mesma tarefa em uma pilha UEPS (ltimo que entra, primeiro que sai) &mdash; funciona
muito bem para a maioria dos aplicativo e no  preciso preocupar-se com a associao das atividades
a tarefas ou como elas esto organizadas na pilha de retorno. No entanto, pode-se decidir interromper
o comportamento normal. Talvez voc deseje que uma atividade inicie uma nova tarefa no aplicativo ao ser
iniciada (em vez de ser colocada dentro da tarefa atual); ou, quando voc inicia uma atividade, deseja
apresentar uma instncia dela existente (em vez de criar uma nova
instncia no topo da pilha de retorno); ou talvez voc deseje que a pilha apague
todas as atividades, exceto a atividade raiz, quando o usurio sai da tarefa.</p>

<p> possvel fazer tudo isso e muito mais com atributos
no elemento <a href="{@docRoot}guide/topics/manifest/activity-element.html">{@code &lt;activity&gt;}</a> do manifesto
 e com sinalizadores na inteno passada
a {@link android.app.Activity#startActivity startActivity()}.</p>

<p>Com relao a isso, os principais atributos <a href="{@docRoot}guide/topics/manifest/activity-element.html">
{@code &lt;activity&gt;}</a> que podem ser usados so:</p>

<ul class="nolist">
  <li><a href="{@docRoot}guide/topics/manifest/activity-element.html#aff">
  {@code taskAffinity}</a></li>
  <li><a href="{@docRoot}guide/topics/manifest/activity-element.html#lmode">
  {@code launchMode}</a></li>
  <li><a href="{@docRoot}guide/topics/manifest/activity-element.html#reparent">
  {@code allowTaskReparenting}</a></li>
  <li><a href="{@docRoot}guide/topics/manifest/activity-element.html#clear">
  {@code clearTaskOnLaunch}</a></li>
  <li><a href="{@docRoot}guide/topics/manifest/activity-element.html#always">
  {@code alwaysRetainTaskState}</a></li>
  <li><a href="{@docRoot}guide/topics/manifest/activity-element.html#finish">
  {@code finishOnTaskLaunch}</a></li>
</ul>

<p>E os principais sinalizadores de inteno que podem ser usados so:</p>

<ul class="nolist">
  <li>{@link android.content.Intent#FLAG_ACTIVITY_NEW_TASK}</li>
  <li>{@link android.content.Intent#FLAG_ACTIVITY_CLEAR_TOP}</li>
  <li>{@link android.content.Intent#FLAG_ACTIVITY_SINGLE_TOP}</li>
</ul>

<p>Nas sees a seguir, voc ver como usar esses atributos de manifesto e sinalizadores
de inteno para definir como as atividades so associadas a tarefas e como elas se comportam na pilha de retorno.</p>

<p>Alm disso, so discutidas separadamente as consideraes sobre como tarefas e atividades podem ser representadas
e gerenciadas na tela de viso geral. Consulte <a href="{@docRoot}guide/components/recents.html">Tela de viso geral</a>
para obter mais informaes. Normalmente,  preciso permitir que o sistema defina como as tarefas
e as atividades so representadas na tela de viso geral e no  necessrio modificar esse comportamento.</p>

<p class="caution"><strong>Ateno:</strong> a maioria dos aplicativos no deve interromper o comportamento
padro de atividades e tarefas. Se voc determinar que  necessrio modificar os comportamentos padro
da atividade, seja prudente e certifique-se de testar a capacidade de uso da atividade durante
a inicializao e ao navegar de volta para ela de outras atividades e tarefas com o boto <em>Voltar</em>.
Certifique-se de testar os comportamentos de navegao que podem entrar em conflito com o comportamento esperado pelo usurio.</p>


<h3 id="TaskLaunchModes">Definio de modos de inicializao</h3>

<p>Os modos de inicializao permitem definir a forma com que uma nova instncia de uma atividade  associada
 tarefa atual. Pode-se definir diferentes modos de inicializao de duas maneiras:</p>
<ul class="nolist">
  <li><a href="#ManifestForTasks">Usando o arquivo de manifesto</a>
    <p>Ao declarar uma atividade em um arquivo de manifesto, pode-se especificar como a atividade
deve associar-se a tarefas quando ela inicia.</li>
  <li><a href="#IntentFlagsForTasks">Usando sinalizadores de inteno</a>
    <p>Ao chamar {@link android.app.Activity#startActivity startActivity()},
 possvel incluir um sinalizador na {@link android.content.Intent} que declara como
(ou se) a nova atividade deve associar-se  tarefa atual.</p></li>
</ul>

<p>Assim, se a atividade A iniciar a atividade B, a atividade B poder definir no manifesto como
deve associar-se  tarefa atual (se ocorrer) e a atividade A poder solicitar o modo pelo qual a atividade
B dever associar-se  tarefa atual. Se ambas as atividades definem como a atividade B
deve associar-se a uma tarefa, a solicitao da atividade A (como definido na inteno) sobrepe
a solicitao da atividade B (como definido no seu manifesto).</p>

<p class="note"><strong>Observao:</strong> Alguns modos de inicializao disponveis para o arquivo de manifesto
no esto disponveis como sinalizadores para uma inteno e, do mesmo modo, alguns modos de inicializao disponveis como sinalizadores
de uma inteno no podem ser definidos no manifesto.</p>


<h4 id="ManifestForTasks">Uso do arquivo de manifesto</h4>

<p>Ao declarar uma atividade no arquivo de manifesto, pode-se especificar como a atividade
deve associar-se a tarefas usando o atributo <a href="{@docRoot}guide/topics/manifest/activity-element.html#lmode">{@code
launchMode}</a> do elemento
<a href="{@docRoot}guide/topics/manifest/activity-element.html">{@code &lt;activity&gt;}</a>.</p>

<p>O atributo <a href="{@docRoot}guide/topics/manifest/activity-element.html#lmode">{@code
launchMode}</a> especifica uma instruo sobre como a atividade deve ser inicializada
em uma tarefa. H quatro modos diferentes de inicializao que podem ser designados ao atributo 
<code><a href="{@docRoot}guide/topics/manifest/activity-element.html#lmode">launchMode</a></code>:
</p>

<dl>
<dt>{@code "standard"} (o modo padro)</dt>
  <dd>Padro. O sistema cria uma nova instncia da atividade na tarefa
pela qual foi iniciada e encaminha-lhe a inteno. A atividade pode ser instanciada diversas vezes;
cada instncia pode pertencer a diferentes tarefas e uma tarefa pode ter diversas instncias.</dd>
<dt>{@code "singleTop"}</dt>
  <dd>Se uma instncia da atividade j existir no topo da tarefa atual, o sistema
encaminhar a inteno quela instncia por meio de uma chamada do mtodo {@link
android.app.Activity#onNewIntent onNewIntent()} em vez de criar uma nova instncia
da atividade. A atividade pode ser instanciada diversas vezes; cada instncia pode
pertencer a diferentes tarefas e uma tarefa pode ter diversas instncias (mas somente se
a atividade no topo da pilha de retorno <em>no</em> for uma instncia existente da atividade).
  <p>Por exemplo: suponhamos que uma pilha de retorno da tarefa consista na atividade raiz A com as atividades B, C e
D no topo (a pilha  A-B-C-D, com D no topo). Uma inteno chega de uma atividade de tipo D.
Se D for o modo de inicializao {@code "standard"} padro, uma nova instncia da classe ser inicializada
e a tarefa se tornar A-B-C-D-D. Entretanto, se o modo de inicializao de D for {@code "singleTop"}, a instncia existente
de D receber a inteno por {@link
android.app.Activity#onNewIntent onNewIntent()} porque ela est no topo da pilha &mdash;
a pilha permanece A-B-C-D. Contudo, se uma inteno chegar de uma atividade de tipo B, uma nova
instncia de B ser adicionada  pilha, mesmo que o modo de inicializao seja {@code "singleTop"}.</p>
  <p class="note"><strong>Observao:</strong> quando uma nova instncia de uma atividade  criada,
o usurio pode pressionar o boto <em>Voltar</em> para retornar  atividade anterior. Porm, quando uma
instncia
existente de uma atividade trata de uma nova inteno, o usurio no pode pressionar o boto <em>Voltar</em> para retornar
ao estado
da atividade antes que a nova inteno chegue em {@link android.app.Activity#onNewIntent
onNewIntent()}.</p>
</dd>

<dt>{@code "singleTask"}</dt>
  <dd>O sistema cria uma nova tarefa e instancia a atividade em sua raiz.
Entretanto, se uma instncia da atividade j existir em uma tarefa separada, o sistema encaminhar
a inteno quela instncia por meio de uma chamada do mtodo {@link
android.app.Activity#onNewIntent onNewIntent()} em vez de criar uma nova instncia. Somente
uma instncia da atividade pode existir por vez.
  <p class="note"><strong>Observao:</strong> embora a atividade inicie em uma nova tarefa, o boto 
<em>Voltar</em> ainda direciona o usurio  atividade anterior.</p></dd>
<dt>{@code "singleInstance"}.</dt>
  <dd>Igual  {@code "singleTask"}, exceto que o sistema no inicializa nenhuma outra atividade
na tarefa que contm a instncia. A atividade  sempre o nico e exclusivo membro de sua tarefa;
toda atividade iniciada por ela abre em uma tarefa separada.</dd>
</dl>


<p>Outro exemplo: o aplicativo Navegador do Android declara que a atividade do navegador da web deve
sempre abrir na prpria tarefa &mdash; especificando o modo de inicializao {@code singleTask} no elemento <a href="{@docRoot}guide/topics/manifest/activity-element.html">{@code &lt;activity&gt;}</a>.
Isso significa que, se o aplicativo emite uma
inteno para abrir o navegador do Android, sua atividade <em>no</em>  colocada na mesma
tarefa do aplicativo. Em vez disso, uma nova tarefa inicia para o navegador ou, se o navegador
j possui uma tarefa em execuo em segundo plano, essa tarefa  colocada em primeiro plano para tratar a nova
inteno.</p>

<p>Se uma atividade inicia em uma nova tarefa ou na mesma tarefa que a atividade que
a iniciou, o boto <em>Voltar</em> sempre direciona o usurio  atividade anterior. Porm, se voc
iniciar uma atividade que especifica o modo de inicializao {@code singleTask} e se uma instncia
dessa atividade existir em uma tarefa de segundo plano, toda a tarefa ser colocada em primeiro plano. Nesse
momento, a pilha de retorno conter todas as atividades da tarefa colocada em primeiro plano
no topo. A figura 4 ilustra essa situao.</p>

<img src="{@docRoot}images/fundamentals/diagram_backstack_singletask_multiactivity.png" alt="" />
<p class="img-caption"><strong>Figura 4.</strong> Representao de como uma atividade
com modo de inicializao "singleTask"  adicionada  pilha de retorno. Se a atividade j for parte de uma tarefa
de segundo plano com a prpria pilha de retorno, toda a pilha tambm vir
para primeiro plano, no topo da tarefa atual.</p>

<p>Para obter mais informaes sobre o uso de modos de inicializao no arquivo de manifesto, consulte a documentao do elemento
<code><a href="{@docRoot}guide/topics/manifest/activity-element.html">&lt;activity&gt;</a></code>
, onde o atributo {@code launchMode} e os valores aceitos
so discutidos mais aprofundadamente.</p>

<p class="note"><strong>Observao:</strong> os comportamentos a especificar para a atividade com o atributo <a href="{@docRoot}guide/topics/manifest/activity-element.html#lmode">{@code launchMode}</a>
 podem ser neutralizados por sinalizadores includos na inteno que inicia a atividade, conforme abordado
na prxima seo.</p>



<h4 id="#IntentFlagsForTasks">Uso de sinalizadores de inteno</h4>

<p>Ao iniciar uma atividade,  possvel modificar a associao padro de uma atividade  tarefa
incluindo sinalizadores na inteno fornecida a {@link
android.app.Activity#startActivity startActivity()}. Os sinalizadores que podem ser usados para modificar
o comportamento padro so:</p>

<p>
  <dt>{@link android.content.Intent#FLAG_ACTIVITY_NEW_TASK}</dt>
    <dd>Inicia a atividade em uma nova tarefa. Se uma tarefa j estiver em execuo para a atividade que voc est
iniciando agora, ela ser colocada em primeiro plano com o ltimo estado restaurado e a atividade
receber a nova inteno em {@link android.app.Activity#onNewIntent onNewIntent()}.
    <p>Isso produz o mesmo comportamento que o valor {@code "singleTask"} do <a href="{@docRoot}guide/topics/manifest/activity-element.html#lmode">{@code launchMode}</a>,
abordado na seo anterior.</p></dd>
  <dt>{@link android.content.Intent#FLAG_ACTIVITY_SINGLE_TOP}</dt>
    <dd>Se a atividade iniciada for a atual (no topo da pilha de retorno),
a instncia existente receber uma chamada de {@link android.app.Activity#onNewIntent onNewIntent()}
em vez de criar uma nova instncia da atividade.
    <p>Isso produz o mesmo comportamento que o valor {@code "singleTop"} do <a href="{@docRoot}guide/topics/manifest/activity-element.html#lmode">{@code launchMode}</a>
abordado na seo anterior.</p></dd>
  <dt>{@link android.content.Intent#FLAG_ACTIVITY_CLEAR_TOP}</dt>
    <dd>Se a atividade iniciada j estiver em execuo na tarefa atual, em vez
de lanar uma nova instncia daquela atividade, todas as outras atividades no topo dela sero
destrudas e essa inteno ser entregue  instncia reiniciada da atividade (agora no topo)
por {@link android.app.Activity#onNewIntent onNewIntent()}.
    <p>No h nenhum valor para o atributo <a href="{@docRoot}guide/topics/manifest/activity-element.html#lmode">{@code launchMode}</a>
 que produza esse comportamento.</p>
    <p>{@code FLAG_ACTIVITY_CLEAR_TOP}  mais usado em conjunto com
    {@code FLAG_ACTIVITY_NEW_TASK}.
Quando usados juntos, estes sinalizadores so o modo de localizar uma atividade existente
em outra tarefa e coloc-la em uma posio em que possa responder  inteno. </p>
    <p class="note"><strong>Observao:</strong> se o modo de inicializao da atividade designada for
{@code "standard"},
ela tambm ser removida da pilha e uma nova instncia ser iniciada em seu lugar para tratar
a inteno recebida.  Isso se deve ao fato de que uma nova instncia  sempre criada para uma nova inteno quando o
modo de inicializao  {@code "standard"}. </p>
</dd>
</dl>





<h3 id="Affinities">Tratamento de afinidades</h3>

<p>A <em>afinidade</em> indica a que tarefa uma atividade prefere pertencer. Por padro, todas
as atividades do mesmo aplicativo tm afinidade entre si. Assim, por padro, todas
as atividades no mesmo aplicativo preferem estar na mesma tarefa. Contudo,  possvel modificar
a afinidade padro de uma atividade. Atividades definidas
em aplicativos diferentes podem compartilhar uma afinidade, ou atividades definidas no mesmo aplicativo podem ter
diferentes afinidades de tarefa atribudas.</p>

<p> possvel modificar a afinidade de qualquer atividade com o atributo <a href="{@docRoot}guide/topics/manifest/activity-element.html#aff">{@code taskAffinity}</a>
 do elemento
<a href="{@docRoot}guide/topics/manifest/activity-element.html">{@code &lt;activity&gt;}</a>.</p>

<p>O atributo <a href="{@docRoot}guide/topics/manifest/activity-element.html#aff">{@code taskAffinity}</a>
 recebe um valor de string que deve ser exclusivo do nome do pacote padro
declarado no elemento <a href="{@docRoot}guide/topics/manifest/manifest-element.html">
{@code &lt;manifest&gt;}
</a> porque o sistema usa esse nome para identificar a afinidade
de tarefa padro do aplicativo.</p>

<p>A afinidade tem relevncia em duas circunstncias:</p>
<ul>
  <li>Quando a inteno que inicializa uma atividade contm
  o sinalizador
  {@link android.content.Intent#FLAG_ACTIVITY_NEW_TASK}.

<p>Uma nova atividade , por padro, inicializada na tarefa da atividade
que chamou {@link android.app.Activity#startActivity startActivity()}. Ela  colocada na mesma
pilha de retorno do autor da chamada.  Contudo, se a inteno passada a
{@link android.app.Activity#startActivity startActivity()}
contiver o sinalizador {@link android.content.Intent#FLAG_ACTIVITY_NEW_TASK}
, o sistema procurar uma tarefa diferente para comportar a nova atividade. Na maioria das vezes,  uma nova tarefa.
Porm, isso no  obrigatrio.  Se j houver uma tarefa com a mesma afinidade
da nova atividade, ela ser inicializada naquela tarefa.  Caso contrrio, ela iniciar uma nova tarefa.</p>

<p>Se esse sinalizador fizer com que uma atividade inicie uma nova tarefa e se o usurio pressionar o boto <em>Pgina inicial</em>
para sair dela,
 ser necessrio ter um modo de o usurio navegar de volta  tarefa. Algumas entidades (como
o gerenciador de notificao) sempre iniciam atividades em tarefas externas, nunca como parte de si mesmas, por isso
elas sempre colocam {@code FLAG_ACTIVITY_NEW_TASK} nas intenes que passam
a {@link android.app.Activity#startActivity startActivity()}.
Se voc tiver uma atividade que possa ser chamada
por uma entidade externa que possa usar este sinalizador, certifique-se de que o usurio tenha um modo independente
de voltar  tarefa iniciada, como com um cone de inicializao (a atividade raiz da tarefa
tem um filtro de intenes {@link android.content.Intent#CATEGORY_LAUNCHER}; consulte a seo <a href="#Starting">Incio de uma tarefa</a> abaixo).</p>
</li>

  <li>Quando uma atividade tem o atributo <a href="{@docRoot}guide/topics/manifest/activity-element.html#reparent">
{@code allowTaskReparenting}</a> definido como {@code "true"}.
  <p>Nesse caso, a atividade pode mover-se da tarefa que iniciou para a tarefa afim
quando for colocada em primeiro plano.</p>
  <p>Por exemplo: suponhamos que uma atividade que relate condies do clima em cidades selecionadas seja
definida como parte de um aplicativo de viagens.  Ela tem a mesma afinidade que outras atividades no mesmo
aplicativo (a afinidade padro do aplicativo) e permite a redefinio da hierarquia com esse atributo.
Quando uma das atividades inicia a atividade de notificao de clima, ela inicialmente pertence  mesma
tarefa de sua atividade. Porm, quando a tarefa do aplicativo de viagens  colocada em primeiro plano,
a atividade de notificao de clima  reatribuda a essa tarefa e exibida dentro dela.</p>
</li>
</ul>

<p class="note"><strong>Dica:</strong> se um arquivo {@code .apk} contiver mais de um "aplicativo"
do ponto de vista do usurio, voc provavelmente desejar usar o atributo <a href="{@docRoot}guide/topics/manifest/activity-element.html#aff">{@code taskAffinity}</a>
 para designar diferentes afinidades s atividades associadas a cada "aplicativo".</p>



<h3 id="Clearing">Apagar a pilha de retorno</h3>

<p>Se o usurio sair de uma tarefa por muito tempo, o sistema apagar a tarefa de todas as atividades exceto
a da atividade raiz.  Quando o usurio retornar  tarefa, somente a atividade raiz ser restaurada.
O sistema comporta-se dessa maneira porque, aps longo tempo de uso, os usurios provavelmente abandonaram
o que estavam fazendo antes e so direcionados de volta  tarefa para comear algo novo. </p>

<p>H alguns atributos de atividade que podem ser usados para modificar esse comportamento: </p>

<dl>
<dt><code><a
href="{@docRoot}guide/topics/manifest/activity-element.html#always">alwaysRetainTaskState</a></code>
</dt>
<dd>Se esse atributo for definido como {@code "true"} na atividade raiz de uma tarefa,
o comportamento padro descrito no acontecer.
A tarefa reter todas as atividades em sua pilha mesmo aps um longo perodo.</dd>

<dt><code><a
href="{@docRoot}guide/topics/manifest/activity-element.html#clear">clearTaskOnLaunch</a></code></dt>
<dd>Se esse atributo for definido como {@code "true"} na atividade raiz de uma tarefa,
a pilha ser apagada da atividade raiz sempre que o usurio sair da tarefa
e retornar a ela.  Em outras palavras,  o oposto de 
<a href="{@docRoot}guide/topics/manifest/activity-element.html#always">
{@code alwaysRetainTaskState}</a>. O usurio sempre retorna  tarefa
no estado inicial, mesmo ao retirar-se da tarefa somente por um momento.</dd>

<dt><code><a
href="{@docRoot}guide/topics/manifest/activity-element.html#finish">finishOnTaskLaunch</a></code>
</dt>
<dd>Esse atributo  como <a href="{@docRoot}guide/topics/manifest/activity-element.html#clear">{@code clearTaskOnLaunch}</a>,
mas opera
em uma nica atividade, e no em uma tarefa inteira.  Ele tambm apaga todas as atividades,
inclusive a atividade raiz.  Quando definido como {@code "true"},
a atividade permanece parte da tarefa somente para a sesso atual.  Se o usurio
retirar-se e, em seguida, retornar  tarefa, ela no estar mais presente.</dd>
</dl>




<h3 id="Starting">Incio de uma tarefa</h3>

<p> possvel configurar uma atividade como ponto de entrada de uma tarefa fornecendo-lhe um filtro de intenes
com {@code "android.intent.action.MAIN"} como a ao especificada
e {@code "android.intent.category.LAUNCHER"}
como a categoria especificada. Por exemplo:</p>

<pre>
&lt;activity ... &gt;
    &lt;intent-filter ... &gt;
        &lt;action android:name="android.intent.action.MAIN" /&gt;
        &lt;category android:name="android.intent.category.LAUNCHER" /&gt;
    &lt;/intent-filter&gt;
    ...
&lt;/activity&gt;
</pre>

<p>Um filtro de intenes desse tipo faz com que um cone e o rtulo
da atividade sejam exibidos no inicializador do aplicativo, fornecendo aos usurios um modo de inicializar a atividade
e de retornar  tarefa criada a qualquer tempo aps sua inicializao.
</p>

<p>Este segundo recurso  importante:  preciso que os usurios possam sair de uma tarefa e voltar a ela
mais tarde usando esse inicializador de atividades. Por isso, os dois <a href="#LaunchModes">modos
de inicializao</a> que marcam atividades como sempre iniciando uma tarefa ({@code "singleTask"} e
{@code "singleInstance"}) devem ser usados somente quando a atividade tiver um filtro
{@link android.content.Intent#ACTION_MAIN}
e um {@link android.content.Intent#CATEGORY_LAUNCHER}. Imagine, por exemplo, o que
aconteceria se o filtro no estivesse presente: uma inteno inicializaria uma atividade {@code "singleTask"}, iniciando uma
nova tarefa, e o usurio perderia algum tempo trabalhando nessa tarefa. O usurio, ento, pressiona o boto
<em>Pgina inicial</em>. A tarefa  enviada para segundo plano e no fica mais visvel. O usurio no tem como voltar
 tarefa porque ela no  representada no inicializador do aplicativo.</p>

<p>Para esses casos em que se deseja que o usurio no seja capaz de retornar a uma atividade, defina 
<a href="{@docRoot}guide/topics/manifest/activity-element.html#finish">{@code finishOnTaskLaunch}</a>
 do elemento 
<code><a href="{@docRoot}guide/topics/manifest/activity-element.html">&lt;activity&gt;</a></code>
como {@code "true"} (consulte <a href="#Clearing">Apagar a pilha</a>).</p>

<p>Veja mais informaes sobre a representao e o gerenciamento de atividades 
na tela de viso geral em <a href="{@docRoot}guide/components/recents.html">
Tela de viso geral</a>.</p>

<!--
<h2>Beginner's Path</h2>

<p>For more information about how to use intents to
activate other application components and publish the intents to which your components
respond, continue with the <b><a
href="{@docRoot}guide/components/intents-filters.html">Intents and Intent
Filters</a></b> document.</p>
-->