本项目采用组件化+MVVM 架构进行开发,对功能组件和业务组件进行拆分,通过 ARouter 进行组件之间的通信。本文主要是对整个应用的技术架构作一个简单的介绍。
项目地址: https://github.com/winlee28/Jetpack-WanAndroid 欢迎 star
项目整体架构图:
https://i.imgur.com/iT1p6Xd.jpg
宿主 App 没有任何的业务代码,整个业务被拆分为各个 ft_lib 模块。对一些功能组件进行封装抽取为 lib,提供给上层依赖。ft_lib 之间没有任务依赖关系,通过 Arouter 进行通信。
首页分为 5 个 Tab,主要为首页、项目、导航、体系和我的。
整个页面框架使用 BottomNavigationView + Navigation 来搭建。通过 menu 来配置底部菜单。 通过 NavHostFragment 来配置各个 fragment 。系统提供的 FragmentNavigator 的 navigate 方法中是通过 replace 来加载 fragment 。 这就导致在切换 Tab 的时候 fargment 会重复的调用 onCreateView 方法。这肯定不是我们需要的。那么我们需要自定义自己的 FragmentNavigator 来替换系统 的,通过 show 和 hide 的方式来加载 fragment 。具体方式会在后续系列文章中进行讲解。
因为 App 使用了沉浸式状态栏,那么在使用的过程中也会出现只有第一个 fragment 的沉浸式是起作用的,其他的基本不生效。这个问题要从系统源码着手解决。 根本原因是这段代码:
private WindowInsets brokenDispatchApplyWindowInsets(WindowInsets insets) {
if (!insets.isConsumed()) {
final int count = getChildCount();
for (int i = 0; i < count; i++) {
insets = getChildAt(i).dispatchApplyWindowInsets(insets);
if (insets.isConsumed()) {
break;
}
}
}
return insets;
}
直接 break 了。所以我们也需要自定义一个 view 来重写 dispatchApplyWindowInsets 方法。具体也会在后续文章中进行讲解。
下面就简单介绍下各个 Tab 的技术要点。
首页主要分为顶部 Banner 和底部的文章列表。列表使用 Paging 加载。 并且封装了 AbsListFragment 和 AbsListViewModel 来快速搭建列表页面。 AbsListFragment 主要是封装了页面布局相关的元素。 AbsListViewModel 主要是封装了 paging 的一些常用配置等信息。 通过上述两个封装我们在开发列表页面的时候只需要关系 DataSource 和 adapter 即可。
项目 Tab 主要使用的是 TabLayout 和 ViewPager2 来配合实现联动。同样的 ViewPager2 的页面也是直接继承了 AbsListFragment 来实现列表页面。
导航页面主要分为顶部的搜索和底部的分类。点击搜索后打开新的页面。通过 fragment 来承载热门搜索和搜索返回结果。 底部的分类主要是通过 RecyclerView+ViewPager2 来实现的。通过设置 ViewPager2 的 orientation 为 ORIENTATION_VERTICAL 来实现列表滑动。
通过自定义 FlowLayout 来实现 Tag 标签管理。并进一步封装 TagFlowLayout 并对外提供 TagAdapter 来加载数据。
所有的下拉刷新换个下拉加载都是通过 SmartRefreshLayout 来实现的。通过阅读 Paging 源码我们了解到当请求数据返回空数据的时候,那么 Paging 就 不会继续帮我们来做分页加载了,默认会认为数据已经加载结束了。这个逻辑在实际开发中是有些问题的。所以就需要我们来返回空数据的时候手动来加载 分页逻辑。这里是通过自定义 DataSource 来完成。其实 Paging 框架只提供了加载数据的方式,在增加或者删除的逻辑目前都是不不支持的。这些都可以通过自定义 DataSource 来完成。具体也会在后续文章中进行讲解。
主要还是通过 Retrofit+协程来完成。整个应用的数据流向架构为:
https://i.imgur.com/NUojKeC.jpg
目前还未加缓存功能,后续会通过 room 来实现缓存功能。
组件通信主要是通过 Arouter 来实现的。通过提供的 IProvider 来定义 Service 来完成。Service 的实现定义在各自的 module 中。 并在 base 模块中定义 ServiceImpl 的包装类共调用方调用,这样对方就无需关心业务逻辑,直接使用即可。
因为 App 是采用 Kotlin 来开发的,所以 没有选择 dagger2 而是选择了 Koin,适用于 Kotlin 开发人员的实用轻量级依赖注入框架。 用纯 Kotlin 编写,无代理,无代码生成,无反射。
学习地址 : https://start.insert-koin.io/#/quickstart/kotlin
以上就是整个 App 功能的简单介绍,后续会单独讲解一些技术要点。
这是一个专为移动设备优化的页面(即为了让你能够在 Google 搜索结果里秒开这个页面),如果你希望参与 V2EX 社区的讨论,你可以继续到 V2EX 上打开本讨论主题的完整版本。
V2EX 是创意工作者们的社区,是一个分享自己正在做的有趣事物、交流想法,可以遇见新朋友甚至新机会的地方。
V2EX is a community of developers, designers and creative people.