继续创作,加速生长!这是我参加「日新方案 10 月更文挑战」的第7天,点击查看活动概况

Android 页面多状况布局办理的开发

一、现状

页面多状况布局是开发中常见的需求,即页面在不同状况需求显现不同的布局,完成的办法也比较多,最简略粗暴的办法便是在 XML 中先将不同状况对应的布局隐藏起来,根据需求改变其可见状况,如果多个界面公用相同的状况布局,缺陷也很明显,繁琐、重复、不高雅等,相似的完成也能够运用 ViewStub,这样性能会更好些。所以咱们要做的便是尽或许防止这些办法所导致的问题,愈加高效、高雅的办理不同的状况布局。

二、方针

咱们要完成的 StatusView 要完成的主要功能如下:

  • 可在 Activity、Fragment 、XML 中运用,可作用于XML的根布局View或其子View
  • 支撑默许的状况布局,可进行惯例装备
  • 可自定义状况布局
  • 状况布局懒加载,仅在初度显现时初始化

作用预览如下:

Android 页面多状态布局管理的开发

preview

三、完成

这里只对完成过程中一些比较重要的点进行分析。

3.1、初始化

首先有一个最重要的知识点需求明确,XML 布局中的每个View都有其对应的父 View,必然在其父View中都有固定的方位,如果是 Activity 对应的 XML,那XML根布局View的父View是谁呢?其实便是一个 id 为 android.R.id.content 的 View,如果是 Fragment 对应的 XML,那 XML 根布局 View 的父 View 能够经过 fragment.getView() 办法得到。所以现在咱们能够得到XML 中每一个View和对应的 LayoutParams 方位信息。

既然有了 View 和其对应的 LayoutParams 方位信息,就能够经过其父 View 将指定的子 View 移除去,然后将 StatusView 增加到被移除的 View 的方位,从而就能够控制 StatusView 来切换不同的状况布局。

简略总结下,便是用 StatusView 替换掉要进行多状况布局切换的 View,这个 View 能够时 XML 中的恣意 View。这也是直接在 Activity、Fragment 中运用 StatusView 要做的核心初始化作业。

那么 StatusView 又是个什么呢?其实便是一个承继了 FrameLayout 的 ViewGroup,之所以要承继 FrameLayout,因为 StatusView 此刻仅仅是作为父容器存在的,并不关怀内部各种状况 View 的具体情况,所以运用 FrameLayout 就够了,更有通用性。这样 StatusView 也就能够在 XML 中运用了

先将上边这部分内容转化成代码:

public class StatusView extends FrameLayout {
  ......
  /**
   * 在 Activity 中的初始化办法,默许页面的根布局运用多状况布局
   */
  public static StatusView init(Activity activity) {
    View contentView = ((ViewGroup) activity.findViewById(android.R.id.content)).getChildAt(0);
    return init(contentView);
  }
  /**
   * 在 Activity 中的初始化办法
   * @param viewId  运用多状况布局的 ViewId
   */
  public static StatusView init(Activity activity, @IdRes int viewId) {
    View rootView = ((ViewGroup) activity.findViewById(android.R.id.content)).getChildAt(0);
    View contentView = rootView.findViewById(viewId);
    return init(contentView);
  }
  /**
   * 在Fragment中的初始化办法
   * @param viewId  运用多状况布局的 ViewId
   */
  public static StatusView init(Fragment fragment, @IdRes int viewId) {
    View rootView = fragment.getView();
    View contentView = null;
    if (rootView != null) {
      contentView = rootView.findViewById(viewId);
    }
    return init(contentView);
  }
  /**
   * 用 StatusView 替换要运用多状况布局的 View
   */
  private static StatusView init(View contentView) {
    if (contentView == null) {
      throw new RuntimeException("ContentView can not be null!");
    }
    ViewGroup parent = (ViewGroup) contentView.getParent();
    if (parent == null) {
      throw new RuntimeException("ContentView must have a parent view!");
    }
    ViewGroup.LayoutParams lp = contentView.getLayoutParams();
    int index = parent.indexOfChild(contentView);
    parent.removeView(contentView);
    StatusView statusView = new StatusView(contentView.getContext());
    statusView.addView(contentView);
    statusView.setContentView(contentView);
    parent.addView(statusView, index, lp);
    return statusView;
  }
  ......
}

如果在 XML 中运用 StatusView 怎么进行初始化呢,自然是经过 onFinishInflate() 办法:


@Override
protected void onFinishInflate() {
  super.onFinishInflate();
  if (getChildCount() == 1) {
    View view = getChildAt(0);
    setContentView(view);
  }
}

3.2、状况布局的切换

StatusView 默许支撑 Loading、Empty、Error 三种状况布局,加上原始的页面内容布局,总共四种。切换状况布局时,咱们做法是直接从 StatusView 中移除去正在显现的状况布局,然后增加要显现的状况布局:

private void switchStatusView(View statusView) {
  if (statusView == currentView) {
    return;
  }
  removeView(currentView);
  currentView = statusView;
  addView(currentView);
}

3.3、状况布局的懒加载

APP运用环境杰出的情况下,有些状况布局或许根本没有显现的时机,如果在初始化时一股脑的加载出来自然不可取,影响性能,所以咱们要做的便是按需加载,即仅在状况布局初度显现时加载并初始化,之后复用即可:


private View generateStatusView(@LayoutRes int layoutId) {
    View statusView = viewArray.get(layoutId);
    if (statusView == null) {
      statusView = inflate(layoutId);
      viewArray.put(layoutId, statusView);
      configStatusView(layoutId, statusView);
    }
    return statusView;
  }

3.4、更自由的用法

一般的多状况布局办理都会供给默许的 Loading、Empty、Error 三种状况布局,并能够自定义对应的状况布局, 并供给对应的敞开 api。但这样会有些局限性,如果有其它事务场景的状况布局,尽管布局文件能够自定义,但原有的api办法调用起来难免会有违和感,并不友好!所以有必要在常用事务场景的基础上再供给愈加通用的api办法,并不局限于特定的场景。

目前的做法是用状况布局和对应的索引之间的联系来完成:


// 增加指定索引对应的状况布局
statusView.setStatusView(int index, @LayoutRes int layoutId)
// 为指定索引的状况布局设置初度显现的监听事件,用来进行状况布局的相关初始化
statusView.setOnStatusViewConvertListener(int index, StatusViewConvertListener listener)
// 显现指定索引的状况布局
statusView.showStatusView(int index)

3.5、注意事项

  • 当 Fragment 布局文件的根 View 运用 StatusView 时,为防止呈现的反常问题,主张在 XML 中初始化!
  • 当直接在 Fragment 中运用时,init()办法需求在onCreateView()之后的生命周期办法中履行!
  • 因为StatusView 承继自 FrameLayout,所以会多一层布局嵌套

主要的点就这么多了