xref: /frameworks/base/docs/html-intl/intl/pt-br/preview/backup/index.jd

page.title=Backup automtico para aplicativos
page.tags=backup, previewresources, androidm
page.keywords=backup, autobackup, preview
page.image=images/cards/card-auto-backup_2x.png
@jd:body

<div id="qv-wrapper">
  <div id="qv">
    <h2>Neste documento</h2>
      <ol>
        <li><a href="#overview">Viso geral</a></li>
        <li><a href="#configuring">Configurar backup de dados</a></li>
        <li><a href="#testing">Testar configurao de backup</a></li>
        <li><a href="#issues">Problemas conhecidos</a></li>
      </ol>
  </div>
</div>

<p>
  Frenquentemente, os usurios investem muito tempo e esforo para criar dados e configurar preferncias
 nos aplicativos. Preservar esses dados para os usurios caso substituam um dispositivo quebrado ou atualizem-se para um novo
  importante para garantir uma tima experincia de usurio. Dispositivos que executam o sistema Android M Preview
 ajudam a garantir uma boa experincia para os usurios nessas circunstncias realizando o backup dos dados do aplicativo
 automaticamente no Google Drive. Os dados do aplicativo so restaurados automaticamente se um usurio alterar ou atualizar um
 dispositivo.
</p>

<p>
  Os backups automticos esto ativos para todos os aplicativos instalados nos dispositivos que executam o Android M Preview. Nenhum
 cdigo adicional de aplicativo  necessrio. O sistema fornece aos usurios a habilidade de deciso
 sobre os backups automticos de dados. Tambm  possvel limitar quais dados do aplicativo devem ter o backup.
</p>

<p>
  Este documento descreve o novo comportamento do sistema e como especificar quais dados tero backup
 para o aplicativo.
</p>

<h2 id="overview">Viso geral</h2>

<p>
  O recurso de backup automtico preserva os dados que o aplicativo cria em um dispositivo de usurio enviando-os
  conta do Google Drive do usurio e criptografando-os. No h cobranas para voc ou para o usurio
 em relao ao armazenamento de dados e os dados salvos no contam para a cota do Drive pessoal do usurio. Durante
 o perodo do M Preview, os usurios podem armazenar at 25 MB por aplicativo do Android.
</p>

<p>
  Os backups automticos ocorrem a cada 24 horas, quando o dispositivo est ocioso, carregando e conectado
 a uma rede Wi-Fi. Quando esses requisitos so atendidos, o servio Backup Manager envia todos os dados de backup
 disponveis  nuvem. Quando um usurio transita para um novo dispositivo, ou desinstala e reinstala
 o aplicativo com backup realizado, uma operao de restaurao copia os dados de backup para o diretrio de dados
 do aplicativo recm-instalado.
</p>

<p class="note">
  <strong>Observao:</strong> se o usurio usar o
 <a href="{@docRoot}google/backup/index.html">servio de Backup do Android</a> de legado, este novo comportamento
 no se aplicar aos trabalhos de comportamento de backup existentes com o normal.
</p>


<h3 id="auto-exclude">Arquivos de dados excludos automaticamente</h3>

<p>
  Nem todos os dados do aplicativo devem ter backup, como arquivos temporrios e de armazenamento em cach. Portanto, o servio de backup automtico
 exclui determinados arquivos de dados por padro:
</p>

<ul>
  <li>Arquivos em diretrios identificados pelos mtodos {@link android.content.Context#getCacheDir
 getCacheDir()} e {@link android.content.ContextWrapper#getCodeCacheDir getCodeCacheDir()}
.
  </li>

  <li>Arquivos localizados no armazenamento externo, a no ser que estejam no diretrio identificado pelo mtodo
 {@link android.content.Context#getExternalFilesDir getExternalFilesDir()}
.
  </li>

  <li>Arquivos localizados no diretrio identificado pelo mtodo
 {@link android.content.Context#getNoBackupFilesDir getNoBackupFilesDir()}.
  </li>
</ul>

<h2 id="configuring">Configurar backup de dados</h2>

<p>
  Os dados criados por qualquer aplicativo instalado em um dispositivo M Preview tm backup, exceto
 os arquivos excludos automaticamente listados na seo anterior.  possvel limitar e configurar
 quais dados tero backup no seu aplicativo usando as configuraes no manifesto do aplicativo.
</p>

<h3 id="include-exclude">Incluir ou excluir dados</h3>

<p>
  Dependendo de quais dados o aplicativo precisar e do modo que forem salvos, voc precisar definir
 regras especficas para incluir ou excluir determinados arquivos ou diretrios. O servio de backup automtico suporta
 a configurao dessas regras de backup por meio do uso de um arquivo de configurao XML e do
 manifesto do aplicativo. No manifesto do aplicativo,  possvel especificar o arquivo de configurao de esquema de backup como exibido
 no seguinte exemplo:
</p>

<pre>
&lt;?xml version="1.0" encoding="utf-8"?&gt;
&lt;manifest xmlns:android="http://schemas.android.com/apk/res/android"
        xmlns:tools="http://schemas.android.com/tools"
        package="com.my.appexample"&gt;
    &lt;uses-sdk android:minSdkVersion="MNC"/&gt;
    &lt;uses-sdk android:targetSdkVersion="MNC"/&gt;
    &lt;app ...
<strong>        android:fullBackupContent="&#64;xml/mybackupscheme"&gt;</strong>
    &lt;/app&gt;
    ...
&lt;/manifest&gt;
</pre>

<p>
  Neste cdigo de exemplo, o atributo <code>android:fullBackupContent</code> especifica um arquivo XML,
 localizado no diretrio <code>res/xml/</code> do projeto de desenvolvimento do aplicativo, chamado
 <code>mybackupscheme.xml</code>. Este arquivo de configurao inclui as regras de quais arquivos tero
 backup. O seguinte cdigo de exemplo mostra um arquivo de configurao que exclui um arquivo especfico
 dos backups:
</p>

<pre>
&lt;?xml version="1.0" encoding="utf-8"?&gt;
&lt;full-backup-content&gt;
    &lt;exclude domain="database" path="device_info.db"/&gt;
&lt;/full-backup-content&gt;
</pre>

<p>
  Esta configurao de backup de exemplo exclui do backup somente um arquivo especfico do banco de dados.
  Todos os outros arquivos tero backup.
</p>

<h4>Sintaxe da configurao de backup</h4>

<p>
  A configurao do servio de backup permite que voc especifique quais arquivos incluir ou excluir do
backup. A sintaxe para o arquivo XML de configurao de backup de dados  a seguinte:
</p>

<pre>
&lt;full-backup-content&gt;
    &lt;include domain=["file" | "database" | "sharedpref" | "external" | "root"] path="string" /&gt;
    &lt;exclude domain=["file" | "database" | "sharedpref" | "external" | "root"] path="string" /&gt;
&lt;/full-backup-content&gt;
</pre>

<p>
  Os seguintes elementos e atributos permitem que voc especifique os arquivos que sero includos ou excludos
 do backup:
</p>

<ul>
  <li>
  <code>&lt;include&gt;</code>. Use este elemento se quiser especificar um conjunto de recursos
para o backup, em vez de fazer o sistema realizar o backup de todos os dados no aplicativo por padro. Ao especificar
 uma tag <code>&lt;include&gt;</code>, o sistema realiza apenas o backup <em>dos recursos especificados</em>
 com este elemento.
  </li>

  <li>
  <code>&lt;exclude&gt;</code>. Use este elemento para especificar um conjunto de recursos que ser excludo
 do backup. O sistema realiza o backup de todos os dados no aplicativo, exceto os recursos especificados
 com este elemento.
  </li>

  <li>
  <code>domain.</code> O tipo de recurso que deseja excluir ou incluir no backup. Os valores vlidos
 que podem ser especificados para este atributo incluem:
  </li>

  <li style="list-style: none">
  <ul>
    <li>
    <code>root</code>. Especifica que o recurso est no diretrio raiz do aplicativo.
    </li>

    <li>
    <code>file</code>. Corresponde ao recurso no diretrio retornado
 pelo mtodo {@link android.content.Context#getFilesDir getFilesDir()}.
    </li>

    <li>
    <code>database</code>. Corresponde ao banco de dados retornado
 pelo mtodo {@link android.content.Context#getDatabasePath getDatabasePath()} ou usando
 a classe {@link android.database.sqlite.SQLiteOpenHelper}.
    </li>

    <li>
    <code>sharedpref</code>. Corresponde a um objeto {@link android.content.SharedPreferences}
 retornado pelo mtodo {@link android.content.Context#getSharedPreferences getSharedPreferences()}
.
    </li>

    <li>
    <code>external</code>. Especifica que o recurso est no armazenamento externo e corresponde
 a um arquivo no diretrio retornado pelo mtodo
 {@link android.content.Context#getExternalFilesDir getExternalFilesDir()}.
    </li>

    <li>
    <code>path</code>. O caminho de arquivo para um recurso que deseja excluir ou incluir
 no backup.
    </li>
  </ul>
  </li>
</ul>


<h3 id="prohibit">Proibir backup de dados</h3>

<p>
   possvel optar por evitar backups automticos de quaisquer dados do aplicativo configurando
 o atributo <code>android:allowBackup</code> para <code>false</code> no elemento do aplicativo
 do manifesto. Esta configurao  ilustrada no seguinte cdigo de exemplo:
</p>

<pre>
&lt;?xml version="1.0" encoding="utf-8"?&gt;
&lt;manifest xmlns:android="http://schemas.android.com/apk/res/android"
        xmlns:tools="http://schemas.android.com/tools"
        package="com.my.appexample"&gt;
    &lt;uses-sdk android:minSdkVersion="MNC"/&gt;
    &lt;uses-sdk android:targetSdkVersion="MNC"/&gt;
    &lt;app ...
<strong>        android:allowBackup="false"&gt;</strong>
    &lt;/app&gt;
    ...
&lt;/manifest&gt;
</pre>


<h2 id="testing">Testar configurao de backup</h2>

<p>
  Ao criar uma configurao de backup, deve-se test-la para garantir que o aplicativo
 salva os dados e que eles podem ser restaurados corretamente.
</p>


<h4>Ativar registro de backup</h4>

<p>
  Para ajudar a determinar como o recurso de backup analisa o arquivo XML, ative o registro
 antes de realizar um backup de teste:
</p>

<pre class="noprettyprint">
$ adb shell setprop log.tag.BackupXmlParserLogging VERBOSE
</pre>

<h4>Teste de backup</h4>

<p>Para executar um backup manualmente, primeiro deve-se inicializar o Backup Manager chamando o seguinte
 comando:
</p>

<pre class="noprettyprint">
$ adb shell bmgr run
</pre>

<p>
  Em seguida, realiza-se o backup manualmente do aplicativo usando o seguinte comando, especificando o nome
 do pacote para o aplicativo como o parmetro <code>&lt;PACKAGE&gt;</code>:
</p>

<pre class="noprettyprint">
$ adb shell bmgr fullbackup &lt;PACKAGE&gt;</pre>


<h4>Teste de restaurao</h4>

<p>
  Para iniciar manualmente uma restaurao aps o backup dos dados do aplicativo, chame o seguinte comando,
 especificando o nome do pacote para o aplicativo como o parmetro <code>&lt;PACKAGE&gt;</code>:
</p>

<pre class="noprettyprint">
$ adb shell bmgr restore &lt;PACKAGE&gt;
</pre>

<p class="warning">
  <b>Aviso:</b> esta ao impede o aplicativo de apagar os dados antes de realizar
 a operao de restaurao.
</p>

<p>
  Para iniciar o processo de restaurao do aplicativo, deve-se desinstalar e reinstal-lo. Os dados
 do aplicativo so restaurados automaticamente a partir da nuvem quando a instalao do aplicativo for concluda.
</p>


<h4>Resoluo de problemas de backups</h4>

<p>
  Caso ocorra problemas,  possvel apagar os dados de backup e os metadados associados desativando o backup
 e reativando-o em <strong>Settings (Configuraes) &gt; Backup</strong>, redefinindo o dispositivo para as especificaes de fbrica, ou
 chamando este comando:
</p>

<pre>$ adb shell bmgr wipe &lt;TRANSPORT&gt; &lt;PACKAGE&gt;</pre>

<p>
  O valor <code>&lt;TRANSPORT&gt;</code> deve ser prefixado por <code>com.google.android.gms</code>.
  Para obter uma lista de transportes, chame o seguinte comando:
</p>

<pre>$ adb shell bmgr list transports</pre>

<h2 id="issues">Problemas conhecidos</h2>

<p>A seguir esto os problemas conhecidos com o servio de backup automtico:</p>

<ul>
  <li><strong>Google Cloud Messaging</strong> -
 Para aplicativos que usam o Google Cloud Messaging para notificaes push, h um problema conhecido
 onde o backup do ID de registro retornado pelo registro do Google Cloud Messaging pode
 desencadear notificaes push para o aplicativo restaurado.  importante consultar a API para obter um novo ID de registro
 aps a instalao em um novo dispositivo, o que no deve ser o caso se o ID de registro antigo
 tiver backup. Para evitar isto, exclua o ID de registro do conjunto de arquivos
 de backup.
  </li>
</ul>