提供优质文章和福利的客户端:Gank

前言

很久之前就在关注代码家每日共享的学习资源,获益匪浅。

最近比较空闲,并且想自己构建一个完整项目,来了解自己的不足,刚好Gank提供了API,于是决定一试。

项目地址:TigerGank

效果展示

页面效果
首页效果 《提供优质文章和福利的客户端:Gank》
网络状态 《提供优质文章和福利的客户端:Gank》
每日详情 《提供优质文章和福利的客户端:Gank》

第三方库

项目框架

首先,整体的项目框架,采用MVP框架。

关于Android框架,还是比较自由的。根据需求去选择自己喜欢的框架就可以。

这里我想加深一下自己对MVP框架的理解,于是选择采用MVP框架。

关于MVC、MVP、MVVM的框架含义,可以参考此篇短文,言简意赅。

该项目的框架基本仿照Google开源的Android框架模板

虽然存在一些差异,不过大同小异。

BaseActivity

一个好的基类,可以大大减少后续的工作量。

首先,我们来稍微屡一下全局的要求:

  • 标题栏:基本所有页面都会有,但是有些页面可能需要定制化,甚至可能没有。

  • 页面控制:此处是一大头,包括Loading、无网、无数据、数据展示等多种页面样式以及展示逻辑。

综上,我认为我们需要为BaseActivity设置一个layout文件,它持有ToolBar和各个状态的页面UI,并且可以控制页面UI的展示时机。

在子Activity中,继承BaseActivity后只需设置数据UI的样式即可。

接下来我们就开始构建BaseActivity,首先来构建BaseActivity的layout:

<?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:background="@color/c_ffffff"
    android:orientation="vertical">

    <!--ToolBar-->
    <android.support.v7.widget.Toolbar
        android:id="@+id/toolbar"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:background="@color/c_3f51b5"
        android:minHeight="?attr/actionBarSize" />

    <FrameLayout
        android:layout_width="match_parent"
        android:layout_height="0dp"
        android:layout_weight="1">

        <!--Loading Page-->
        <include
            android:id="@+id/view_loading"
            layout="@layout/view_loading"
            android:visibility="gone" />

        <!--无数据 Page-->
        <include
            android:id="@+id/view_no_data"
            layout="@layout/view_no_data"
            android:visibility="gone" />

        <!--无网 Page-->
        <include
            android:id="@+id/view_no_net"
            layout="@layout/view_no_net"
            android:visibility="gone" />

        <!--数据 Page-->
        <FrameLayout
            android:id="@+id/view_data"
            android:layout_width="match_parent"
            android:layout_height="match_parent"
            android:visibility="gone" />

    </FrameLayout>

</LinearLayout>

可以看到,它包括了ToolBar、LoadingPage、无数据Page、无网Page以及数据Page。

接下来我们在BaseActivity中对控件进行初始化,开始书写页面状态的控制代码。

此处各位看官要有意识,这些控制代码,不应存在于BaseActivit中。

原因有很多,首先因为Activity是我们MVP的View层,它仅仅掌控UI变化的结果,而不应该持有UI变化的逻辑判断。其次,如果我们将来封装BaseFragment,难道需要将这些逻辑代码再写一遍应用至BaseFragment中吗?

所以这里我决定在BaseActivity中创建成员变量PageController。每个Activity都会有一个独立的PageController,它持有Activity,来通知Activity的UI变化,并且和Activity拥有相同的生命周期:

//页面状态控制器,每个页面持有一个,使用弱引用来持有Activity
//存在于BaseActivity中,无需手动控制,在页面销毁时自动释放
public class PageController {
    //Activity对象
    private WeakReference<BaseActivity> weakActivity;
    //当前页面状态
    private int currentState;

    public PageController(BaseActivity activity) {

        weakActivity = new WeakReference<>(activity);
    }
    //销毁方法
    public void onDestory() {
        if (weakActivity == null) {
            return;
        }
        weakActivity.clear();
        weakActivity = null;
    }
}

接下来就开始构建具体的页面控制逻辑。

这个逻辑因人而异,我这里就不介绍自己构建时的思路了,源码里的注释都有体现。

在完成PageController后,当你需要构建BaseFragment时,仅仅需要将fragment.getAcitivty()传递至PageController中,就可以使用PageController了。

网络请求

使用okhttp来作为本次开发的网络请求底层。

再好的框架,想要适应一个项目,必定需要进行定制化的封装。

在封装之前,先回想一下一次完整的网络请求,注意我们项目是MVP框架:

用户在Activity中发出请求—>调用Presenter层的网络请求方法->调用Model层的网络请求方法->传递给Presenter请求结果以及数据->传递给Activity结果以及数据

在MVP框架下,一次网络请求基本就是这样的了。
不过这就牵扯到框架问题了,我们先回到网络请求中,不去考虑框架。

如何最大限度的抽象,是我们现在要着重考虑的。

并且还要考虑并发、缓存、异步同步等一系列事情。

该项目的网络请求封装简直不忍直视,基本是本着能用就行的思想来进行封装的。。。

《提供优质文章和福利的客户端:Gank》

我发现此处是我的薄弱项,在将来有空时我会好好学习的。。。。

这里就不做过多介绍了,其实网上有很多基于okhttp封装相当好的网络请求框架,想使用的话也可以使用。

TODO

到目前为止,还有一些功能没有开发:

  • Activity切换动画

    Activity之间的切换看似一瞬间,其实我个人认为还是很重要的。上下配合的流程型页面应该使用左右横屏进入和关闭,给人一种流畅、步骤的感觉。两个毫无关联的页面,应该给人一种打开全新界面的动画感等等。

  • 搜索功能

    Gank的API中拥有搜索的API,该功能在后续会去实现。

  • 网络请求优化

    从该项目当中,我发现自己对网络请求的理解和Android文件存储的方式存在很多问题,等到有空,我会将网络请求这边重构,包括添加File缓存、异步同步请求、文件上传接收请求等一系列基本功能。

  • RxJava+Retrofit

    本项目当中没有使用RxJava。在后期有空我会重新再写一遍该项目,会使用RxJava和其他框架来实现,这算是立一个flag吧。

结语

这一周的精力除了完成本职工作外,基本上都放到了TigerGank中。

我会慢慢抽空继续完善该项目,这周就先这样了。

开发过程中遇到很多瓶颈,解决瓶颈的代码肯定是不优雅的。主要还是因为自己的水平太差。

一起加油,感兴趣的朋友也可以自己开发Gank。

感谢

上述所有第三方库

Gank API

    原文作者:黑色小老虎丶
    原文地址: https://www.jianshu.com/p/933059ff9139
    本文转自网络文章,转载此文章仅为分享知识,如有侵权,请联系博主进行删除。
点赞