前言

从 Android 7.0 开始，Google 推出了一个名为“多窗口模式”的新功能，允许在设备屏幕上同时显示多个应用，多窗口模式允许多个应用同时共享同一屏幕，多窗口模式（Multi Window Supports）目前支持以下三种配置：

• 分屏模式：让系统可以左右或上下并排显示应用。
  

• 画中画模式：在应用中用小窗口叠加显示其他应用
  

• 自由窗口模式：在可移动且可调整大小的单独窗口中显示各个应用。

一、分屏模式的适配

1、我们如何才能让自己的 APP 支持分屏模式呢？

若项目的targetSDKVersion 大于等于24，那么可以在AndroidManifest.xml 文件的Application 或Activity 节点通过设置android:resizeableActivity=[“true” | “false”] 来控制整个 APP 或某个 Activity 是否支持分屏。该属性的默认值是true ，也就是说，如果不设置该属性，在支持分屏的设备上，默认是可以分屏的。

若项目的targetSDKVersion 小于24，那么运行在支持分屏的设备上，默认可以分屏。这时如果需要禁止分屏，需要在AndroidManifest.xml 文件的Application 或Activity 节点设置android:screenOrientation 属性来控制整个 APP 或 某个 Activity 的屏幕方向，从而控制整个 APP 或某个 Activity 禁止分屏。

2、分屏模式的监听

能不能在代码中监听 APP 是否进入分屏模式呢？答案是能。由于 APP 在分屏模式发生改变时会执行onMultiWindowModeChanged 方法，因此我们在 Activity 中重写这个方法就可以实现分屏的监听了。

@Overridepublic void onMultiWindowModeChanged(boolean isInMultiWindowMode) {super.onMultiWindowModeChanged(isInMultiWindowMode);// 判断当前是否为分屏模式if (isInMultiWindowMode) {// 已进入分屏模式} else {// 未进入分屏模式}}

3、分屏模式下的生命周期

• 进入分屏模式时，Activity 的生命周期：

onPause()- onStop()- onMultiWindowModeChanged()- onDestroy()- onCreate()- onStart()- onResume()- onPause()

• 退出分屏模式时，Activity 的生命周期：

onStop()- onDestroy()- onCreate()- onStart()- onResume()- onPause()- onMultiWindowModeChanged()- onResume()

可以看出，在进入分屏模式时，Activity 先执行onMultiWindowModeChanged 方法，再重建自己。在退出分屏模式时，Activity 先重建自己，再执行onMultiWindowModeChanged 方法。这样会有一个问题，我们的 APP 进入分屏模式时，在onMultiWindowModeChanged 方法中如果有对 UI 等的操作，经过之后的自动重建就没有效果了。为了防止这种情况，需要在AndroidManifest.xml 的Activity 节点设置以下属性：

android:configChanges=“screenSize|smallestScreenSize|screenLayout|orientation”

设置了这个属性，在进入分屏模式时，Activity 就不会自动重建了。

• 分屏模式下打开 Activity

如果 APP 在分屏模式下打开 Activity 时，为 Intent 设置了Intent.FLAG_ACTIVITY_LAUNCH_ADJACENT 和Intent.FLAG_ACTIVITY_NEW_TASK 标志，那么新打开的 Activity 将显示在当前 APP 的另一侧。例如下面的代码：

	Intent intent = new Intent(this, NewActivity.class);intent.setFlags(Intent.FLAG_ACTIVITY_LAUNCH_ADJACENT|Intent.FLAG_ACTIVITY_NEW_TASK);startActivity(intent);

二、多窗口模式在Activity和ActivityThread类中的主要调用回溯

1、结合前面的分析，可以发现onMultiWindowModeChanged是一个很重要的方法，让我们来看下这个方法是什么时候被系统调用的。

base/core/java/android/app/Activity.java

public class Activity extends ContextThemeWrapperimplements LayoutInflater.Factory2,Window.Callback, KeyEvent.Callback,OnCreateContextMenuListener, ComponentCallbacks2,Window.OnWindowDismissedCallback,AutofillManager.AutofillClient, ContentCaptureManager.ContentCaptureClient {private Window mWindow;//Activity对应的Windowfinal FragmentController mFragments = FragmentController.createController(new HostCallbacks());private boolean mIsInMultiWindowMode;//当前是否处于多窗口模式@Deprecatedpublic void onMultiWindowModeChanged(boolean isInMultiWindowMode) {}public void onMultiWindowModeChanged(boolean isInMultiWindowMode, Configuration newConfig) {onMultiWindowModeChanged(isInMultiWindowMode);}final void dispatchMultiWindowModeChanged(boolean isInMultiWindowMode,Configuration newConfig) {if (DEBUG_LIFECYCLE) Slog.v(TAG,"dispatchMultiWindowModeChanged " + this + ": " + isInMultiWindowMode+ " " + newConfig);mFragments.dispatchMultiWindowModeChanged(isInMultiWindowMode, newConfig);if (mWindow != null) {mWindow.onMultiWindowModeChanged();}mIsInMultiWindowMode = isInMultiWindowMode;onMultiWindowModeChanged(isInMultiWindowMode, newConfig);}
}

onMultiWindowModeChanged方法在Activity中被初次调用，是在dispatchMultiWindowModeChanged方法中。

2、而Activity的dispatchMultiWindowModeChanged方法初次被调用，是在ActivityThread类中。

base/core/java/android/app/ActivityThread.java

public final class ActivityThread extends ClientTransactionHandlerimplements ActivityThreadInternal {private final Map<IBinder, Integer> mLastReportedWindowingMode = Collections.synchronizedMap(new ArrayMap<>());//启动Activity的核心方法private Activity performLaunchActivity(ActivityClientRecord r, Intent customIntent) {...代码省略...Activity activity = null;java.lang.ClassLoader cl = appContext.getClassLoader();//通过反射创建Activity实例对象activity = mInstrumentation.newActivity(cl, component.getClassName(), r.intent);...代码省略...//创建activity对应的配置信息对象Configuration config = new Configuration(mConfigurationController.getCompatConfiguration());...代码省略...//将窗口模式信息以activity的token为key，存放到Map缓存中mLastReportedWindowingMode.put(activity.getActivityToken(),config.windowConfiguration.getWindowingMode());...代码省略...}//销毁Activity的核心方法void performDestroyActivity(ActivityClientRecord r, boolean finishing,int configChanges, boolean getNonConfigInstance, String reason) {...代码省略...//从map缓存中移除activity对应的窗口模式信息mLastReportedWindowingMode.remove(r.activity.getActivityToken());...代码省略...}/*** 有必要的话将会调用窗口模式发生变化的回调方式*/private void handleWindowingModeChangeIfNeeded(Activity activity,Configuration newConfiguration) {final int newWindowingMode = newConfiguration.windowConfiguration.getWindowingMode();final IBinder token = activity.getActivityToken();final int oldWindowingMode = mLastReportedWindowingMode.getOrDefault(token,WINDOWING_MODE_UNDEFINED);//窗口模式没有发生变化、直接返回if (oldWindowingMode == newWindowingMode) return;// PiP callback is sent before the MW one.if (newWindowingMode == WINDOWING_MODE_PINNED) {//触发画中画模式变化回调方法activity.dispatchPictureInPictureModeChanged(true, newConfiguration);} else if (oldWindowingMode == WINDOWING_MODE_PINNED) {//触发画中画模式变化回调方法activity.dispatchPictureInPictureModeChanged(false, newConfiguration);}final boolean wasInMultiWindowMode = WindowConfiguration.inMultiWindowMode(oldWindowingMode);final boolean nowInMultiWindowMode = WindowConfiguration.inMultiWindowMode(newWindowingMode);if (wasInMultiWindowMode != nowInMultiWindowMode) {//如果旧的窗口模式和新的窗口模式，二者有其一不是多窗口模式，触发多窗口模式变化回调方法activity.dispatchMultiWindowModeChanged(nowInMultiWindowMode, newConfiguration);}//更新Map缓存中Activity对应的窗口模式信息mLastReportedWindowingMode.put(token, newWindowingMode);}
}    

• ActivityThread在启动Activity的时候，会将activity对应的窗口模式信息缓存到集合中
• 在handleWindowingModeChangeIfNeeded方法被调用的时候，会回调activity对应的回调方法，并更新activity对应的集合中的窗口模式信息
• ActivityThread在销毁Activity的时候，会将activity对应的窗口模式信息从集合中移除

3、继续来看下在ActivityThread中handleWindowingModeChangeIfNeeded方法是如何被层层调用的。

public final class ActivityThread extends ClientTransactionHandlerimplements ActivityThreadInternal {private Configuration performActivityConfigurationChanged(Activity activity,Configuration newConfig, Configuration amOverrideConfig, int displayId) {//调用handleWindowingModeChangeIfNeededhandleWindowingModeChangeIfNeeded(activity, newConfig);...代码省略...}private Configuration performConfigurationChangedForActivity(ActivityClientRecord r,Configuration newBaseConfig, int displayId) {r.tmpConfig.setTo(newBaseConfig);if (r.overrideConfig != null) {r.tmpConfig.updateFrom(r.overrideConfig);}//调用performActivityConfigurationChanged方法final Configuration reportedConfig = performActivityConfigurationChanged(r.activity,r.tmpConfig, r.overrideConfig, displayId);freeTextLayoutCachesIfNeeded(r.activity.mCurrentConfig.diff(r.tmpConfig));return reportedConfig;}public void handleActivityConfigurationChanged(ActivityClientRecord r,@NonNull Configuration overrideConfig, int displayId) {...代码省略...// Perform updates.r.overrideConfig = overrideConfig;final ViewRootImpl viewRoot = r.activity.mDecor != null? r.activity.mDecor.getViewRootImpl() : null;//调用performConfigurationChangedForActivity方法final Configuration reportedConfig = performConfigurationChangedForActivity(r,mConfigurationController.getCompatConfiguration(),movedToDifferentDisplay ? displayId : r.activity.getDisplayId());// Notify the ViewRootImpl instance about configuration changes. It may have initiated this// update to make sure that resources are updated before updating itself.if (viewRoot != null) {if (movedToDifferentDisplay) {viewRoot.onMovedToDisplay(displayId, reportedConfig);}//调用viewRootImpl的updateConfiguration方法，这里会触发Activity页面View内容的刷新变化viewRoot.updateConfiguration(displayId);}mSomeActivitiesChanged = true;}}

4、结合前面的分析，这里对Activity和多窗口模式相关方法的调用顺序做个简单梳理。

简单总结一下，系统是在ActivityThread的handleWindowingModeChangeIfNeeded方法中触发Activity的dispatchMultiWindowModeChanged，而该方法进一步调用Activity的onMultiWindowModeChanged来告知应用开发人员，Activity的多窗口模式发生了变化。

三、多窗口模式在ViewRootImp类中的主要调用

1、重新来看下ActivityThread的handleActivityConfigurationChanged方法，这次我们主要关注和ViewRootImpl的关系。

public final class ActivityThread extends ClientTransactionHandlerimplements ActivityThreadInternal {public void handleActivityConfigurationChanged(ActivityClientRecord r,@NonNull Configuration overrideConfig, int displayId) {...代码省略...// Perform updates.r.overrideConfig = overrideConfig;final ViewRootImpl viewRoot = r.activity.mDecor != null? r.activity.mDecor.getViewRootImpl() : null;//调用performConfigurationChangedForActivity方法，该方法最终会触发Activity的onMultiWindowModeChanged方法final Configuration reportedConfig = performConfigurationChangedForActivity(r,mConfigurationController.getCompatConfiguration(),movedToDifferentDisplay ? displayId : r.activity.getDisplayId());// Notify the ViewRootImpl instance about configuration changes. It may have initiated this// update to make sure that resources are updated before updating itself.if (viewRoot != null) {if (movedToDifferentDisplay) {viewRoot.onMovedToDisplay(displayId, reportedConfig);}//调用viewRootImpl的updateConfiguration方法，这里会触发Activity页面View内容的刷新变化viewRoot.updateConfiguration(displayId);}mSomeActivitiesChanged = true;}}

在调用performConfigurationChangedForActivity方法，该方法触发Activity的onMultiWindowModeChanged方法之后，会分别调用Activity对应的ViewRootImpl的onMovedToDisplay方法和updateConfiguration方法。

2、来看下ViewRootImpl的onMovedToDisplay方法和updateConfiguration方法。

public final class ViewRootImpl implements ViewParent,View.AttachInfo.Callbacks, ThreadedRenderer.DrawCallbacks,AttachedSurfaceControl {public void onMovedToDisplay(int displayId, Configuration config) {if (mDisplay.getDisplayId() == displayId) {return;}// Get new instance of display based on current display adjustments. It may be updated later// if moving between the displays also involved a configuration change.updateInternalDisplay(displayId, mView.getResources());mImeFocusController.onMovedToDisplay();mAttachInfo.mDisplayState = mDisplay.getState();// Internal state updated, now notify the view hierarchy.mView.dispatchMovedToDisplay(mDisplay, config);}public void updateConfiguration(int newDisplayId) {if (mView == null) {return;}// At this point the resources have been updated to// have the most recent config, whatever that is.  Use// the one in them which may be newer.final Resources localResources = mView.getResources();final Configuration config = localResources.getConfiguration();// Handle move to display.if (newDisplayId != INVALID_DISPLAY) {onMovedToDisplay(newDisplayId, config);}// Handle configuration change.if (mForceNextConfigUpdate || mLastConfigurationFromResources.diff(config) != 0) {// Update the display with new DisplayAdjustments.updateInternalDisplay(mDisplay.getDisplayId(), localResources);final int lastLayoutDirection = mLastConfigurationFromResources.getLayoutDirection();final int currentLayoutDirection = config.getLayoutDirection();mLastConfigurationFromResources.setTo(config);if (lastLayoutDirection != currentLayoutDirection&& mViewLayoutDirectionInitial == View.LAYOUT_DIRECTION_INHERIT) {mView.setLayoutDirection(currentLayoutDirection);}mView.dispatchConfigurationChanged(config);// We could have gotten this {@link Configuration} update after we called// {@link #performTraversals} with an older {@link Configuration}. As a result, our// window frame may be stale. We must ensure the next pass of {@link #performTraversals}// catches this.mForceNextWindowRelayout = true;requestLayout();//调用requestLayout触发窗口属性和视图的刷新}updateForceDarkMode();}}

3、ViewRootImpl的updateConfiguration方法会继续调用requestLayout方法，该方法会触发Activity对应的窗口属性和视图的刷新。