README

:point_left: HISTORICAL ISSUE AND THAT'S WHAT WE ALL KNOW :sob:



如果您想打赏我用爱发电的代码，可以点击这个链接帮我充电 ❤️：


如果你走失了，可以来TG群：https://t.me/wk8app

文档目录
==========

- 写在前面
- Repo目录说明
- App程序结构简明
  - 1.x 版本
    - 主要视图
    - 源代码结构
  - 0.5.2.1 典藏版
    - 预览图
    - 源代码结构
  - UMENG统计数据
- App存档文件结构
  - 总览
  - 存档流程
  - 技术细节
- App二次开发指引
  - 如何用其他文库的文档兼容本app
- 用到的开源库
- 开发者的碎碎念
- LICENSE


----


写在前面
==========

Material Design风格的轻小说文库App完全开源了！想实践Material Design的可以参考本项目的源代码，不清楚的、以及各种相关话题都可以发issue交流~

这个项目是我第一次写安卓App，首先看了一本入门书籍，是chinapub写书评赠送的《第一行代码 Android》，然后便开始着手写这个app了。从2014年10月份开始动手写，都是些零零散散的时间，写到12月底也就是0.5.2.0版本，那时基本上是啥都不会，写的代码也是烂的不行。后来内测用户群里面有个设计师提出来设计Material Design（后面简称MD）风格的app，于是就打算重新开发。也是拖啊拖，到7月底才完成新的app，如果满打满算的话，应该是历时一整个月，手写代码量2W行以上。

本app完全是出于兴趣以及作为一个项目经历，所以完全无偿开发、源代码也是完全开源！欢迎大家交流。之前迟迟不开源新的MD，一方面是觉得写得太不容易了，各种谷歌查资料，还为红杏插件贡献了好几十 \_(:3」∠)\_ 另一方面是正式用git管理，Wenku8的站长也禁止将API公开，所以分来两个版本管理也很麻烦，还有一方面是因为代码非常乱，没有整理。

注：1.x版本源代码有部分是拷贝0520的，而0520的风格非常糟糕，比如AsyncTask的isLoading定义在类外这样。所以编码风格会有不统一，新写的代码我还是比较满意的，老的代码也是因为修改的需求不大，所以也就没有重构了。编码风格的建议也欢迎发issue~

----

为什么App里面说要尽快缓存感兴趣的小说？为什么现在这么紧急地开放源代码？

请参阅文档末尾的开发者的碎碎念。


----


Repo目录说明
==========

1. design-source/

  设计师提供的app制作效果图，大家可以参考学习~

2. eclipse-android/

  0.5.1.0030版本的源代码（eclipse+ADT版本），这份源代码阉割了API部分，所以编译后也无法正常获取数据。

3. eclipse-android-old/

  0.5.2.1典藏版的源代码（Android Studio版本），完整从私有库里拷贝出来的。release版本和正式版发布地址一样。

4. graph-source/

  老版的制图源文件，当时自己弄得，完全就是随性而无章法 =。=

5. studio-android/

  1.x正式版的所有源代码存放处，MD风格的App完整源码，可编译通过并正常运行！（Android Studio版本）


----


App程序结构简明
==========

 1.x 版本

新版的MD风格App，设计图纸在design-source/，工程文件在studio-android/。

三方库的引用全部采用Gradle dependency，在混淆方面会直接忽略，加密强度低，不过开发起来各种方便~


 主要视图

- App启动界面



    Model & Controller: activity/WelcomeActivity.java
    View: layout/layout_welcome.xml

- 侧栏菜单栏



    Model & Controller: fragment/NavigationDrawerFragment.java
    View: layout/layout_main_menu.xml

- 最近更新列表




    Model & Controller: fragment/FavFragment.java
    Adapter: adapter/NovelItemAdapter.java
    View: layout/fragment_latest.xml

- 搜索界面





    搜索界面
      Model & Controller: activity/SearchActivity.java
      Adapter: adapter/SearchHistoryAdapter.java
      View: layout/layout_search.xml
    搜索结果界面
      Model & Controller: activity/SearchResultActivity.java
      Adapter: adapter/NovelItemAdapterUpdate.java
      View: layout/layout_search_result.xml

- 排行榜列表




    Model & Controller: fragment/RKListFragment.java
    Adapter: adapter/NovelItemAdapterUpdate.java
    View: layout/fragment_rklist.xml + (layout/fragment_novel_item_list.xml)s

- 本地书架（收藏）列表



    Model & Controller: fragment/FavFragment.java
    Adapter: adapter/NovelItemAdapterUpdate.java
    View: layout/fragment_novel_item_list.xml

- 小说详细信息





    Model & Controller: activity/NovolInfoActivity.java
    View: layout/layout_novel_info.xml

- 小说章节选择



    Model & Controller: activity/NovolChapterActivity.java
    View: layout/layout_novel_chapter.xml

- 左右滑动阅读引擎













    Model & Controller: reader/activity/Wenku8Re

Top issues

Latest release

1、量大、管饱的稳定性更新。
2、大量本地书架的更新，包括更快的同步、书架搜索等。
3、增加了更多调试信息，用于下个版本解决一些一直修不好闪退问题。
4、你们自己找找看~