Douya-master.zip

# 豆芽 [English version](README-en.md) > Douban, Yet Another. 另一个 Material Design 的豆瓣客户端。  <!--<a href="https://play.google.com/store/apps/details?id=me.zhanghai.android.douya" target="_blank" rel='nofollow' onclick='return false;'><img alt="Google Play" height="90" src="https://play.google.com/intl/zh_CN/badges/images/generic/zh-cn_badge_web_generic.png"/></a>--> 下载：[豆芽稳定版本](https://github.com/DreaminginCodeZH/Douya/releases/latest) [豆芽 CI 构建](https://github.com/DreaminginCodeZH/DouyaCiBuilds) [豆芽 API Key 设置向导](https://github.com/DreaminginCodeZH/DouyaApiKey) ## 部分特性 - Material Design - 首页友邻广播 - [启动速度优化](#启动速度) - [界面动画](#界面动画) - [支持屏幕旋转](#屏幕旋转) - [平板多列视图](#平板适配) - 支持使用 Custom Tabs 打开网页 - 支持切换长/短链接显示 ## 预览 图片： <p> </p> 视频： - [优酷链接](http://v.youku.com/v_show/id_XMTQyMDE5ODk0MA==.html) - [Vimeo 链接](https://vimeo.com/156952508) ## 关于名字 豆芽的名字取自“Douban, [Yet Another](https://en.wikipedia.org/wiki/Yet_another)”的缩写和中文词语“豆芽”的拼音正好相同的巧合。 取名之后，我才得知豆瓣的 Windows Phone 客户端的名字也叫做“豆芽”。所以相对于豆瓣官方应用“[一个叫‘豆瓣’的App](http://blog.douban.com/douban/2014/08/08/2897/)”，也正好将这个应用称为“另一个叫豆芽的应用”了。 ## 为什么要有豆芽？ > 直接访问豆瓣的所有人里，最普遍而一致的用法是围绕电影、电视、书、唱片、活动(我们叫做”条目”的东西)的评分评论、发现和讨论。我们会把和网站同步的评分评论作为一个起点和基础，在手机上重新构建围绕个人兴趣的发现和讨论。 > > 一个叫“豆瓣”的App——豆瓣日志 豆瓣从来不是一个单一的网站，而对于豆瓣的用法自然不尽相同。使用豆瓣是为了获取信息，但信息的获取是基于条目和算法，还是基于友邻和人，这个问题在豆瓣的多次改版中大概一直悬而未决。 这次，一个叫“豆瓣”的应用选择的是基于条目的推荐。但我个人作为一个重度豆瓣用户，重视的却恰好是基于人的推荐，喜欢的是友邻间的鸡犬相闻，以及闲逛时从条目评论、广播、日记中发现新友邻的惊喜。正如我在某次“还我旧版”运动中听到的声音，“不管怎么改版，只要友邻们还在就好”，改版是豆瓣不断良好发展的必经之路，但这句话中对友邻的珍重又令我感受到了豆瓣最宝贵的特质。 豆瓣作为一个工具的价值可以通过条目很好体现，但豆瓣作为一个独一无二的社区，只能通过它独有的、克制的、以人为本的方式才能维系。作为一个普通但也深爱豆瓣的用户，我希望豆瓣在这个方向上也不要失落，因为一个只有工具属性的网站对我而言将再也没有这样的归属感。 我在这一点上与豆瓣应用有了不同的追求，并且恰好有一些这方面的能力，又恰好豆瓣提供了开放的 API，于是就想要将这个想法实现出来了。 选择开始豆芽这个项目，还有一个原因是我希望在豆瓣继续看到平台原生的设计。 豆瓣广播在几年前就已经是国内少有的几个 Android Design 的应用，这一点一直令我钦佩和喜爱。在豆瓣应用最开始的版本中，也曾有过 Material Design 的尝试，但随着和 iOS 风格设计的杂糅，逐渐显得不合时宜，以至于最终选择了完全的 iOS 风格。我对此一直感到有些遗憾，况且 Material Design 也是一款更加优秀的设计语言。所以，我希望实现未能见到的另一种可能性。 ## 指导原则 豆芽的最终目标是为豆瓣中基于友邻的信息获取方式提供在移动端的便利。为了优雅地实现这个目标，豆芽将主要遵循以下的原则： - 遵循 Material Design 规范，且指导思想优先于细节规定。 - 像素完美，但更注重以人为本。 - 实现精确，代码可以自我辩护。 - 行为合格，支持屏幕旋转和平板布局。 - 功能崇尚简约，不打扰用户。 - 行为默认值合理，且用户可调节。 - 积极表现豆瓣特性，如广播、友邻、豆邮等。 - 通过细节设计，提倡用心、考虑到他人的内容。 规则可以被打破，但前提是理解规则。 ## 功能架构 豆芽的架构将与当前网站的设计十分类似。 你可能会问，难道豆芽只是要做一个豆瓣网站的移动端界面么？并非如此。豆芽的最终目标是为基于友邻的信息获取方式提供便利，所以架构设计也是为此服务。而架构与当前网页端设计基本相同，则是因为现在网页端正是一个符合这个目标的设计，并且与移动端的导航也可以很好地契合。 让我们详细地规划一下豆芽吧。 导航采用抽屉一级导航 + 选项卡二级导航的方式。工具栏上将显示全局的动作。 - 工具栏 - 提醒：所有类别的提醒，可以查看历史提醒 - 豆邮：用户间的邮件往来，希望鼓励郑重而非聊天。 - 搜索：立即访问想要的内容。 - 用户：点击后显示个人页面，相当于“我的豆瓣”。 - 首页 - 友邻广播：友邻互动、友邻推荐、系统定制的推荐。 - 九点：友邻的日记、博客文章等，有深度的内容。 - 一刻：全站范围的热门内容推荐。 - 同城：基于地理位置的内容。 - 线上活动：基于共同兴趣的内容。 - 读书 - 分类浏览、首页推荐：入口，以及最有可能发现新内容的地方。 - 我读：管理自己的读书标记、创造内容。 - 动态：查看友邻的阅读动态，互动、获得推荐。 - 豆瓣猜：基于算法的推荐。 - 电影 - 类似读书。 - 音乐 - 类似读书。 - 设置：提供应用设置等。 在子页面设计中，豆芽将尽量鼓励长内容和用心的互动。因为我相信只有豆瓣值得这样尝试。 ## 实现状况 我在最初的二十天内冲刺实现了应用的网络层、账户系统等基础架构，和查看友邻广播需要的大部分功能，大约 8000 行代码。 在接下来的八十天中，由于课业、其他事情和速度瓶颈，实现过程有所减慢。但是，应用的细节功能和界面交互都正在不断地被实现和优化。代码量达到了 14000 行，同时为此应用而写作的多个开源库的数千行代码并没有被计入。 此后项目经历了大型的重构，以适应代码复用和支持屏幕旋转的需求。在此之后，我得以实现了一个较为美观的个人资料页，并且对应用的许多细节进行了完善。 目前实现了原“豆瓣广播”应用的大部分功能。剩下的工作也正在继续进行中。 ## 实现架构 ### 数据层面 应用除了对少数内容进行缓存，其他内容均直接从网络获取。 - 基于 Android 账户系统提供用户账户和身份认证。 - 使用 Retrofit 及部分自定义增强处理网络请求。 - 使用 Gson 自动填充数据模型�