Android Leanback结构源码简析

Leanback页面构建主要类

• BaseGridView 继承RecyclerView，重写所有焦点逻辑，Leanback页面根布局容器

---

• HorizontalGridView 继承BaseGridView，提供水平布局能力

---

• VerticalGridView 继承BaseGridView，提供垂直布局能力

---

• ArrayObjectAdapter 数据适配器，继承ObjectAdapter，内部可包含数据和视图结构内容信息

两个构造方法：

    // 一般用于每行或列数据的创建
    /**
     * Constructs an adapter with the given {@link PresenterSelector}.
     */
    public ArrayObjectAdapter(PresenterSelector presenterSelector) {
        super(presenterSelector);
    }

    // 一般为ItemBridgeAdapter创建构造参数时使用
    /**
     * Constructs an adapter that uses the given {@link Presenter} for all items.
     */
    public ArrayObjectAdapter(Presenter presenter) {
        super(presenter);
    }

---

• ListRow行视图提供者，Android原生封装好了，支持子视图焦点动效及行标题展示

---

• Presenter 提供视图创建及数据绑定，类似RecyclerView.Adapter的功能，注意是类似，下面的ItemBridgeAdapter才是填充到BaseGridView中真正的Adapter。目前暂且称之为视图加载器

    /**
     * Creates a new {@link View}.
     */
    public abstract ViewHolder onCreateViewHolder(ViewGroup parent);

    /**
     * Binds a {@link View} to an item.
     */
    public abstract void onBindViewHolder(ViewHolder viewHolder, Object item);

---

• PresenterSelector 根据不同的Item Object类型提供不同的Presenter对象，进行不同的布局视图创建和数据绑定，目前暂且称之为视图构造筛选器

    /**
     * Returns a presenter for the given item.
     */
    public abstract Presenter getPresenter(Object item);
    // 这个方法需要重写，根据item返回对应的presenter

    /**
     * Returns an array of all possible presenters.  The returned array should
     * not be modified.
     */
    public Presenter[] getPresenters() {
        return null;
    }
    // 这个方法需要返回所有的presenters数组，中途不可改变数据

---

• ItemBridgeAdapter 填充至BaseGridView的适配器，继承RecyclerView.Adapter

主要有两个构造方法，需要传递一个ObjectAdapter

    public ItemBridgeAdapter(ObjectAdapter adapter, PresenterSelector presenterSelector) {
        setAdapter(adapter);
        mPresenterSelector = presenterSelector;
    }

    public ItemBridgeAdapter(ObjectAdapter adapter) {
        this(adapter, null);
    }

---

基本使用(以VerticalGridView垂直视图为例)

1. 自定义Presenter，每一行的视图提供者

public class PresenterSample extends Presenter {
    // 创建BaseGridView中每一个Item的视图，如果使用ListRow则是创建每一行中的每一个Item视图
    @Override
    public ViewHolder onCreateViewHolder(ViewGroup parent) {
        return new HolderSample(...ItemView...);
    }

    // 数据绑定，item即是外层ArrayObjectAdapter中包含的数据类型
    @Override
    public void onBindViewHolder(ViewHolder viewHolder, Object item) {
        if (viewHolder instanceof HolderSample) {
            HolderSample holder = (HolderSample) viewHolder;
            if (item instanceof YourDataType) {
                bindDataWithViews()...
            }
        }
    }

    @Override
    public void onUnbindViewHolder(ViewHolder viewHolder) {
        releaseSource()...
    }

    // 自定义Holder，处理视图点击，焦点事件等
    static class HolderSample extends ViewHolder {
        HolderSample(View view) {
            super(view);
        }
    }
}

2. 构造每一行的数据

• ListRow方式构造

  // 构造一个ArrayObjectAdapter，填充一个Presenter
  ArrayObjectAdapter rowAdapter = new ArrayObjectAdapter(new PresenterSample());
  // 填充数据
  rowAdapter.add(...Data...);
  // 构造一个ListRow
  ListRow listRow = new ListRow(rowAdapter);
  

• 普通方式构造

  // 构造一个指定数据类型对象
  CustomData data = new CustomData();
  

3. 构造一个PresenterSelector

public class PresenterSelectorSample extends PresenterSelector {

    // 此处item就是外层ArrayObjectAdapter添加进来的数据，按添加索引排序
    @Override
    public Presenter getPresenter(Object item) {
        if (item.getClass == ListRow.class) {
            return new ListRowPresenter();
        } else if (item.getClass == CustomData.class) {
            return new PresenterCustom();
        } else {
            return ...
        }
    }

    @Override
    public Presenter[] getPresenters() {
        return mPresenters.toArray(new Presenter[]{});
    }

}

4. 构造一个ArrayObjectAdapter，装载垂直视图每一行的数据

    // 构建一个自定义的PresenterSelectorSample
    PresenterSelectorSample presenterSelector = new PresenterSelectorSample();
    // 构建一个装载每行数据的ArrayObjectAdapter
    ArrayObjectAdapter verticalAdapter = new ArrayObjectAdapter(presenterSelector);
    // 填充数据
    verticalAdapter.add(listRow);
    verticalAdapter.add(CustomData);

5. 构造一个ItemBridgeAdapter，填充给VerticalGridView

// 该Adapter只是作为一个桥梁作用，将每一行结构对应的presenter和data进行关联
ItemBridgeAdapter bridgeAdapter = new ItemBridgeAdapter(verticalAdapter);
VerticalGridView.setAdapter(bridgeAdapter);

---

至此，页面展示效果如下:

leanback1.png

---

源码分析

首先分析下非使用ListRow场景下视图的创建及数据绑定流程

• 首先看下ArrayObjectAdapter，它内部有个ArrayList