page.title=多窗口支持
page.metaDescription=Android N 全新支持同时显示多个应用窗口。
page.keywords="multi-window", "android N", "split screen", "free-form"

@jd:body

<div id="qv-wrapper">
  <div id="qv">
    <h2>本文内容</h2>
      <ol>
        <li><a href="#overview">概览</a></li>
        <li><a href="#lifecycle">多窗口生命周期</a></li>
        <li><a href="#configuring">针对多窗口模式配置应用
</a></li>
        <li><a href="#running">在多窗口模式中运行应用</a></li>
        <li><a href="#testing">测试应用的多窗口支持</a></li>
      </ol>
    <h2>另请参阅</h2>
      <ol>
        <li><a class="external-link" href="https://github.com/googlesamples/android-MultiWindowPlayground">多窗口 Playground 示例应用
</a></li>
      </ol>
  </div>
</div>

<p>
  Android N 添加了对同时显示多个应用窗口的支持。
在手持设备上，两个应用可以在<em>分屏</em>模式中左右并排或上下并排显示。
在电视设备上，应用可以使用<em>画中画</em>模式，在用户与另一个应用交互的同时继续播放视频。


</p>

<p>
  如果您使用 N Preview SDK 构建应用，则可以配置应用处理多窗口显示的方法。
例如，您可以指定 Activity 的最小允许尺寸。
您还可以禁用应用的多窗口显示，确保系统仅以全屏模式显示应用。


</p>

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

<p>
  Android N 允许多个应用同时共享屏幕。例如，用户可以分屏显示应用，在左边查看网页，同时在右边写邮件。

用户体验取决于设备：

</p>

<ul>
  <li>运行 Android N 的手持设备具有分屏模式。
在此模式中，系统以左右并排或上下并排的方式分屏显示两个应用。
用户可以拖动两个应用之间的分界线，放大其中一个应用，同时缩小另一个。

  </li>

  <li>在运行 Android N 的 Nexus Player 上，应用能以<a href="picture-in-picture.html">画中画模式</a>显示，即在用户浏览网页或与其他应用交互的同时继续显示内容。



  </li>

  <li>较大设备的制造商可选择启用自由形状模式，在该模式中，用户可以自由调整各 Activity 的尺寸。
若制造商启用此功能，设备将同时具有自由形状模式和分屏模式。


  </li>
</ul>

<img src="{@docRoot}preview/images/mw-splitscreen.png" alt="" width="650" srcset="{@docRoot}preview/images/mw-splitscreen.png 1x,
    {@docRoot}preview/images/mw-splitscreen_2x.png 2x," id="img-split-screen" />
<p class="img-caption">
  <strong>图 1.</strong> 两个应用在分屏模式中左右并排显示。
</p>

<p>
  用户可以通过以下方式切换到多窗口模式：
</p>

<ul>
  <li>若用户打开 <a href="{@docRoot}guide/components/recents.html">Overview 屏幕</a>并长按 Activity 标题，则可以拖动该 Activity 至屏幕突出显示的区域，使 Activity 进入多窗口模式。



  </li>

  <li>若用户长按 Overview 按钮，设备上的当前 Activity 将进入多窗口模式，同时将打开 Overview 屏幕，用户可在该屏幕中选择要共享屏幕的另一个 Activity。


  </li>
</ul>

<p>
  用户可以在两个 Activity 共享屏幕的同时在这两个 Activity 之间<a href="{@docRoot}guide/topics/ui/drag-drop.html">拖放</a>数据

（在此之前，用户只能在一个 Activity 内部拖放数据）。

</p>

<h2 id="lifecycle">多窗口生命周期</h2>

<p>
  多窗口模式不会更改 <a href="{@docRoot}training/basics/activity-lifecycle/index.html">Activity 生命周期</a>。

</p>

<p>
  在多窗口模式中，在指定时间只有最近与用户交互过的 Activity 为活动状态。
该 Activity 将被视为<em>顶级</em> Activity。
  所有其他 Activity 虽然可见，但均处于暂停状态。
  但是，这些已暂停但可见的 Activity 在系统中享有比不可见 Activity 更高的优先级。
如果用户与其中一个暂停的 Activity 交互，该 Activity 将恢复，而之前的顶级 Activity 将暂停。


</p>

<p class="note">
  <strong>注</strong>：在多窗口模式中，用户仍可以看到处于暂停状态的应用。
应用在暂停状态下可能仍需要继续其操作。
例如，处于暂停模式但可见的视频播放应用应继续显示视频。
因此，我们建议播放视频的 Activity <em>不要</em>暂停其 {@link android.app.Activity#onPause onPause()} 处理程序中的视频。


  应暂停 {@link android.app.Activity#onStop
  onStop()} 中的视频，并恢复 {@link android.app.Activity#onStart
  onStart()} 中的视频播放。
</p>

<p>
  如<a href="{@docRoot}guide/topics/resources/runtime-changes.html">处理运行时变更</a>中所述，用户使用多窗口模式显示应用时，系统将通知 Activity 发生配置变更。

该变更与系统通知应用设备从纵向模式切换到横向模式时的 Activity 生命周期影响基本相同，但设备不仅仅是交换尺寸，而是会变更尺寸。


如<a href="{@docRoot}guide/topics/resources/runtime-changes.html">处理运行时变更</a>中所述，您的 Activity 可以自行处理配置变更，或允许系统销毁 Activity，并以新的尺寸重新创建该 Activity。



</p>

<p>
  如果用户调整窗口大小，并在任意维度放大窗口尺寸，系统将调整 Activity 以匹配用户操作，同时根据需要发布<a href="{@docRoot}guide/topics/resources/runtime-changes.html">运行时变更</a>。

如果应用在新公开区域的绘制滞后，系统将使用 {@link
  android.R.attr#windowBackground windowBackground} 属性或默认 <code>windowBackgroundFallback</code> 样式属性指定的颜色暂时填充该区域。


</p>

<h2 id="configuring">针对多窗口模式配置应用</h2>

<p>
  如果您的应用面向 Android N，您可以对应用的 Activity 是否支持多窗口显示以及显示方式进行配置。
您可以在清单文件中设置属性，以控制大小和布局。

  根 Activity 的属性设置适用于其任务栈中的所有 Activity。

</p>

<p class="note">
  <strong>注</strong>：如果您使用低于 Android N 版本的 SDK 构建多向应用，则用户在多窗口模式中使用应用时，系统将强制调整应用大小。

系统将显示对话框，提醒用户应用可能会发生异常。
系统<em>不会</em>调整定向应用的大小；如果用户尝试在多窗口模式下打开定向应用，应用将全屏显示。



</p>

<h4 id="resizeableActivity">android:resizeableActivity</h4>
<p>
  在清单文件的 <code>&lt;activity&gt;</code> 或
 <code>&lt;application&gt;</code> 节点中设置该属性，启用或禁用多窗口显示：

</p>

<pre>
android:resizeableActivity=["true" | "false"]
</pre>

<p>
  如果该属性设置为 true，Activity 将能以分屏和自由形状模式启动。
如果此属性设置为 false，Activity 将不支持多窗口模式。
如果该值为 false，且用户尝试在多窗口模式下启动 Activity，该 Activity 将全屏显示。


</p>

<p>
  如果您的应用面向 Android N，但未对该属性指定值，则该属性的值默认设为 true。

</p>

<h4 id="supportsPictureInPicture">android:supportsPictureInPicture</h4>

<p>
  在清单文件的 <code>&lt;activity&gt;</code> 节点中设置该属性，指明 Activity 是否支持画中画显示。
如果 <code>android:resizeableActivity</code> 为 false，将忽略该属性。

</p>

<pre>
android:supportsPictureInPicture=["true" | "false"]
</pre>

<h3 id="layout">布局属性</h3>

<p>
  对于 Android N，<code>&lt;layout&gt;</code> 清单文件元素支持以下几种属性，这些属性影响 Activity 在多窗口模式中的行为：


</p>

<dl>
  <dt>
    <code>android:defaultWidth</code>
  </dt>

  <dd>
    以自由形状模式启动时 Activity 的默认宽度。
  </dd>

  <dt>
    <code>android:defaultHeight</code>
  </dt>

  <dd>
    以自由形状模式启动时 Activity 的默认高度。
  </dd>

  <dt>
    <code>android:gravity</code>
  </dt>

  <dd>
    以自由形状模式启动时 Activity 的初始位置。请参阅 {@link android.view.Gravity} 参考资料，了解合适的值设置。

  </dd>

  <dt>
    <code>android:minimalSize</code>
  </dt>

  <dd>
    分屏和自由形状模式中 Activity 的最小高度和最小宽度。
如果用户在分屏模式中移动分界线，使 Activity 尺寸低于指定的最小值，系统会将 Activity 裁剪为用户请求的尺寸。


  </dd>
</dl>

<p>
  例如，以下节点显示了如何指定 Activity 在自由形状模式中显示时 Activity 的默认大小、位置和最小尺寸：


</p>

<pre>
&lt;activity android:name=".MyActivity"&gt;
    &lt;layout android:defaultHeight="500dp"
          android:defaultWidth="600dp"
          android:gravity="top|end"
          android:minimalSize="450dp" /&gt;
&lt;/activity&gt;
</pre>

<h2 id="running">在多窗口模式中运行应用</h2>

<p>
  Android N 添加了新功能，以支持可在多窗口模式中运行的应用。

</p>

<h3 id="disabled-features">多窗口模式中被禁用的功能</h3>

<p>
  在设备处于多窗口模式中时，某些功能会被禁用或忽略，因为这些功能对与其他 Activity 或应用共享设备屏幕的 Activity 而言没有意义。

此类功能包括：

<ul>
  <li>某些<a href="{@docRoot}training/system-ui/index.html">系统 UI</a> 自定义选项将被禁用；例如，在非全屏模式中，应用无法隐藏状态栏。


  </li>

  <li>系统将忽略对 <code><a href=
  "{@docRoot}guide/topics/manifest/activity-element.html#screen"
  >android:screenOrientation</a></code> 属性所作的更改。
  </li>
</ul>

<h3 id="change-notification">多窗口变更通知和查询</h3>

<p>
  {@link android.app.Activity} 类中添加了以下新方法，以支持多窗口显示。
有关各方法的详细信息，请参阅 <a href="{@docRoot}preview/setup-sdk.html#docs-dl">N Preview SDK 参考</a>。

</p>

<dl>
  <dt>
    <code>Activity.inMultiWindow()</code>
  </dt>

  <dd>
    调用该方法以确认 Activity 是否处于多窗口模式。
  </dd>

  <dt>
    <code>Activity.inPictureInPicture()</code>
  </dt>

  <dd>
    调用该方法以确认 Activity 是否处于画中画模式。

    <p class="note">
      <strong>注</strong>：画中画模式是多窗口模式的特例。
如果 <code>myActivity.inPictureInPicture()</code> 返回 true，则 <code>myActivity.inMultiWindow()</code> 也返回 true。


    </p>
  </dd>

  <dt>
    <code>Activity.onMultiWindowChanged()</code>
  </dt>

  <dd>
    Activity 进入或退出多窗口模式时系统将调用此方法。
在 Activity 进入多窗口模式时，系统向该方法传递 true 值，在退出多窗口模式时，则传递 false 值。


  </dd>

  <dt>
    <code>Activity.onPictureInPictureChanged()</code>
  </dt>

  <dd>
    Activity 进入或退出画中画模式时系统将调用此方法。
在 Activity 进入画中画模式时，系统向该方法传递 true 值，在退出画中画模式时，则传递 false 值。


  </dd>
</dl>

<p>
  每个方法还有 {@link android.app.Fragment} 版本，例如 <code>Fragment.inMultiWindow()</code>。

</p>

<h3 id="entering-pip">进入画中画模式</h3>

<p>
  如需在画中画模式中启动 Activity，请调用新方法 <code>Activity.enterPictureInPicture()</code>。
如果设备不支持画中画模式，则此方法无效。
如需了解详细信息，请参阅<a href="picture-in-picture.html">画中画</a>文档。

</p>

<h3 id="launch">在多窗口模式中启动新 Activity</h3>

<p>
  在启动新 Activity 时，用户可以提示系统如果可能，应将新 Activity 显示在当前 Activity 旁边。
要执行此操作，可使用标志 <code>Intent.FLAG_ACTIVITY_LAUNCH_TO_ADJACENT</code>。

传递此标志将请求以下行为：

</p>

<ul>
  <li>如果设备处于分屏模式，系统会尝试在启动系统的 Activity 旁创建新 Activity，这样两个 Activity 将共享屏幕。

系统并不一定能实现此操作，但如果可以，系统将使两个 Activity 处于相邻的位置。

  </li>

  <li>如果设备不处于分屏模式，则该标志无效。
  </li>
</ul>

<p>
  如果设备处于自由形状模式，则在启动新 Activity 时，用户可通过调用 <code>ActivityOptions.setLaunchBounds()</code> 指定新 Activity 的尺寸和屏幕位置。

如果设备不处于多窗口模式，则该方法无效。

</p>

<p class="note">
  <strong>注</strong>：如果您在任务栈中启动 Activity，该 Activity 将替换屏幕上的 Activity，并继承其所有的多窗口属性。

如果要在多窗口模式中以单独的窗口启动新 Activity，则必须在新的任务栈中启动此 Activity。

</p>

<h3 id="dnd">支持拖放</h3>

<p>
  用户可以在两个 Activity 共享屏幕的同时在这两个 Activity 之间<a href="{@docRoot}guide/topics/ui/drag-drop.html">拖放</a>数据

（在此之前，用户只能在一个 Activity 内部拖放数据）。
因此，如果您的应用目前不支持拖放功能，您可以在其中添加此功能。

</p>

<p>
  N Preview SDK 扩展了 <a href="{@docRoot}reference/android/view/package-summary.html"><code>android.view</code></a> 软件包，以支持跨应用拖放。
有关以下类和方法的详细信息，请参阅 <a href="{@docRoot}preview/setup-sdk.html#docs-dl">N Preview SDK 参考</a>。


</p>

<dl>
  <dt>
    <code>android.view.DropPermissions</code>
  </dt>

  <dd>
    令牌对象，负责指定对接收拖放数据的应用授予的权限。

  </dd>

  <dt>
    <code>View.startDragAndDrop()</code>
  </dt>

  <dd>
    {@link android.view.View#startDrag View.startDrag()} 的新别名。要启用跨 Activity 拖放，请传递新标志 <code>View.DRAG_FLAG_GLOBAL</code>。

如需对接收拖放数据的 Activity 授予 URI 权限，可根据情况传递新标志 <code>View.DRAG_FLAG_GLOBAL_URI_READ</code> 或 <code>View.DRAG_FLAG_GLOBAL_URI_WRITE</code>。



  </dd>

  <dt>
    <code>View.cancelDragAndDrop()</code>
  </dt>

  <dd>
    取消当前正在进行的拖动操作。只能由发起拖动操作的应用调用。

  </dd>

  <dt>
    <code>View.updateDragShadow()</code>
  </dt>

  <dd>
    替换当前正在进行的拖动操作的拖动阴影。只能由发起拖动操作的应用调用。

  </dd>

  <dt>
    <code>Activity.requestDropPermissions()</code>
  </dt>

  <dd>
    请求使用 {@link android.view.DragEvent} 中包含的 {@link
    android.content.ClipData} 传递的内容 URI 的权限。
  </dd>
</dl>

<h2 id="testing">测试应用的多窗口支持</h2>

<p>
  无论您是否针对 Android N 更新应用，都应验证应用在多窗口模式下的行为，以防用户尝试在运行 Android N 的设备上以多窗口模式启动应用。


</p>

<h3 id="configuring">配置测试设备</h3>

<p>
  如果在设备上安装 Android N，则将自动支持分屏模式。

</p>

<h3 id="test-non-n">如果应用并非使用 N Preview SDK 构建</h3>

<p>
  如果您的应用不是使用 N Preview SDK 构建的，则用户尝试在多窗口模式中使用应用时，系统将强制调整应用大小，除非应用进行了定向声明。


</p>

<p>
  如果您的应用没有进行定向声明，则应在运行 Android N 的设备上启动应用，并尝试将应用切换到分屏模式。

验证并确保在强制调整应用大小时用户体验可接受。

</p>

<p>
  如果应用进行了定向声明，则应尝试将应用切换到多窗口模式。
验证并确保执行此操作后，应用仍保持全屏模式。

</p>

<h3 id="test-mw">如果支持多窗口模式</h3>

<p>
  如果您的应用是使用 N Preview SDK 构建的，且未禁用多窗口支持，则分别在分屏和自由形状模式下验证以下行为。


</p>

<ul>
  <li>在全屏模式下启动应用，然后通过长按 Overview 按钮切换到多窗口模式。
验证并确保应用正常切换。
  </li>

  <li>直接在多窗口模式中启动应用，验证并确保应用正常启动。
您可以按一下 Overview 按钮，再长按应用的标题栏，并将其拖动到屏幕上任一突出显示的区域，从而在多窗口模式中启动应用。


  </li>

  <li>拖动分界线，在分屏模式中调整应用的大小。
  验证并确保应用正常调整大小且未崩溃，并且必要的 UI 元素仍可见。

  </li>

  <li>如果您指定了应用的最小尺寸，请尝试将应用尺寸调整到低于最小值。
验证并确保无法将应用尺寸调整到低于指定最小值。

  </li>

  <li>完成所有测试后，验证并确保应用性能可以接受。例如，验证并确保调整应用大小后更新 UI 没有长时间的滞后。


  </li>
</ul>

<h4 id="test-checklist">测试检查单</h4>

<p>
  要在多窗口模式中验证应用性能，请执行以下操作。
除非另有说明，否则请分别在分屏和多窗口模式中执行以下操作。

</p>

<ul>
  <li>进入和退出多窗口模式。
  </li>

  <li>从您的应用切换到另一个应用，验证并确保应用在非活动但可见的状态下正常运行。
例如，如果您的应用在播放视频，则验证并确保在用户与另一个应用交互时视频仍在继续播放。


  </li>

  <li>在分屏模式中，尝试移动分界线，放大或缩小应用。
分别在左右和上下并排显示模式中尝试这些操作。
验证并确保应用不会崩溃，主要功能可见，且调整操作不需要过长时间。


  </li>

  <li>快速连续执行几次调整操作。验证并确保应用不会崩溃或出现内存泄漏。
有关检查应用内存使用率的信息，请参阅<a href="{@docRoot}tools/debugging/debugging-memory.html">查看内存使用率</a>。


  </li>

  <li>在多个不同窗口配置中正常使用应用，验证并确保应用正常运行。
验证并确保文本可读，且 UI 元素大小正常，不影响交互。

  </li>
</ul>

<h3 id="test-disabled-mw">如果已禁用多窗口支持</h3>

<p>
  如果您通过设置 <code>android:resizableActivity="false"</code> 禁用了多窗口支持，则应在运行 Android N 的设备上启动应用，并尝试将应用切换到自由形状和分屏模式。


验证并确保执行此操作后，应用仍保持全屏模式。

</p>