xref: /frameworks/base/docs/html-intl/intl/pt-br/training/basics/activity-lifecycle/starting.jd

page.title=Iniciando uma atividade
page.tags=ciclo de vida de atividade
helpoutsWidget=true

trainingnavtop=true

@jd:body


<div id="tb-wrapper">
  <div id="tb">
    
    <h2>Esta lio ensina a</h2>
<ol>
  <li><a href="#lifecycle-states">Entender o ciclo de vida do retorno de chamada</a></li>
  <li><a href="#launching-activity">Especificar a atividade da tela de incio do aplicativo</a></li>
  <li><a href="#Create">Criar uma nova instncia</a></li>
  <li><a href="#Destroy">Destruir a atividade</a></li>
</ol>
    
    <h2>Leia tambm</h2>
    <ul>
      <li><a href="{@docRoot}guide/components/activities.html">Atividades</a></li>
    </ul>

<h2>Tente</h2>

<div class="download-box">
 <a href="http://developer.android.com/shareables/training/ActivityLifecycle.zip" class="button">Baixar a demonstrao</a>
 <p class="filename">ActivityLifecycle.zip</p>
</div>

  </div>
</div>

<p>Diferente de outros paradigmas de programao em que os aplicativos so lanados com um mtodo {@code main()}, o
sistema Android inicia o cdigo em uma instncia {@link android.app.Activity} chamando mtodos especficos
de retorno de chamada que correspondem a determinados estgios do seu
ciclo de vida. H uma sequncia de mtodos de retorno de chamada que iniciam uma atividade e uma sequncia de mtodos
de retorno de chamada que interrompem uma atividade.</p>

<p>Essa lio proporciona uma viso geral dos mtodos do ciclo de vida mais importantes e mostra como
lidar com o primeiro retorno de chamada do ciclo de vida que cria uma nova instncia de sua atividade.</p>



<h2 id="lifecycle-states">Entender o ciclo de vida do retorno de chamada</h2>

<p>Durante a vida de uma atividade, o sistema chama um ncleo principal de mtodos do ciclo de vida em
uma sequncia parecida com uma pirmide em degraus. Isto , cada estgio do
ciclo de vida da atividade corresponde a um degrau da pirmide. Conforme o sistema cria uma nova instncia de atividade,
cada mtodo de retorno de chamada leva o estado da atividade um degrau acima. O topo da pirmide  o
ponto em que a atividade funciona em primeiro plano e o usurio pode interagir com ela.</p>

<p>Conforme o usurio comea a sair da atividade, o sistema chama outros mtodos que a movem
de volta em direo  base da pirmide para desfazer a atividade. Em alguns casos, a atividade  movida
parcialmente em direo  base da pirmide e aguarda (como quando o usurio muda para outro aplicativo), no
ponto em que a atividade  movida novamente em direo ao topo (se o usurio retornar  atividade) e
reinicia de onde o usurio parou.</p>


<img src="{@docRoot}images/training/basics/basic-lifecycle.png" />
<p class="img-caption"><strong>Figura 1.</strong> Ilustrao simplificada do ciclo de vida
da atividade, expressa como pirmide em degraus. Isso mostra que, para cada retorno de chamada usado para levar
uma atividade ao estado de Reiniciado, em direo ao topo, h um mtodo de retorno de chamada
que leva a atividade um degrau abaixo. A atividade tambm pode retornar ao estado de retomada do
estado de Pausado e Interrompido.</p>


<p>Dependendo da complexidade de sua atividade, no h necessidade de implementar todos os
mtodos do ciclo de vida. No entanto,  importante compreender cada um e implementar apenas aqueles que
garantem que seu aplicativo tenha o desempenho esperado pelo usurio. A implementao adequada dos mtodos do ciclo de vida da atividade
garante que seu aplicativo tenha um bom desempenho em vrios sentidos, incluindo que:</p>
<ul>
  <li>No apresente falhas se o usurio receber uma chamada telefnica ou mudar para outro aplicativo
enquanto estiver usando o seu aplicativo.</li>
  <li>No consuma recursos importantes do sistema quando o usurio no estiver utilizando
ativamente o aplicativo.</li>
  <li>No perca o progresso do usurio se ele sair do aplicativo e retornar
mais tarde.</li>
  <li>No apresente falhas nem perca o progresso do usurio quando a orientao da tela mudar entre
paisagem e retrato.</li>
</ul>

<!--
<p class="table-caption"><strong>Table 1.</strong> Activity lifecycle state pairs and callback 
methods.</p>
<table>
  <tr>
    <th scope="col">Lifecycle State</th>
    <th scope="col">Startup Method</th>
    <th scope="col">Teardown Method</th>
  </tr>
  <tr>
    <td>Created / Destroyed</td>
    <td>{@link android.app.Activity#onCreate onCreate()}</td>
    <td>{@link android.app.Activity#onDestroy()}</td>
  </tr>
  <tr>
    <td>Started / Stopped</td>
    <td>{@link android.app.Activity#onStart()}</td>
    <td>{@link android.app.Activity#onStop()}</td>
  </tr>
  <tr>
    <td>Resumed / Resumed</td>
    <td>{@link android.app.Activity#onResume()}</td>
    <td>{@link android.app.Activity#onPause()}</td>
  </tr>
</table>
-->

<p>Como voc aprender nas lies seguintes, h vrias situaes de transies de
atividades entre estados diferentes, como ilustrado na figura 1. No entanto, apenas trs
desses estados podem ser estticos. Isto , a atividade pode existir em um de apenas trs estados por
um perodo de tempo maior:</p>
<dl>
  <dt>Reiniciado</dt>
    <dd>Neste estado, a atividade est no primeiro plano e o usurio consegue interagir.
(Tambm chamado de estado de funcionamento.)</dd>
  <dt>Pausado</dt>
    <dd>Neste estado, a atividade est parcialmente obscurecida por outra atividade. A
outra atividade que est em primeiro plano  semitransparente ou no cobre totalmente a tela. A
atividade pausada no recebe entrada do usurio e no executa nenhum cdigo.
  <dt>Interrompido</dt>
    <dd>Neste estado, a atividade est completamente oculta e no  visvel para o usurio. Considera-se
que est em segundo plano. Enquanto interrompido, a instncia da atividade e todas as
informaes de estado, como variveis de membro, so retidas, mas no  possvel executar nenhum cdigo.</dd>
</dl>

<p>Os outros estados (Criado e Iniciado) so temporrios e o sistema rapidamente se move rapidamente de um
estado a outro chamando o prximo mtodo de retorno de chamada do ciclo de vida. Isto , depois que o sistema chama
{@link android.app.Activity#onCreate onCreate()}, ele rapidamente chama {@link
android.app.Activity#onStart()}, que  seguido por {@link
android.app.Activity#onResume()}.</p>

<p>Isso  tudo que precisamos dizer sobre o ciclo de vida bsico de atividades. Agora voc aprender sobre alguns dos
comportamentos especficos do ciclo de vida.</p>



<h2 id="launching-activity">Especificar a atividade da tela de incio do aplicativo</h2> 

<p>Quando o usurio seleciona seu aplicativo na tela inicial, o sistema chama o mtodo {@link
android.app.Activity#onCreate onCreate()} para {@link android.app.Activity} no aplicativo
que foi declarado como atividade da inicializador (ou principal). Essa  a atividade que serve como
ponto de entrada principal da interface do usurio do aplicativo.</p>

<p> possvel definir qual atividade ser usada como principal no arquivo manifesto do Android, <a href="{@docRoot}guide/topics/manifest/manifest-intro.html">{@code AndroidManifest.xml}</a>, que est
na raiz do diretrio do seu projeto.</p>

<p>A principal atividade do aplicativo deve ser declarada no manifesto com um <a href="{@docRoot}guide/topics/manifest/intent-filter-element.html">{@code
<intent-filter>}</a> que inclui a ao {@link
android.content.Intent#ACTION_MAIN MAIN} e categoria
{@link android.content.Intent#CATEGORY_LAUNCHER LAUNCHER}. Por exemplo:</p> 

<pre>
&lt;activity android:name=".MainActivity" android:label="&#64;string/app_name">
    &lt;intent-filter>
        &lt;action android:name="android.intent.action.MAIN" />
        &lt;category android:name="android.intent.category.LAUNCHER" />
    &lt;/intent-filter>
&lt;/activity>
</pre>

<p class="note"><strong>Observao:</strong> ao criar um novo projeto do Android com ferramentas
SDK Android, os arquivos padres do projeto incluem uma classe {@link android.app.Activity} que  declarada no
manifesto com esse filtro.</p>

<p>Se a ao {@link android.content.Intent#ACTION_MAIN MAIN} nem a categoria
{@link android.content.Intent#CATEGORY_LAUNCHER LAUNCHER} forem declaradas para uma de suas
atividades, o cone do aplicativo no aparecer na lista de aplicativos da tela inicial.</p>



<h2 id="Create">Criar uma nova instncia</h2>

<p>A maioria dos aplicativos tem vrias atividades que permitem ao usurio realizar diferentes aes.
Tanto para a atividade principal criada quando o usurio clica no cone do aplicativo quanto uma
atividade diferente que o aplicativo inicia em resposta  ao do usurio, o sistema cria
cada nova instncia do {@link android.app.Activity} chamando o mtodo {@link
android.app.Activity#onCreate onCreate()}.</p>

<p>Implemente o mtodo {@link android.app.Activity#onCreate onCreate()} para realizar a lgica bsica
de inicializao do aplicativo que deve acontecer apenas uma vez na vida completa da atividade. Por
exemplo, sua implementao do {@link android.app.Activity#onCreate onCreate()} deve definir a
interface do usurio e possivelmente instanciar algumas variveis de escopo de classe.</p>

<p>Por exemplo, o seguinte modelo do mtodo {@link android.app.Activity#onCreate onCreate()}
 mostra alguns cdigos que realizam configuraes fundamentais para a atividade, como
declarar a interface do usurio (definida em arquivo de layout XML), definir variveis de membro
e configurar parte da interface do usurio.</p>

<pre>
TextView mTextView; // Member variable for text view in the layout

&#64;Override
public void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);

    // Set the user interface layout for this Activity
    // The layout file is defined in the project res/layout/main_activity.xml file
    setContentView(R.layout.main_activity);
    
    // Initialize member TextView so we can manipulate it later
    mTextView = (TextView) findViewById(R.id.text_message);
    
    // Make sure we're running on Honeycomb or higher to use ActionBar APIs
    if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.HONEYCOMB) {
        // For the main activity, make sure the app icon in the action bar
        // does not behave as a button
        ActionBar actionBar = getActionBar();
        actionBar.setHomeButtonEnabled(false);
    }
}
</pre>

<p class="caution"><strong>Cuidado:</strong> utilizar {@link android.os.Build.VERSION#SDK_INT} para
evitar que sistemas antigos executem novas APIs funciona apenas no Android 2.0 (API Nvel
5) e verses posteriores. Verses mais antigas encontram uma exceo no tempo de execuo.</p>

<p>Depois que o {@link android.app.Activity#onCreate onCreate()} termina de executar, o sistema
chama os mtodos {@link android.app.Activity#onStart()} e {@link android.app.Activity#onResume()}
 em rpida sucesso. A atividade nunca reside nos estados Criado ou Iniciado. Tecnicamente, a
atividade se torna visvel para o usurio quando {@link android.app.Activity#onStart()}  chamado, mas
{@link android.app.Activity#onResume()}  executado e a atividade permanece no estado Reiniciado
at que algo diferente ocorra, como o recebimento de uma chamada telefnica, o usurio
navegar para outra atividade ou a tela do dispositivo desligar.</p>

<p>Nas prximas lies, voc ver como outros mtodos de inicializao, {@link
android.app.Activity#onStart()} e {@link android.app.Activity#onResume()}, podem ajudar
no ciclo de vida da atividade quando utilizado para reiniciar a atividade dos estados Pausado e Interrompido.</p>

<p class="note"><strong>Observao:</strong> o mtodo {@link android.app.Activity#onCreate onCreate()}
inclui um parmetro chamado <code>savedInstanceState</code>, que ser discutido mais adiante
na lio <a href="recreating.html">Recriando uma atividade</a>.</p>


<img src="{@docRoot}images/training/basics/basic-lifecycle-create.png" />
<p class="img-caption"><strong>Figura 2.</strong> Outra ilustrao da estrutura do ciclo de vida da
atividade com nfase nos trs retornos de chamada principais que o sistema chama na sequncia quando
cria uma nova instncia da atividade: {@link android.app.Activity#onCreate onCreate()}, {@link
android.app.Activity#onStart()} e{@link android.app.Activity#onResume()}. Depois que esta sequncia de
retornos de chamada for concluda, a atividade chega ao estado Reiniciado em que os usurios podem interagir com a
atividade at que mude para outra atividade.</p>







<h2 id="Destroy">Destruir a atividade</h2>

<p>Embora o retorno de chamada do primeiro ciclo de vida da atividade seja {@link android.app.Activity#onCreate
onCreate()}, o ltimo retorno de chamada ser {@link android.app.Activity#onDestroy}. O sistema chama
este mtodo na atividade como o ltimo
sinal de que a instncia da atividade est sendo completamente removida da memria do sistema.</p>

<p>A maioria dos aplicativos no exige a implementao desse mtodo porque referncias de classe locais so destrudas
com a atividade, que realiza a maior parte da limpeza durante {@link
android.app.Activity#onPause} e {@link android.app.Activity#onStop}. No entanto, se a
atividade incluir threads de segundo plano criados durante {@link
android.app.Activity#onCreate onCreate()} ou outro recurso de longa execuo que pode
vazar memria se no forem fechados adequadamente, voc deve finaliz-los durante {@link
android.app.Activity#onDestroy}.</p>

<pre>
&#64;Override
public void onDestroy() {
    super.onDestroy();  // Always call the superclass
    
    // Stop method tracing that the activity started during onCreate()
    android.os.Debug.stopMethodTracing();
}
</pre>

<p class="note"><strong>Observao:</strong> o sistema chama {@link android.app.Activity#onDestroy}
depois de ter chamado {@link android.app.Activity#onPause} e {@link
android.app.Activity#onStop} em qualquer situao, exceto uma: quando voc chama {@link
android.app.Activity#finish()} pelo mtodo {@link android.app.Activity#onCreate onCreate()}
. Em alguns casos, como quando a atividade assume a posio temporria de tomadora de decises para
lanar outra atividade, chame {@link android.app.Activity#finish()} pelo {@link
android.app.Activity#onCreate onCreate()} para destruir a atividade. Nesse caso, o sistema
chama imediatamente {@link android.app.Activity#onDestroy} sem chamar qualquer outro
 mtodo do ciclo de vida.</p>