真香警告:即使不用饿了么订餐,也请务必收藏好该库!

由来

LinkageRecyclerView 是一款基于 MVP 架构开发的二级联动列表控件。它是因 “RxJava 魔法师” 这个项目的需求而存在。

在最初寻遍了 GitHub 也没有找到合适的开源库(高度解耦、可远程依赖)之后,我决心研究参考现有开源项目关于二级联动的逻辑,并自己动手编写一个 高度解耦、轻松配置、可通过 Maven 仓库远程依赖 的真正的第三方库。

LinkageRecyclerView 的个性化配置十分简单,依托于 MVP 的 “配置解耦” 特性,使用者无需知道内部的实现细节,仅通过实现 Config 类即可完成功能的定制和扩展。

此外,在不设置自定义配置的情况下,LinkageRecyclerView 最少只需 一行代码即可运行起来

RxMagic Eleme Linear Eleme Grid
7.gif 2.gif 3.gif

目标

LinkageRecyclerView 的目标是:一行代码即可接入二级联动列表

除了一键接入而省去 99% 不必要的、复杂的、重复的工作外,你还可以从这个开源项目获得的内容包括:

  1. 整洁的代码风格和标准的资源命名规范。
  2. MVP 架构在编写第三方库的最佳实践:使用者无需了解内部逻辑,通过实现接口即可轻松完成个性化配置
  3. 优秀的代码分层和封装思想,在不做任何个性化配置的情况下,一行代码即可接入。
  4. 主体工程基于前沿的、遵循关注点分离的 JetPack MVVM 架构。
  5. AndroidX 和 Material Design 2 的全面使用。
  6. ConstraintLayout 约束布局的最佳实践。
  7. 绝不使用 Dagger,绝不使用奇技淫巧、编写艰深晦涩的代码。

如果你正在思考 如何为项目挑选合适的架构 的话,这个项目值得你参考!

项目链接:https://github.com/KunMinX/LinkageRecyclerView

简单使用:

1.在 build.gradle 中添加对该库的依赖。

1
implementation 'com.kunminx.linkage:linkage-recyclerview:1.3.5'

2.依据默认的分组实体类(DefaultGroupedItem)的结构准备一串数据(以下以 JSON 为例)。

1
2
3
4
// DefaultGroupedItem.ItemInfo 包含三个字段:
String title //(必填)二级选项的标题
String group //(必填)二级选项所在分组的名称,要和对应的一级选项的标题相同
String content //(选填)二级选项的内容
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
[
{
"header": "优惠",
"isHeader": true
},
{
"isHeader": false,
"info": {
"content": "好吃的食物,增肥神器,有求必应",
"group": "优惠",
"title": "全家桶"
}
},
{
"header": "热卖",
"isHeader": true
},
{
"isHeader": false,
"info": {
"content": "爆款热卖,月销超过 999 件",
"group": "热卖",
"title": "烤全翅"
}
}
]

3.在布局中引入 LinkageRecyclerView 。

1
2
3
4
5
6
7
8
9
10
11
12
13
<?xml version="1.0" encoding="utf-8"?>
<LinearLayout
xmlns:android="http://schemas.android.com/apk/res/android"
android:layout_width="match_parent"
android:layout_height="match_parent"
android:orientation="vertical">

<com.kunminx.linkage.LinkageRecyclerView
android:id="@+id/linkage"
android:layout_width="match_parent"
android:layout_height="match_parent"/>

</LinearLayout>

4.在得到数据后,最少只需一行代码即可完成初始化。

1
2
3
4
List<DefaultGroupedItem> items = gson.fromJson(...);

//一行代码完成初始化
linkage.init(items);

注意:如使用 JSON,请在 ProGuard Rules 中为该实体类配置混淆白名单:

1
-keep class com.kunminx.linkage.bean.** {*;}

个性化配置:

项目链接:https://github.com/KunMinX/Linkage-RecyclerView

Your browser is out-of-date!

Update your browser to view this website correctly. Update my browser now

×