|
1 | 1 | # Android N 多窗口支持 |
2 | 2 |
|
3 | | -Android N 添加了对同时显示多个应用窗口的支持。 在手持设备上，两个应用可以在“分屏”模式中左右并排或上下并排显示。 在电视设备上，应用可以使用“画中画”模式，在用户与另一个应用交互的同时继续播放视频。 |
4 | | - |
5 | | -## 概览 |
6 | | - |
7 | | -Android N 允许多个应用同时共享屏幕。例如，用户可以分屏显示应用，在左边查看网页，同时在右边写邮件。 |
8 | | - |
9 | | - |
10 | | - |
11 | | -用户可以通过以下方式切换到多窗口模式： |
12 | | -* 若用户打开 [Overview 屏幕](https://developer.android.com/guide/components/recents.html)并长按 Activity 标题，则可以拖动该 Activity 至屏幕突出显示的区域，使 Activity 进入多窗口模式。 |
13 | | -* 若用户长按 Overview 按钮，设备上的当前 Activity 将进入多窗口模式，同时将打开 Overview 屏幕，用户可在该屏幕中选择要共享屏幕的另一个 Activity。 |
14 | | - |
15 | | -用户可以在两个 Activity 共享屏幕的同时在这两个 Activity 之间[拖放](https://developer.android.com/guide/topics/ui/drag-drop.html)数据 （在此之前，用户只能在一个 Activity 内部拖放数据）。 |
16 | | - |
17 | | -## 多窗口生命周期 |
18 | | - |
19 | | -多窗口模式不会更改 [Activity 生命周期](https://developer.android.com/training/basics/activity-lifecycle/index.html)。 |
20 | | - |
21 | | -在多窗口模式中，在指定时间只有最近与用户交互过的 Activity 为活动状态。 该 Activity 将被视为顶级 Activity。 所有其他 Activity 虽然可见，但均处于暂停状态。 但是，这些已暂停但可见的 Activity 在系统中享有比不可见 Activity 更高的优先级。 如果用户与其中一个暂停的 Activity 交互，该 Activity 将恢复，而之前的顶级 Activity 将暂停。 |
22 | | - |
23 | | -**注：在多窗口模式中，用户仍可以看到处于暂停状态的应用。 应用在暂停状态下可能仍需要继续其操作。 例如，处于暂停模式但可见的视频播放应用应继续显示视频。 因此，我们建议播放视频的 Activity 不要暂停其 onPause() 处理程序中的视频。 应暂停 onStop() 中的视频，并恢复 onStart() 中的视频播放。** |
24 | | - |
25 | | -如[处理运行时变更](https://developer.android.com/guide/topics/resources/runtime-changes.html)中所述，用户使用多窗口模式显示应用时，系统将通知 Activity 发生配置变更。 这也会发生在当用户调整应用大小，或将应用恢复到全屏模式时。 该变更与系统通知应用设备从纵向模式切换到横向模式时的 Activity 生命周期影响基本相同，但设备不仅仅是交换尺寸，而是会变更尺寸。 如[处理运行时变更](https://developer.android.com/guide/topics/resources/runtime-changes.html)中所述，您的 Activity 可以自行处理配置变更，或允许系统销毁 Activity，并以新的尺寸重新创建该 Activity。 |
26 | | - |
27 | | -如果用户调整窗口大小，并在任意维度放大窗口尺寸，系统将调整 Activity 以匹配用户操作，同时根据需要发布[运行时变更](https://developer.android.com/guide/topics/resources/runtime-changes.html)。 如果应用在新公开区域的绘制滞后，系统将使用 windowBackground 属性或默认 windowBackgroundFallback 样式属性指定的颜色暂时填充该区域。 |
28 | | - |
29 | | -## 针对多窗口模式配置应用 |
30 | | - |
31 | | -如果您的应用面向 Android N，您可以对应用的 Activity 是否支持多窗口显示以及显示方式进行配置。 您可以在清单文件中设置属性，以控制大小和布局。 根 Activity 的属性设置适用于其任务栈中的所有 Activity。 例如，如果根 Activity 已 android:resizeableActivity 设定为 true，则任务栈中的所有 Activity 都将可以调整大小。 |
32 | | - |
33 | | -**注：如果您使用低于 Android N 版本的 SDK 构建多向应用，则用户在多窗口模式中使用应用时，系统将强制调整应用大小。 系统将显示对话框，提醒用户应用可能会发生异常。 系统不会调整定向应用的大小；如果用户尝试在多窗口模式下打开定向应用，应用将全屏显示。** |
34 | | - |
35 | | -android:resizeableActivity |
36 | | -在清单的 <activity> 或 <application> 节点中设置该属性，启用或禁用多窗口显示： |
37 | | - |
38 | | -``` |
39 | | -android:resizeableActivity=["true" | "false"] |
40 | | -``` |
41 | | - |
42 | | -如果该属性设置为 true，Activity 将能以分屏和自由形状模式启动。 如果此属性设置为 false，Activity 将不支持多窗口模式。 如果该值为 false，且用户尝试在多窗口模式下启动 Activity，该 Activity 将全屏显示。 |
43 | | - |
44 | | -如果您的应用面向 Android N，但未对该属性指定值，则该属性的值默认设为 true。 |
45 | | - |
46 | | -### 布局属性 |
47 | | - |
48 | | -对于 Android N，<layout> 清单元素支持以下几种属性，这些属性影响 Activity 在多窗口模式中的行为： |
49 | | - |
50 | | -``` |
51 | | -android:defaultWidth // 以自由形状模式启动时 Activity 的默认宽度。 |
52 | | -
|
53 | | -android:defaultHeight // 以自由形状模式启动时 Activity 的默认高度。 |
54 | | -
|
55 | | -android:gravity // 以自由形状模式启动时 Activity 的初始位置。请参阅 Gravity 参考资料，了解合适的值设置。 |
56 | | -
|
57 | | -android:minHeight、android:minWidth // 分屏和自由形状模式中 Activity 的最小高度和最小宽度。 如果用户在分屏模式中移动分界线，使 Activity 尺寸低于指定的最小值，系统会将 Activity 裁剪为用户请求的尺寸。 |
58 | | -
|
59 | | -``` |
60 | | - |
61 | | -例如，以下节点显示了如何指定 Activity 在自由形状模式中显示时 Activity 的默认大小、位置和最小尺寸： |
62 | | - |
63 | | -``` |
64 | | -<activity android:name=".MyActivity"> |
65 | | - <layout android:defaultHeight="500dp" |
66 | | - android:defaultWidth="600dp" |
67 | | - android:gravity="top|end" |
68 | | - android:minHeight="450dp" |
69 | | - android:minWidth="300dp" /> |
70 | | -</activity> |
71 | | -``` |
72 | | - |
73 | | -## 在多窗口模式中运行应用 |
74 | | - |
75 | | -Android N 添加了新功能，以支持可在多窗口模式中运行的应用。 |
76 | | - |
77 | | -### 多窗口模式中被禁用的功能 |
78 | | - |
79 | | -在设备处于多窗口模式中时，某些功能会被禁用或忽略，因为这些功能对与其他 Activity 或应用共享设备屏幕的 Activity 而言没有意义。 此类功能包括： |
80 | | - |
81 | | -* 某些[系统 UI](https://developer.android.com/training/system-ui/index.html) 自定义选项将被禁用；例如，在非全屏模式中，应用无法隐藏状态栏。 |
82 | | -* 系统将忽略对 [android:screenOrientation](https://developer.android.com/guide/topics/manifest/activity-element.html#screen) 属性所作的更改。 |
83 | | - |
84 | | -### 多窗口变更通知和查询 |
85 | | - |
86 | | -Activity 类中添加了以下新方法，以支持多窗口显示。 |
87 | | - |
88 | | -``` |
89 | | -Activity.isInMultiWindowMode() // 调用该方法以确认 Activity 是否处于多窗口模式。 |
90 | | -
|
91 | | -Activity.onMultiWindowModeChanged() // Activity 进入或退出多窗口模式时系统将调用此方法。 在 Activity 进入多窗口模式时，系统向该方法传递 true 值，在退出多窗口模式时，则传递 false 值。 |
92 | | -
|
93 | | -
|
94 | | -``` |
95 | | - |
96 | | -每个方法还有 Fragment 版本，例如 Fragment.isInMultiWindowMode()。 |
97 | | - |
98 | | -## 在多窗口模式中启动新 Activity |
99 | | - |
100 | | -在启动新 Activity 时，用户可以提示系统如果可能，应将新 Activity 显示在当前 Activity 旁边。 要执行此操作，可使用标志 Intent.FLAG_ACTIVITY_LAUNCH_TO_ADJACENT。 传递此标志将请求以下行为： |
101 | | - |
102 | | -* 如果设备处于分屏模式，系统会尝试在启动系统的 Activity 旁创建新 Activity，这样两个 Activity 将共享屏幕。 系统并不一定能实现此操作，但如果可以，系统将使两个 Activity 处于相邻的位置。 |
103 | | -* 如果设备不处于分屏模式，则该标志无效。 |
104 | | - |
105 | | -如果设备处于自由形状模式，则在启动新 Activity 时，用户可通过调用 ActivityOptions.setLaunchBounds() 指定新 Activity 的尺寸和屏幕位置。 如果设备不处于多窗口模式，则该方法无效。 |
106 | | - |
107 | | -**注：如果您在任务栈中启动 Activity，该 Activity 将替换屏幕上的 Activity，并继承其所有的多窗口属性。 如果要在多窗口模式中以单独的窗口启动新 Activity，则必须在新的任务栈中启动此 Activity。** |
108 | | - |
109 | | -## 支持拖放 |
110 | | - |
111 | | -用户可以在两个 Activity 共享屏幕的同时在这两个 Activity 之间[拖放](https://developer.android.com/guide/topics/ui/drag-drop.html)数据 （在此之前，用户只能在一个 Activity 内部拖放数据）。 因此，如果您的应用目前不支持拖放功能，您可以在其中添加此功能。 |
112 | | - |
113 | | -``` |
114 | | -android.view.DropPermissions // 令牌对象，负责指定对接收拖放数据的应用授予的权限。 |
115 | | -
|
116 | | -View.startDragAndDrop() // View.startDrag() 的新别名。要启用跨 Activity 拖放，请传递新标志 View.DRAG_FLAG_GLOBAL。 如需对接收拖放数据的 Activity 授予 URI 权限，可根据情况传递新标志 View.DRAG_FLAG_GLOBAL_URI_READ 或 View.DRAG_FLAG_GLOBAL_URI_WRITE。 |
117 | | -
|
118 | | -View.cancelDragAndDrop() // 取消当前正在进行的拖动操作。只能由发起拖动操作的应用调用。 |
119 | | -
|
120 | | -View.updateDragShadow() // 替换当前正在进行的拖动操作的拖动阴影。只能由发起拖动操作的应用调用。 |
121 | | -
|
122 | | -Activity.requestDropPermissions() // 请求使用 DragEvent 中包含的 ClipData 传递的内容 URI 的权限。 |
123 | | -
|
124 | | -``` |
125 | | - |
126 | | -## 如果已禁用多窗口支持 |
127 | | - |
128 | | -如果您通过设置 android:resizableActivity="false" 禁用了多窗口支持，则应在运行 Android N 的设备上启动应用，并尝试将应用切换到自由形状和分屏模式。 验证并确保执行此操作后，应用仍保持全屏模式。 |
129 | | - |
| 3 | +[https://github.com/venshine/MultiWindow/wiki](https://github.com/venshine/MultiWindow/wiki) |
0 commit comments