guide/components/recents.jd

page.title=
page.tags="recents","overview"

@jd:body

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

  <h2> </h2>
  <ol>
    <li><a href="#adding">    </a>
      <ol>
        <li><a href="#flag-new-doc">  Intent   </a></li>
        <li><a href="#attr-doclaunch">     </a></li>
      </ol>
    </li>
    <li><a href="#removing"> </a>
      <ol>
        <li><a href="#apptask-remove">  AppTask   </a></li>
        <li><a href="#retain-finished">  </a></li>
      </ol>
    </li>
  </ol>

  <h2> </h2>
  <ol>
    <li>{@link android.app.ActivityManager.AppTask}</li>
    <li>{@link android.content.Intent}</li>
  </ol>

  <h2> </h2>
  <ol>
    <li><a href="{@docRoot}samples/DocumentCentricApps/index.html">    </a></li>
  </ol>

</div>
</div>

<p>  (  :   ,      )
     ,      <a href="{@docRoot}guide/components/activities.html">
</a>  <a href="{@docRoot}guide/components/tasks-and-back-stack.html"></a>.
        ,
 .   Android 5.0 ( API 21)
 ,   ,        . ,
Google          Google.
   .</p>

<img src="{@docRoot}images/components/recents.png" alt="" width="284" />
<p class="img-caption"><strong> 1.</strong>  ,      Google ,
     .</p>

<p>
   .      .
           .
{@link android.app.ActivityManager.AppTask}   ,
{@link android.content.Intent} ,
   .  ,  <code><a href="{@docRoot}guide/topics/manifest/activity-element.html">
&lt;activity&gt;</a></code>     .</p>

<h2 id="adding">    </h2>

<p>   {@link android.content.Intent}
          .
<code><a href="{@docRoot}guide/topics/manifest/activity-element.html">&lt;activity&gt;</a></code>

   .</p>

<h3 id="flag-new-doc">  Intent   </h3>

<p>
{@link android.app.ActivityManager.AppTask#startActivity(android.content.Context, android.content.Intent, android.os.Bundle) startActivity()}
 {@link android.app.ActivityManager.AppTask},   intent,
  .    ,
   ,   {@link android.content.Intent#FLAG_ACTIVITY_NEW_DOCUMENT}
  {@link android.content.Intent#addFlags(int) addFlags()} {@link android.content.Intent},
  .</p>

<p class="note"><strong>.</strong>  {@link android.content.Intent#FLAG_ACTIVITY_NEW_DOCUMENT}
  {@link android.content.Intent#FLAG_ACTIVITY_CLEAR_WHEN_TASK_RESET},
     Android 5.0   ( API 21).</p>

<p>    {@link android.content.Intent#FLAG_ACTIVITY_MULTIPLE_TASK}
 ,           .
        .   ,
    :</p>

<p class="code-caption"><a href="{@docRoot}samples/DocumentCentricApps/index.html">
DocumentCentricActivity.java</a></p>
<pre>
public void createNewDocument(View view) {
      final Intent newDocumentIntent = newDocumentIntent();
      if (useMultipleTasks) {
          newDocumentIntent.addFlags(Intent.FLAG_ACTIVITY_MULTIPLE_TASK);
      }
      startActivity(newDocumentIntent);
  }

  private Intent newDocumentIntent() {
      boolean useMultipleTasks = mCheckbox.isChecked();
      final Intent newDocumentIntent = new Intent(this, NewDocumentActivity.class);
      newDocumentIntent.addFlags(Intent.FLAG_ACTIVITY_NEW_DOCUMENT);
      newDocumentIntent.putExtra(KEY_EXTRA_NEW_DOCUMENT_COUNTER, incrementAndGet());
      return newDocumentIntent;
  }

  private static int incrementAndGet() {
      Log.d(TAG, "incrementAndGet(): " + mDocumentCounter);
      return mDocumentCounter++;
  }
}
</pre>

<p class="note"><strong>.</strong> ,    {@code FLAG_ACTIVITY_NEW_DOCUMENT},
    {@code android:launchMode="standard"} ( ),
 .</p>

<p>     ,      ,
 intent       Intent  .
   intent   {@link android.content.Intent#FLAG_ACTIVITY_MULTIPLE_TASK},
       .   ,
          intent  {@link android.app.Activity#onNewIntent onNewIntent()}.
   intent       ,
  :</p>

<p class="code-caption"><a href="{@docRoot}samples/DocumentCentricApps/index.html">
NewDocumentActivity.java</a></p>
<pre>
&#64;Override
protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.activity_new_document);
    mDocumentCount = getIntent()
            .getIntExtra(DocumentCentricActivity.KEY_EXTRA_NEW_DOCUMENT_COUNTER, 0);
    mDocumentCounterTextView = (TextView) findViewById(
            R.id.hello_new_document_text_view);
    setDocumentCounterText(R.string.hello_new_document_counter);
}

&#64;Override
protected void onNewIntent(Intent intent) {
    super.onNewIntent(intent);
    /* If FLAG_ACTIVITY_MULTIPLE_TASK has not been used, this activity
    is reused to create a new document.
     */
    setDocumentCounterText(R.string.reusing_document_counter);
}
</pre>


<h3 id="#attr-doclaunch">     </h3>

<p>     ,       .
<code><a href="{@docRoot}guide/topics/manifest/activity-element.html">&lt;activity&gt;</a></code>
, <a href="{@docRoot}guide/topics/manifest/activity-element.html#dlmode">
{@code android:documentLaunchMode}</a>.     ,    ,
     :</p>

<dl>
  <dt>"{@code intoExisting}"</dt>
  <dd>      .
 {@link android.content.Intent#FLAG_ACTIVITY_NEW_DOCUMENT} <em></em>
 {@link android.content.Intent#FLAG_ACTIVITY_MULTIPLE_TASK},
<a href="#flag-new-doc">  Intent   </a> .</dd>

  <dt>"{@code always}"</dt>
  <dd>     ,     .
      {@link android.content.Intent#FLAG_ACTIVITY_NEW_DOCUMENT}
 {@link android.content.Intent#FLAG_ACTIVITY_MULTIPLE_TASK}.</dd>

  <dt>"{@code none}"</dt>
  <dd>      .
    :        ,
    ,  .</dd>

  <dt>"{@code never}"</dt>
  <dd>      .
   {@link android.content.Intent#FLAG_ACTIVITY_NEW_DOCUMENT}
  {@link android.content.Intent#FLAG_ACTIVITY_MULTIPLE_TASK},
intent,         ,
    ,  .</dd>
</dl>

<p class="note"><strong>.</strong>    {@code none}  {@code never}
      {@code launchMode="standard"}.     ,
 {@code documentLaunchMode="none"}.</p>

<h2 id="removing"> </h2>

<p>
 .        {@link android.app.ActivityManager.AppTask},
  {@link android.content.Intent}   <code><a href="{@docRoot}guide/topics/manifest/activity-element.html">
&lt;activity&gt;</a></code>.</p>

<p>         ,
<code><a href="{@docRoot}guide/topics/manifest/activity-element.html">&lt;activity&gt;</a></code>
 <a href="{@docRoot}guide/topics/manifest/activity-element.html#exclude">
{@code android:excludeFromRecents}</a>  {@code true}.</p>

<p>    ,        ,
<code><a href="{@docRoot}guide/topics/manifest/activity-element.html">&lt;activity&gt;</a></code>
 <a href="{@docRoot}guide/topics/manifest/activity-element.html#maxrecents">{@code android:maxRecents}
</a>  .   : 16.
       .   {@code android:maxRecents}
50 (25      );   1  .</p>

<h3 id="#apptask-remove">  AppTask   </h3>

<p> ,       ,
           ,
 {@link android.app.ActivityManager.AppTask#finishAndRemoveTask() finishAndRemoveTask()}.</p>

<p class="code-caption"><a href="{@docRoot}samples/DocumentCentricApps/index.html">
NewDocumentActivity.java</a></p>
<pre>
public void onRemoveFromRecents(View view) {
    // The document is no longer needed; remove its task.
    finishAndRemoveTask();
}
</pre>

<p class="note"><strong>.</strong>
 {@link android.app.ActivityManager.AppTask#finishAndRemoveTask() finishAndRemoveTask()},
    {@link android.content.Intent#FLAG_ACTIVITY_RETAIN_IN_RECENTS},
 .</p>

<h3 id="#retain-finished">  </h3>

<p>     ,     ,
 {@link android.content.Intent#FLAG_ACTIVITY_RETAIN_IN_RECENTS}
{@link android.content.Intent#addFlags(int) addFlags()}  Intent,   .</p>

<p class="code-caption"><a href="{@docRoot}samples/DocumentCentricApps/index.html">
DocumentCentricActivity.java</a></p>
<pre>
private Intent newDocumentIntent() {
    final Intent newDocumentIntent = new Intent(this, NewDocumentActivity.class);
    newDocumentIntent.addFlags(Intent.FLAG_ACTIVITY_NEW_DOCUMENT |
      android.content.Intent.FLAG_ACTIVITY_RETAIN_IN_RECENTS);
    newDocumentIntent.putExtra(KEY_EXTRA_NEW_DOCUMENT_COUNTER, incrementAndGet());
    return newDocumentIntent;
}
</pre>

<p>
<code><a href="{@docRoot}guide/topics/manifest/activity-element.html">&lt;activity&gt;</a></code>
 <a href="{@docRoot}guide/topics/manifest/activity-element.html#autoremrecents">
{@code android:autoRemoveFromRecents}</a>  {@code false}.    {@code true}
    {@code false}   .
 {@link android.content.Intent#FLAG_ACTIVITY_RETAIN_IN_RECENTS},  .</p>