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

page.title=    
page.tags=backup, previewresources, androidm
page.keywords= ,   ,  
page.image=images/cards/card-auto-backup_2x.png
@jd:body

<div id="qv-wrapper">
  <div id="qv">
    <h2> </h2>
      <ol>
        <li><a href="#overview"></a></li>
        <li><a href="#configuring">   </a></li>
        <li><a href="#testing">   </a></li>
        <li><a href="#issues"> </a></li>
      </ol>
  </div>
</div>

<p>
                 .
           ,      ,            .
    Android M Preview
    ,     
  Google Drive.      ,     
 .
</p>

<p>
        ,      Android M Preview.  
       .        
   .    ,        ,     .
</p>

<p>
             ,
  .
</p>

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

<p>
      ,       ,  
Google Drive     ,     .      
.  ,            Google Drive.    M Developer Preview
      25     Android.
</p>

<p>
       24,    ,        
Wi-Fi.              
 .            
,     ,          
 .
</p>

<p class="note">
  <strong>.</strong>     
<a href="{@docRoot}google/backup/index.html">   Android</a>, 
         .
</p>


<h3 id="auto-exclude">   </h3>

<p>
        .  ,       .  
           :
</p>

<ul>
  <li>  ,     {@link android.content.Context#getCacheDir
getCacheDir()}  {@link android.content.ContextWrapper#getCodeCacheDir getCodeCacheDir()};

  </li>

  <li>   ,  ,   ,    
{@link android.content.Context#getExternalFilesDir getExternalFilesDir()};

  </li>

  <li>  ,    
{@link android.content.Context#getNoBackupFilesDir getNoBackupFilesDir()}.
  </li>
</ul>

<h2 id="configuring">   </h2>

<p>
      ,   ,       M Preview,    
,    .     ,
      ,   ,          .
</p>

<h3 id="include-exclude">   </h3>

<p>
     ,          ,      
       .    
     XML-  
 .          ,    
.
</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>
       <code>android:fullBackupContent</code>  XML-,
   <code>res/xml/</code>  ,  
<code>mybackupscheme.xml</code>.       
 .       ,        
:
</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>
               .
         .
</p>

<h4>   </h4>

<p>
        ,         
  .  XML-     :
</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>
           ,           
:
</p>

<ul>
  <li>
  <code>&lt;include&gt;</code>:   ,  ,           ,     ,      .
   
<code>&lt;include&gt;</code>,     <em>  </em>
  .
  </li>

  <li>
  <code>&lt;exclude&gt;</code>:   ,    , 
     .            ,    
;
  </li>

  <li>
  <code>domain.</code>:  ,          . 
      :
  </li>

  <li style="list-style: none">
  <ul>
    <li>
    <code>root</code>:   ,       ;
    </li>

    <li>
    <code>file</code>:    ,  
{@link android.content.Context#getFilesDir getFilesDir()};
    </li>

    <li>
    <code>database</code>:   ,  
{@link android.content.Context#getDatabasePath getDatabasePath()}  
{@link android.database.sqlite.SQLiteOpenHelper};
    </li>

    <li>
    <code>sharedpref</code>:   {@link android.content.SharedPreferences},
 
{@link android.content.Context#getSharedPreferences getSharedPreferences()};
    </li>

    <li>
    <code>external</code>:   ,      ,  
  ,  
{@link android.content.Context#getExternalFilesDir getExternalFilesDir()};
    </li>

    <li>
    <code>path</code>:   ,        
 .
    </li>
  </ul>
  </li>
</ul>


<h3 id="prohibit">   </h3>

<p>
         .          
<code>android:allowBackup</code> <code>false</code>.
   ,     :
</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">   </h2>

<p>
           ,       
     .
</p>


<h4>   </h4>

<p>
         XML-   ,     ,
  :
</p>

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

<h4>  </h4>

<p>     ,     ,  
:
</p>

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

<p>
            ,  
    <code>&lt;PACKAGE&gt;</code>:
</p>

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


<h4> </h4>

<p>
           ,   ,  
    <code>&lt;PACKAGE&gt;</code>:
</p>

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

<p class="warning">
  <b>.</b>      
         .
</p>

<p>
     ,       . 
         .
</p>


<h4>   </h4>

<p>
               .   
        <strong>&gt; </strong>,      
 :
</p>

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

<p>
    <code>&lt;TRANSPORT&gt;</code>    <code>com.google.android.gms</code>.
     ,   :
</p>

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

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

<p>         .</p>

<ul>
  <li><strong>Google Cloud Messaging</strong>
    ,  Google Cloud Messaging   push-.    ,
     ,  Google Cloud Messaging,   
push-   .    API-  
      ,       
  .   ,      
  .
  </li>
</ul>