文档目录 写在前面 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目录说明 design-source/ 设计师提供的app制作效果图，大家可以参考学习~ eclipse-android/ 0.5.1.0030版本的源代码（ eclipse + ADT 版本），这份源代码阉割了API部分，所以编译后也无法正常获取数据 eclipse-android-old/ 0.5.2.1 典藏版 的源代码（ Android Studio 版本），完整从私有库里拷贝出来的release版本和正式版发布地址一样 graph-source/ 老版的制图源文件，当时自己弄得，完全就是随性而无章法 == 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/Wenku8ReaderActivityV1.java View: layout/layout_reader_swipe_temp.xml + (layout/layout_reader_swipe_page.xml)s 上下滑动阅读引擎 Model & Controller: activity/VerticalReaderActivity.java View: layout/layout_vertical_reader_temp.xml 设置界面 Model & Controller: fragment/ConfigFragment.java View: layout/fragment_config.xml 源代码结构 studio-android/LightNovelLibrary/app/src/main | AndroidManifest.xml | +---assets/fonts | fzss-gbk.ttf 方正书宋GBK字体 | +---java/org/mewx/wenku8 | | MyApp.java 自定义Application为了全局获取Context | | | +---activity | | AboutActivity.java 关于界面 | | MainActivity.java 主界面 | | MenuBackgroundSelectorActivity.java 侧栏菜单背景选择界面 | | NovelChapterActivity.java 章节选择界面 | | NovelInfoActivity.java 小说信息界面 | | SearchActivity.java 搜索界面 | | SearchResultActivity.java 搜索结果框架界面 | | UserInfoActivity.java 用户信息界面 | | UserLoginActivity.java 用户登录界面 | | VerticalReaderActivity.java 上下滑动界面 | | ViewImageDetailActivity.java 查看大图界面 | | WelcomeActivity.java 启动界面 | | | +---adapter | | NovelItemAdapter.java 老版的小说项Adapter，每10项更新一次 | | NovelItemAdapterUpdate.java 更新的小说项Adapter，动态更新每一项 | | SearchHistoryAdapter.java 搜索历史Adapter | | | +---component | | PagerSlidingTabStrip.java 排行榜自定义的标签类 | | ScrollViewNoFling.java 可控滑动阻尼的ScrollView | | | +---fragment | | ConfigFragment.java 设置界面 | | FavFragment.java 本地书架框架 | | LatestFragment.java 最近更新 | | NavigationDrawerFragment.java 侧栏菜单 | | NovelItemListFragment.java 通用的小说列表界面（嵌入框架中） | | RKListFragment.java 排行榜框架 | | | +---global | | | GlobalConfig.java 全局设置（糟糕向），其中inAlphaBuild控制内测版/正式版 | | | | | \---api | | ChapterInfo.java 章节信息类 | | NovelItemInfo.java 小说信息类 | | NovelItemInfoUpdate.java 更新的小说信息类 | | NovelItemList.java 小说项列表类 | | NovelItemMeta.java 小说完整信息类 | | OldNovelContentParser.java 旧的小说内容解析器，解析成text和image | | UserInfo.java 用户信息类 | | VolumeList.java 卷信息类 | | Wenku8API.java API类 | | Wenku8Error.java 错误信息类，后期的编码中定义的 | | Wenku8Parser.java 通用项目解析器 | | | +---listener | | MyItemClickListener.java RecyclerView的单击监听接口 | | MyItemLongClickListener.java RecyclerView的长按监听接口 | | | +---reader 这边准备封装成的UniversalReaderActivity库的 | | +---activity | | | Wenku8ReaderActivityV1.java 左右滑动阅读界面 | | | | | +---loader | | | WenkuReaderLoader.java 小说载入类的抽象类 | | | WenkuReaderLoaderXML.java XML格式小说载入类 | | | | | +---setting | | | WenkuReaderSettingV1.java 阅读设置类V1 | | | | | +---slider 三方划屏库 | | | | SlidingAdapter.java | | | | SlidingLayout.java | | | | | | | \---base | | | BaseSlider.java | | | OverlappedSlider.java | | | PageSlider.java | | | Slider.java | | | | | \---view | | WenkuReaderPageBatteryView.java 电池View（未使用） | | WenkuReaderPageView.java 单页小说View（效率低） | | | +---service | | HeartbeatSessionKeeper.java 心跳包保持session类（未使用） | | | \---util | LightBase64.java 轻量级base64封装库 | LightCache.java 轻量级文件操作库（容易OOM） | LightNetwork.java 轻量级网络通信库（容易OOM） | LightTool.java 轻量级工具集合类 | LightUserSession.java 轻量级用户Session管理（包括账号密码加解密） | Logger.java 轻量级日志类（未使用） | \---res/ | ... 略 \ 0.5.2.1 典藏版 老版的App，启动和运行方面都比 MD 版本流畅，针对旧机型维护 Eclipse 版本源码见 eclipse-android/ 目录（非最新）， Android Studio 版本源码见 eclipse-android-old/ 目录（典藏版最新），老版的图片资源都是用Fireworks做的，源文件见 graph-source/ 目录 预览图 源代码结构 这边引入了不少三方库，但是方法笨拙，主要采用复制、合并源代码的方式，所以文件目录会比较乱但是加密强度高 _(:3」∠)_ 以后做商业软件还是建议这样操作，虽然麻烦，但是混淆之后烦的要命~ eclipse-android-old\LightNovelLibrary\src +---com | +---davemorrissey | | \---labs | | \---subscaleview 分部加载图片的库，查看大图防止OOM | | ImageViewState.java | | ScaleImageView.java | | SubsamplingScaleImageView.java | | | +---ecloud | | \---pulltozoomview 下拉放大的视图，设置界面用的小苹果~ | | IPullToZoom.java | | PullToZoomBase.java | | PullToZoomListView.java | | PullToZoomListViewEx.java | | PullToZoomScrollView.java | | PullToZoomScrollViewEx.java | | | +---facebook | | \---rebound 物理、动画库，用途忘记了 == 大半年没动了，好像是侧栏菜单用的 | | | AndroidSpringLooperFactory.java | | | BaseSpringSystem.java | | | OrigamiValueConverter.java | | | SimpleSpringListener.java | | | Spring.java | | | SpringConfig.java | | | SpringConfigRegistry.java | | | SpringListener.java | | | SpringLooper.java | | | SpringSystem.java | | | SpringSystemListener.java | | | SpringUtil.java | | | SteppingLooper.java | | | SynchronousLooper.java | | | | | \---ui | | SpringConfiguratorView.java | | Util.java | | | +---special | | \---ResideMenu 侧边滑动菜单iOS风格的 | | ResideMenu.java | | ResideMenuItem.java | | TouchDisableView.java | | | \---zcw | \---togglebutton iOS风格的切换按钮 | ToggleButton.java | +---me | \---imid | \---swipebacklayout 右滑返回layout | \---lib | | SwipeBackLayout.java | | Utils.java | | ViewDragHelper.java | | | \---app | SwipeBackActivity.java | SwipeBackActivityBase.java | SwipeBackActivityHelper.java | SwipeBackPreferenceActivity.java | +---org | \---mewx | \---lightnovellibrary | +---activity | | AboutActivity.java 关于界面 | | BookshelfFragment.java 本地书架 | | LibraryFragment.java 小说库（主界面入口） | | MainActivity.java 主界面 | | NovelImageActivity.java 看大图界面 | | NovelInfoActivity.java 小说信息界面 | | NovelListActivity.java 小说列表界面 | | NovelReaderActivity.java 阅读器界面（上下滑动） | | NovelSearchActivity.java 搜索界面 | | SettingFragment.java 设置 | | StartActivity.java 启动界面 | | Wenku8Fragment.java （未完成） | | | +---api | | Wenku8Interface.java 你懂的 | | | +---component | | | GlobalConfig.java 全局设置界面 | | | MyApp.java 用于获取Context的全局Application | | | NovelContentParser.java 小说内容解析器 | | | XMLParser.java XML解析器 | | | | | \---adapter | | EntryElement.java 书库分类项 | | EntryElementAdapter.java 书库分类项Adapter | | NovelContentAdapter.java 小说内容Adapter | | NovelElement.java 小说项 | | NovelElementAdapter.java 小说项Adapter | | NovelElementSearch.java 小说搜索项 | | NovelElementSearchAdapter.java 小说搜索项Adapter | | NovelIcon.java 小说封面 | | NovelIconAdapter.java 小说封面Adapter | | | \---util | LightBase64.java 轻量级Base64库 | LightCache.java 轻量级文件操作库 | LightNetwork.java 轻量级网络通信库 | \---uk \---co \---senab \---photoview 轻量级看图的View | Compat.java | DefaultOnDoubleTapListener.java | IPhotoView.java | PhotoView.java | PhotoViewAttacher.java | +---gestures | CupcakeGestureDetector.java | EclairGestureDetector.java | FroyoGestureDetector.java | GestureDetector.java | OnGestureListener.java | VersionedGestureDetector.java | +---log | Logger.java | LoggerDefault.java | LogManager.java | \---scrollerproxy GingerScroller.java IcsScroller.java PreGingerScroller.java ScrollerProxy.java UMENG统计数据（2015/10/01残念） 新版的app用户量10天增长到了1W用户量，全是托wenku8的福照现在的增长速度速度估计用户量峰值是3W左右 还有几个有趣的统计图分享一下： App存档文件结构 存档文件示例可以到 release 区下载查看~ 总览 sdcard/wenku8 +---cache 完全由UIL接管的图片缓存文件夹 +---custom 用户自定义文件夹，可以放入自定义侧栏壁纸、自定义阅读字体、自定义阅读背景 | .nomedia | +---imgs 小说封面 | .nomedia | *.jpg | \---saves 存档文件夹 | avatar.jpg 登陆后的头像 | bookshelf_local.wk8 本地书架 | cert.wk8 简单加密的登陆用户名和密码 | read_saves.wk8 旧版的上下滑动阅读进度存档 | read_saves_v1.wk8 新版的左右滑动阅读进度存档 | search_history.wk8 搜索历史存档 | settings.wk8 设置存档 | +---imgs 小说插图 | .nomedia | *.jpg | +---intro 小说信息 | *.xml | \---novel 小说正文 *.xml 存档流程 App开启后初始化UIL，接下来所有的图片都使用UIL载入，每次加载一个图片都会自动生成 cache目录 下的以CRC32为文件名缓存文件； App启动即读取 settings.wk8 ，每次设置被改变了也会立即保存设置； 进入小说信息界面，会自动保存当前小说的封面于 imgs目录 ； 小说的 收藏 功能会将aid写入 saves/bookshelf_local.wk8 ，取消收藏会取消写入并删除本地的相关xml内容（图片不会删除）； 小说的下载功能分为4种： 检查更新：仅更新当前小说在 saves/intro 中的文件，每个小说3个文件，更新后刷新Activity aid-intro.xml 小说信息摘要 aid-introfull.xml 小说完整介绍 aid-volume.xml 小说卷信息 更新下载：先更新当前小说在 saves/intro 中的文件，然后按照 aid-volume.xml 中的信息，下载小说具体内容（存在 saves/novel 中），每次下载完毕后检查xml中是否含有图片，如果有图片则插入下载图片的任务 （这就是为什么下载的时候进度条会跳变了 2331） ； 覆盖下载：与更新下载不同的是，这种方式是强制覆盖所有文件，而更新下载会跳过已下载的同名文件； 分卷下载：更新下载的分卷版； 小说在章节长按章节可以选择以下两种阅读引擎： 左右翻页引擎V1：进入时读取 saves/read_saves_v1.wk8 ，退出时保存进度； 上下滑动引擎（旧）：进入时读取 saves/read_saves.wk8 ，退出时保存进度； 调用搜索记录时会自动读取 saves/search_history.wk8 ，每次搜索一次即保存最新搜索记录； 用户登录后会生成 saves/cert.wk8 和 saves/avatar.jpg ，每次启动app时自动登陆；若未联网，点击头像或有访问请求时会自动登录；若登陆失败，会删除这两个凭据文件； 技术细节 主要是存档的实现和兼容存档的规范 saves/bookshelf_local.wk8 文件内容示例： 1098||1939||1924||1749||278 文件保存规则： 收藏只保存aid，aid之间用 || 分隔，读取时调用 str.split("\\|\\|"); ； 每个aid对应 saves/intro 目录下3个文件： aid-intro.xml 、 aid-introfull.xml 、 aid-volume.xml ，如果缺少一个文件的话则会忽略该aid对应的书，可以通过 检查更新 （下拉书架、小说信息界面的检查更新）来修复该错误； saves/read_saves.wk8 文件内容示例： 66761,,23799,,25575||66752,,134,,15090||63125,,1139,,3059|| 63126,,904,,2824||63127,,11299,,157217 文件保存规则： 上下滑动阅读存档基本元素是 cid,,position,,height ： cid: chapter id，对应 saves/novel 里面的文件名； position: 滚动的位置，当前屏幕顶部的位置(px)； height: ScrollView的总高度(px)； 每个基本元素之间用 || 分隔，读取时调用 str.split("\\|\\|"); ； 每次记录阅读的最底部位置，往下翻再上翻只记录最底下位置； 一个误判区是100px，如果不小心点进去再退出，则不会记录，只有翻过100px才会记录进度； 每一章一个记录，只添加不删除 = 加密流程： 1. 原文: str 2. 一遍加密: base64(str) 3. 大小写互转: switch(base64(str)) 4. 两遍加密: base64(switch(base64(str))) 5. 除了等号外，前后字符交换: swap(base64(switch(base64(str)))) 6. 三次加密: base64(swap(base64(switch(base64(str))))) 解密流程： 同理 App二次开发指引 本App目前决定暂停维护了…… 原因一方面是开发者自己要准备年底的研究生考试；另一方面也是 最主要 的方面，鹅厂大规模购置轻小说版权，这边有一些暂时不能公开的原因，总之本三方app得告一段落了，具体可以阅读 开发者的碎碎念 前几天我用HTTrack抓取了 lknovel.cn 的数据库，总共20G，太过于庞大，文件数20W，我的xp爬虫机已卡死但是由于服务器在国内，速度还不错，用1~2天扒完 后来我又尝试抓取 wenku8.com ，服务器在美国，这边 速度太慢 了，抓了一整天才1G，我估计wenku8的数据量大约有30G，实在hold不住 所以尽管API开源了，但是因为内陆速度实在太慢，我都没有兴趣抓取了，所以劝大家去抓其他站： linovel.com 可以用HTTrack设置总目录页面为入口，深度5，然后设定MAX 10000000，图片采用探索模式即可（一般的扒站工具抓不下来图片），服务器没有防护； lknovel.cn 可以用HTTrack设置章节页面及小说信息界面为入口（excel生成url即可），深度2，设定MAX 10000000，服务器没有防护 wenku8.com 速度太慢了，数据量还大，插图还在文末，没啥性价比，别抓了 也就是说以后本app将没有数据源了，如果想继续做app的话那就只能通过抓取html提纯的方式，如果有开发者感兴趣，想通过抓取的方式继续本app（比如说：可以同时抓取lknovel、linovel、wenku8的数据展示给用户），可以阅读下面的部分： 如何用其他文库的文档兼容本app 目前 wenku8 的书目2000不到，也就是说aid是4位数； linovel 、 lknovel 的aid也都是4位数，而且都没有 wenku8 的大，所以： 在aid方面，可以采取aid+10000000的方式，比如linovel的aid是+1000万，lknovel的aid是+2000万，这样本地书架的内容就错开了 在存档方面： aid-intro.xml 可以采取两种文件格式： 最小文件体：
[NOT MAINTAINED]轻小说文库(Wenku8)安卓版第三方公益App，Material Design风格、无广告、不盈利的轻小说阅读器(light novel reader)。 P.S. 下一代阅读器—— Project PRPR！已在设计中！欢迎关注以及建议！已获取一份wenku8数据，考虑小范围维护。 http://wenku8.mewx.org/
3997
来源：
Licence：
联系：
分类：
平台：
环境：
大小：
更新：
标签：
免费下载
×
温馨提示
请用电脑打开本网页，即可以免费获取你想要的了。
