AndroidTV leanbackライブラリ 導入

# leanbackライブラリとは
* Android Support Library の1つ
* TV アプリ開発において Google のガイドラインに則した標準的な UI/UX を実現する

![screen.png](https://qiita-image-store.s3.amazonaws.com/0/112602/87a88c87-0564-1e01-9b4b-70ade369bc47.png)
# 登場人物
![ss_20161114_151245.png](https://qiita-image-store.s3.amazonaws.com/0/112602/0276e817-c6cd-cd4b-4848-cb3e4a0c8c68.png)

幾つかのパッケージに大きく分かれているが利用側が意識して使うものは`app`と`widget`に纏められている

## app
* Fragment
    * leanback の UI は Fragment 単位で利用するため基本となる
* それぞれについて Fragment と SupportFragment の両方が用意されているため実質的にはここにある半分くらいの種類がある
* Baseクラスなども含まれるため主に使うものは数種類のみ

![ss_20161114_151305.png](https://qiita-image-store.s3.amazonaws.com/0/112602/e1708a36-2ea3-b8ba-6e11-76d734c65f3f.png)

## widget
大量にあるが理解するべき主なもののみに注目するとこれらは以下に分類される
それぞれについての役割については次項以降で述べる

* Adapter
* Presenter
* PresenterSelector
* View
* DataModel
    * Row
    * Action

![ss_20161114_151601_comined.png](https://qiita-image-store.s3.amazonaws.com/0/112602/18439a2a-2911-7d31-e0e1-288ee0bf5252.png)

# 構造
![screen.png](https://qiita-image-store.s3.amazonaws.com/0/112602/74f6cc8f-23d0-7fd9-085b-45e7f2d11e2f.png)

各 Fragment は View の繰り返し構造になっているのでイメージとしては RecyclerView に近い
RecyclerView での View のレンダリングを考えると、以下のようになっており Adapter の責務の範囲が広い

(図1)
![leanback001.jpg](https://qiita-image-store.s3.amazonaws.com/0/112602/17c794b7-c589-23ba-b901-b9267ccde676.jpeg)

従って例えば 何種類かの異なった View を Data の種類に応じて出し分けしようとすると以下のように Adapter が肥大化していく

(図2)
![leanback002.jpg](https://qiita-image-store.s3.amazonaws.com/0/112602/9c14a946-a945-e8e2-5a27-c3f02546ba33.jpeg)

一方 leanback ではMVPモデルを採用しており View をレンダリングする部分については Presenter として Adapter から独立している

(図3)
![leanback003.jpg](https://qiita-image-store.s3.amazonaws.com/0/112602/9816b157-53b9-253f-0887-15f64af883ca.jpeg)

Data の種類を見て表示を切り替える役割についても PresenterSelector という専用のクラスが用意されている
よって Adapter の役割は以下の２点のみになる

* あらゆる型の Data を受け取り、登録されている Observer に通知する
* 受け取った Data を内部で保持し、保持したデータ集合に対する外部からの add/remove/replace などの操作を処理する

但し用意されている Adapter をそのまま使う事が殆どであるためこれらを利用者が意識して実装する事は殆どない
各 View 毎の表示内容を調整したい時には、各 View とその View を扱う Presenter のみに着目すれば良いため、スコープを狭く修正ができる

# 実装イメージ

Googleが用意している以下のサンプルコードを元にして、先ずは実装をイメージだけしてみる

https://github.com/googlesamples/leanback-showcase/blob/master/app/src/main/java/android/support/v17/leanback/supportleanbackshowcase/app/grid/GridExampleFragment.java

ここでは Card を並べて垂直方向にスクロールしていく View を作りたいため、`app`パッケージの Framgent のうち`VerticalGridFragment`を利用する

![screen.png](https://qiita-image-store.s3.amazonaws.com/0/112602/4232fdcc-0890-3b22-eb62-3040307b7825.png)

leanback の Fragment を利用する際には常に以下のようなイメージになる

```java
public class MyFragment extends VerticalGridFragment {
    (略)
    setAdapter(Adapter);
    Adapter#add(DataA, DataB, DataC);
```

繰り返しの単純なデータを扱うために Adapter には一般的には ArrayObjectAdapter を用いる事が多い
また`図3`にあるように Adapter は PresenterSelector を内包するためこれを Adapter に渡してやる
すると上のイメージは以下のようになる

```java
ArrayObjectAdapter adapter = new ArrayObjectAdapter(PresenterSelector);
setAdapter(adapter);
adapter.add(DataA, DataB, DataC);
```

# 実際のソースコード
上でのイメージを踏まえて実際のソースコードを見てみる

```java
PresenterSelector cardPresenterSelector = new CardPresenterSelector(getActivity());
ArrayObjectAdapter mAdapter = new ArrayObjectAdapter(cardPresenterSelector);
setAdapter(mAdapter);

String json = Utils.inputStreamToString(getResources().openRawResource(R.raw.grid_example));
CardRow row = new Gson().fromJson(json, CardRow.class);
mAdapter.addAll(0, row.getCards());
```

PresenterSelector の中で Data の種類によって Presenter を出し分けしている (簡単のため一部省略)

```java
public class CardPresenterSelector extends PresenterSelector {
    @Override
    public Presenter getPresenter(Object item) {
        Card card = (Card) item;
        switch (card.getType()) {
            case SINGLE_LINE:
                presenter = new SingleLineCardPresenter(mContext);
                break;
            case VIDEO_GRID:
                presenter = new VideoCardViewPresenter(mContext, R.style.VideoGridCardTheme);
                break;
            case MOVIE:
            case MOVIE_BASE:
            case MOVIE_COMPLETE:
            case SQUARE_BIG:
            case GRID_SQUARE:
            case GAME: {
                presenter = new ImageCardViewPresenter(mContext, themeResId);
                break;
            }
            case SIDE_INFO:
                presenter = new SideInfoCardPresenter(mContext);
                break;
            case TEXT:
                presenter = new TextCardPresenter(mContext);
                break;
            case ICON:
                presenter = new IconCardPresenter(mContext);
                break;
            case CHARACTER:
                presenter = new CharacterCardPresenter(mContext);
                break;
            default:
                presenter = new ImageCardViewPresenter(mContext);
                break;
        return presenter;
    }
}
```

最後に各 Presenter の中で View をレンダリングしている (簡単のため一部省略)

```java
public class ImageCardViewPresenter extends AbstractCardPresenter<ImageCardView> {
    @Override
    protected ImageCardView onCreateView() {
        ImageCardView imageCardView = new ImageCardView(getContext());
        return imageCardView;
    }

    @Override
    public void onBindViewHolder(Card card, final ImageCardView cardView) {
        cardView.setTag(card);
        cardView.setTitleText(card.getTitle());
        cardView.setContentText(card.getDescription());
        int resourceId = getContext().getResources().getIdentifier(card.getLocalImageResourceName(), "drawable", getContext().getPackageName())
        Picasso.with(getContext()).load(resourceId).into(cardView.getMainImageView());
    }
}
```

# 纏め
今回はライブラリの中の登場人物の役割の理解と、実装をイメージする所まで
次回以降で詳細な実装について記述していきたい