Android Insets相关知识总结

ITYPE_STATUS_BAR,
ITYPE_NAVIGATION_BAR,
ITYPE_CAPTION_BAR,
ITYPE_TOP_GESTURES,
ITYPE_BOTTOM_GESTURES,
ITYPE_LEFT_GESTURES,
ITYPE_RIGHT_GESTURES,
ITYPE_TOP_TAPPABLE_ELEMENT,
ITYPE_BOTTOM_TAPPABLE_ELEMENT,
ITYPE_LEFT_DISPLAY_CUTOUT,
ITYPE_TOP_DISPLAY_CUTOUT,
ITYPE_RIGHT_DISPLAY_CUTOUT,
ITYPE_BOTTOM_DISPLAY_CUTOUT,
ITYPE_IME,
ITYPE_CLIMATE_BAR,
ITYPE_EXTRA_NAVIGATION_BAR

public boolean onStateChanged(InsetsState state) {
  boolean stateChanged = !mState.equals(state, true /* excludingCaptionInsets */,false /* excludeInvisibleIme */) || !captionInsetsUnchanged();
  if (!stateChanged && mLastDispatchedState.equals(state)) {
    return false;
  }
  updateState(state);

  boolean localStateChanged = !mState.equals(mLastDispatchedState,
      true /* excludingCaptionInsets */, true /* excludeInvisibleIme */);
  mLastDispatchedState.set(state, true /* copySources */);

  applyLocalVisibilityOverride();
  if (localStateChanged) {
    if (DEBUG) Log.d(TAG, "onStateChanged, notifyInsetsChanged, send state to WM: " + mState);
    mHost.notifyInsetsChanged();
    updateRequestedState();
  }
  return true;
}

WindowInsets calculateInsets（...）：基于当前source设置计算新的windowInsets
void processSource（InsetsSource source，...）: 根据计算值更新source值

private final InsetsState mLastState = new InsetsState(); //旧的InsetsState
private final InsetsState mState = new InsetsState(); //新的InsetsState

private boolean isAboveIme(WindowContainer target）// 判断当前窗口是否处在输入法窗口层级上
void onImeControlTargetChanged(@Nullable InsetsControlTarget imeTarget) //当输入法target 窗口发生变化触发
InsetsState getInsetsForDispatch(@NonNull WindowState target) //分发Insets 对Insets进一步更新（更新frame 或者visible）

private final @InternalInsetsType int mType;  //Insets类型 nav或者status或者...
private final Rect mFrame;  //代表Insets区域
private boolean mVisible;   //Insets可见性

public void setFrame(Rect frame)  //设置Insets大小
public void setVisible(boolean visible) //设置Insets可见性
private Insets calculateInsets(Rect relativeFrame, Rect frame, boolean ignoreVisibility)  //根据frame以及ignoreVisibility 计算Insets

protected boolean mRequestedVisible;  //单一Insets的可见性
private @Nullable InsetsSourceControl mSourceControl; // 持有InsetsSourceControl变量可以实现对单一InsetsSource的控制
protected final InsetsController mController; //所属的InsetController
protected final InsetsState mState;  //本地state

public void updateSource(InsetsSource newSource, @AnimationType int animationType)  //更新mstate中的source 主要更新frame
public void show(boolean fromIme) //显示Insets
protected void setRequestedVisible(boolean requestedVisible) //设置Insets的可见性
public void setControl(@Nullable InsetsSourceControl control,
    @InsetsType int[] showTypes, @InsetsType int[] hideTypes) //后面讲
public void hide() //隐藏Insets
boolean applyLocalVisibilityOverride() //主要更新state可见性
protected boolean isRequestedVisibleAwaitingControl() //判断当前Insets是否会在获得control时更新可见性，即判断是否存在pending show（如果是bars 该方法等同于isRequestedVisible）

private boolean mIsRequestedVisibleAwaitingControl;  //判断是否存在一个请求要让输入法显示出来（但是由于当前尚未获得control因此暂时无法实现这个操作）
void notifyHidden()  //控制IMM隐藏输入法
public @ShowResult int requestShow(boolean fromIme) //控制IMM显示输入法
public void removeSurface() //移除输入法的surface
- InsetsSourceControl
对InsetsSource的控制者，用来控制Insets的产生者，内部持有控制输入法动画的Leash
private final @InternalInsetsType int mType;  //InsetsSource类型
private final @Nullable SurfaceControl mLeash;  //播放动画需要的Leash ，app可以控制对其设置position实现位移动画
private final Point mSurfacePosition;  //当前leash(Surface)在屏幕中的position
- InsetsSourceProvider
他是特定InsetsSource在server端的控制者，他被称作provider是因为他提供InsetsSource给客户端（客户端通过InsetsSourceConsumer使用InsetsSource）

private InsetsControlTarget mImeTargetFromIme;  //输入法Insets的control（Insets需要有一个control，否则他就会失控 不可控制）
private Runnable mShowImeRunner;  //显示输入法线程
private boolean mIsImeLayoutDrawn; //输入法是否已经绘制完成

/*关键成员变量*/
InsetsState mState = new InsetsState();  //记录本地State （Client端的Insetsstate）
InsetsState mLastDispatchedState = new InsetsState(); //从system端传来的InsetsState
InsetsState mRequestedState = new InsetsState(); //发送给系统端的InsetsState
SparseArray<InsetsSourceConsumer> mSourceConsumers = new SparseArray<>(); //持有sourceConsumers

/*关键方法*/
public void applyImeVisibility(boolean setVisible) //更新输入法可见性
public void notifyFinished(InsetsAnimationControlRunner runner, boolean shown) //动画结束时回调方法
public void onControlsChanged(InsetsSourceControl[] activeControls) //当系统端分发新的Insets Controls时被调用
public boolean onStateChanged(InsetsState state) //Insets或者InsetsControl发生改变会调用
public void setSystemBarsBehavior(@Behavior int behavior)
public void setSystemBarsAppearance(@Appearance int appearance, @Appearance int mask)  //更改Systembar的表现行为
public void show(@InsetsType int types, boolean fromIme) //显示Insets
void hide(@InsetsType int types, boolean fromIme)  //隐藏Insets
private void updateState(InsetsState newState) //更新state
private void updateRequestedState() //如果Insets在client端发生改变再重新发送到server端
public void applyAnimation(@InsetsType final int types, boolean show, boolean fromIme)  //更新Insets动画

WindowState.java //属于Server端
void notifyInsetsChanged() {
  ProtoLog.d(WM_DEBUG_IME, "notifyInsetsChanged for %s ", this);
  try {
    mClient.insetsChanged(getInsetsState());
  } catch (RemoteException e) {
    Slog.w(TAG, "Failed to deliver inset state change w=" + this, e);
  }
}

ViewRootImpl#W
@Override
public void insetsChanged(InsetsState insetsState) {
  final ViewRootImpl viewAncestor = mViewAncestor.get();
  if (viewAncestor != null) {
    viewAncestor.dispatchInsetsChanged(insetsState);
  }
}

@Override
public void insetsControlChanged(InsetsState insetsState,
    InsetsSourceControl[] activeControls) {
  final ViewRootImpl viewAncestor = mViewAncestor.get();
  if (viewAncestor != null) {
    viewAncestor.dispatchInsetsControlChanged(insetsState, activeControls);
  }
}

case MSG_INSETS_CHANGED:
  mInsetsController.onStateChanged((InsetsState) msg.obj);
  break;
case MSG_INSETS_CONTROL_CHANGED: {
  mInsetsController.onStateChanged((InsetsState) args.arg1);
  mInsetsController.onControlsChanged((InsetsSourceControl[]) args.arg2);
  break;  //首先都会调用InsetsController的onStateChanged方法
}

public boolean onStateChanged(InsetsState state) {
  boolean stateChanged = !mState.equals(state, true /* excludingCaptionInsets */,false /* excludeInvisibleIme */) //判断client端state和传来的state是否一致
      || !captionInsetsUnchanged();
  //同时判断上次server端传来的state是否同当前传传来的state一致
  if (!stateChanged && mLastDispatchedState.equals(state)) {
    return false;
  }
  if (DEBUG) Log.d(TAG, "onStateChanged: " + state);
  updateState(state); 
  //判断client端本地state是否已经发生改变
  boolean localStateChanged = !mState.equals(mLastDispatchedState,
      true /* excludingCaptionInsets */, true /* excludeInvisibleIme */);
  //更新mLastDispatchedState 即更新server端传来的state
  mLastDispatchedState.set(state, true /* copySources */);
  //将更新apply到本地
  applyLocalVisibilityOverride();
  if (localStateChanged) {
    if (DEBUG) Log.d(TAG, "onStateChanged, notifyInsetsChanged, send state to WM: " + mState);
    //如果本地Insets发生改变了，通知server端Insets更改了
    mHost.notifyInsetsChanged();
    //更新传递给server端的InsetsState
    updateRequestedState();
  }
  return true;
}

public void onControlsChanged(InsetsSourceControl[] activeControls) {
  if (activeControls != null) {
    for (InsetsSourceControl activeControl : activeControls) {
      if (activeControl != null) {
        // TODO(b/122982984): Figure out why it can be null.
        mTmpControlArray.put(activeControl.getType(), activeControl);
      }
    }
  }

  boolean requestedStateStale = false;
  final int[] showTypes = new int[1]; //系统Insets会根据showTypes数组内的值去更新可见性
  final int[] hideTypes = new int[1];

  //遍历所有的SourceConsumer 更新system_server传来的InsetsSourceControl
  for (int i = mSourceConsumers.size() - 1; i >= 0; i--) {
    final InsetsSourceConsumer consumer = mSourceConsumers.valueAt(i);
    final InsetsSourceControl control = mTmpControlArray.get(consumer.getType());
    consumer.setControl(control, showTypes, hideTypes);
  }

  // Ensure to create source consumers if not available yet.
  //便利system_server传递来的InsetsSourceControl
  for (int i = mTmpControlArray.size() - 1; i >= 0; i--) {
    final InsetsSourceControl control = mTmpControlArray.valueAt(i);
    final @InternalInsetsType int type = control.getType();
    final InsetsSourceConsumer consumer = getSourceConsumer(type);
//如果consumer不存在会创建
    consumer.setControl(control, showTypes, hideTypes); //可以看到如果存在??赢得consumer 会调用setControl方法两次

   ...

  }
  mTmpControlArray.clear();
  
  //showTypes、hideTypes值会在setControl方法内进行修改
  int animatingTypes = invokeControllableInsetsChangedListeners();
  showTypes[0] &= ~animatingTypes;
  hideTypes[0] &= ~animatingTypes;

  //假设showTypes[0]=8 代表要显示输入法
  if (showTypes[0] != 0) {
    applyAnimation(showTypes[0], true /* show */, false /* fromIme */);
  }
  //假设hideTypes[0]=8 代表要隐藏输入法
  if (hideTypes[0] != 0) {
    applyAnimation(hideTypes[0], false /* show */, false /* fromIme */);
  }
  if (requestedStateStale) {
    updateRequestedState();
  }
}