Jetpack+协程的WanAndroid客户端

2019 Java 开发者跳槽指南.pdf (吐血整理)….>>>


在此非常感谢鸿洋大神提供的 WanAndroid API

该项目基于「玩 Android 接口」接口,整体采用 MVVM, Android Jectpack, Retrofit, Kotlin 协程进行编写。是由 kukyxs 和 Taonce  一起编写完成,目前已完成所有的开发功能,细节有待调整。

起因

说起一起开源这个项目的初衷,总结来说是缘于学习和熟悉 Jetpack 和协程知识,结果在过程中一步一个雷,雷的体无完肤。从零到1.0版本诞生总共历时一个月,时间不算长但是收获很多,能进一步的对协程和 Jetpack 的使用加深理解,下面是该项目的地址,如果你对本项目感兴趣或者认为本项目还不错的还请点个 star:

CoroutinesWanAndroid 客户端:https://github.com/kukyxs/CoroutinesWanAndroid

1.0版本的诞生

项目于8月6日 released 1.0版本,实现了 WanAndroid API 的基本功能,8月8日优化体验之后,released 1.0.1版本。下面介绍下目前实现的功能:

  • 注册和登录

  • 首页最新博文和 Banner 图

  • 项目分类

  • 学习体系分类

  • 公众号分类和公众号文章列表

  • 文章详情查看

  • 文章收藏和取消收藏

  • TODO待办

  • 搜索功能

    以下是 WanAndroid 客户端的界面截图:

    Jetpack+协程的WanAndroid客户端
    入口页.png
    Jetpack+协程的WanAndroid客户端
    公众号文章列表.png
    Jetpack+协程的WanAndroid客户端
    首页-侧栏.png
    Jetpack+协程的WanAndroid客户端
    首页-公众号.png
    Jetpack+协程的WanAndroid客户端
    首页-项目分类.png
    Jetpack+协程的WanAndroid客户端
    首页-学习体系.png
    Jetpack+协程的WanAndroid客户端
    首页-最新博文.png
    Jetpack+协程的WanAndroid客户端
    搜索-结果列表.png
    Jetpack+协程的WanAndroid客户端
    搜索-历史记录.png
    Jetpack+协程的WanAndroid客户端
    文章详情.png
    Jetpack+协程的WanAndroid客户端
    我的待办-编辑.png
    Jetpack+协程的WanAndroid客户端
    我的待办-列表.png
    Jetpack+协程的WanAndroid客户端
    我的待办-筛选.png
    Jetpack+协程的WanAndroid客户端
    我的待办-新建.png
    Jetpack+协程的WanAndroid客户端
    我的收藏-网址.png
    Jetpack+协程的WanAndroid客户端
    我的收藏-文章.png

    技术点介绍

一、协程
用来代替 RxJava,处理异步操作,它可以让开发者体会到以同步的方式去实现异步操作。不过在该项目中有的地方还是结合了协程 + 回调的形式,蜜汁尴尬 ^-^,暂时没想到有什么好的解决方案。下面这段代码是通过协程 + Retrofit 进行网络请求。

1// 加载首页置顶文章
2suspend fun loadTops(): List<ArticleDetail>? = withContext(Dispatchers.IO) {                    RetrofitManager.apiService.topArticle(PreferencesHelper                                                                                                                                     .fetchCookie(WanApplication.instance)).data
3 }


二、Jetpack 系列

  1. DataBinding
    最大的好处就是大幅度的节约了UI控件的设置代码,不需要在 V 层去设置某个控件的点击事件或者属性等,我们可以更专注的去写业务逻辑代码。
    不过它的劣势也很明显,在 xml 文件中新增 DB 属性之后需要 build 下工程,假如出现错误了,有时候报错的信息也很模糊…
    下面的这段代码是通过 DataBinding 来绑定 RecyclerView 的点击、长按事件和 Adapter 属性,写起来非常舒服。

 1<?xml version="1.0" encoding="utf-8"?>
2<layout xmlns:android="http://schemas.android.com/apk/res/android"
3    xmlns:app="http://schemas.android.com/apk/res-auto"
4    xmlns:bind="http://schemas.android.com/apk/res-auto"
5    xmlns:tools="http://schemas.android.com/tools">

6
7    <data>
8
9        <variable
10            name="adapter"
11            type="androidx.paging.PagedListAdapter" />

12
13        <variable
14            name="itemClick"
15            type="com.kuky.demo.wan.android.base.OnItemClickListener" />

16
17        <variable
18            name="itemLongClick"
19            type="com.kuky.demo.wan.android.base.OnItemLongClickListener" />

20    </data>
21
22    <androidx.recyclerview.widget.RecyclerView
23        android:id="@+id/article_list"
24        android:layout_width="match_parent"
25        android:layout_height="match_parent"
26        android:adapter="@{adapter}"
27        android:orientation="vertical"
28        android:paddingTop="8dp"
29        android:paddingBottom="8dp"
30        android:scrollbars="vertical"
31        app:layoutManager="androidx.recyclerview.widget.LinearLayoutManager"
32        bind:hasFixedSize="@{true}"
33        bind:pageItemClick="@{itemClick}"
34        bind:pageItemLongClick="@{itemLongClick}"
35        tools:itemCount="20"
36        tools:listitem="@layout/recycler_home_article" />

37</layout>
  1. Lifecycle + ViewModel
    Lifecycle 可以对 Activity 或者 Fragment 的生命周期进行感应,ViewModel 继承了 Lifecycle 此特性,并且通过对内部不可见 Fragment 的持有,从而拥有屏幕在横竖屏切换的时候数据不丢失的特点。

  2. LiveData
    LiveData 在被推出的时候并不引人注目,总觉得他很鸡肋,它能实现的 RxJava 都能实现,相反并不可以。不过随着 LiveDataDataBindingPagingRoom 的原生支持,使它有了立足之地。通过和 DataBinding 的结合,可以达到数据变化后自动更新UI的操作,而且我们也可以在主线程或者子线程更新数据,只需要通过 setValue() 或者 postValue() 就能完成。
    这里就不列代码出来了,代码都是比较分散的,大家可以去项目中逐一查看。

  3. Paging
    一个能让 RecyclerView 连续加载的狂热分子,能让用户体会到丝滑般的滑动效果,并且它还可以直接结合 LiveDataDiffUtil 使用,更是香喷喷,无奈再香的东西它的坑还是存在的,你说你能结合 LiveData 使用是多么好的事,为啥在数据在返回的时候你传个空列表嘛意思么,延时去取数据?

 1var articles: LiveData<PagedList<ArticleDetail>>? = null
2fun fetchHomeArticle() {
3    articles = LivePagedListBuilder(
4        HomeArticleDataSourceFactory(repository),
5        PagedList.Config.Builder()
6            .setPageSize(20)
7            .setEnablePlaceholders(true)
8            .setInitialLoadSizeHint(20)
9            .build()
10    ).build()
11}

通过返回 LiveData 类型的值,然后再 observer{},这时候你就会不由自主的发出真香的感叹!

  1. Navigation
    Google官方**单 Activity 多 Fragment *的架构组件,为了让开发者更好的处理 `Fragment` 之间的跳转问题,项目一开始也是秉承着*单 Activity 多 Fragment **的原则去进行编写,在1.0之前都是采用的这种模式,不过在1.0.1版本将启动页换成了 Activity,原因在于无法处理启动白屏的问题。

1fun viewDetail(controller: NavController@IdRes id: Int, url: String) {
2    if (url.isBlank()) return
3    controller.navigate(id, Bundle().apply { putString("url", url) })
4

总结

如果你看到这里,那么对 CoroutinesWanAndroid 已经了解的差不多了,这个项目还是有很多新颖的知识点和技术,如果你对 Kotlin协程 或者 Jetpack 系列感兴趣的话,还是非常推荐你了解下这个项目。在了解的过程中,如若对项目存在什么疑问和见解,欢迎提出你的 Issues

Jetpack+协程的WanAndroid客户端

原文始发于微信公众号(Taonce):Jetpack+协程的WanAndroid客户端