【原】博客园第三方客户端-i博客园App开源
本文转载请注明出处 —— polobymulberry-博客园
1.前言
目前i博客园App已经更新到2.0.0版本了，使用了最新的博客园Web API。相比于第一个版本，添加了很多新的功能，也修改了很多功能。整体来说改动比较大，代码也比较混乱。所以趁着清明假期，把代码好好整理了一番。目前基本的架构已成型（当然，后期还需要不断优化），但App基本功能方面还有很多需要添加的，后面会集中把App功能完善。
上面简单介绍了下目前App的情况，回到开源的话题来。开源这个App源码其实是我从一开始就有的愿景，不过当初代码很混乱，所以一直拖啊拖，中间也有很多实验室的事情，不过我一直也没放弃过要开源的这个想法。开源对我来说利大于弊的：
- 虽然我不是什么大牛，开源的代码也不是什么牛逼的项目。但是我觉得成为大牛总是有过程的，我希望我写博客或者开源代码可以记录下这些过程。很多牛人，比如说郭曜源大神（YYKit），等项目成熟了再一起发布出来。但是我观念不一样，我觉得开源代码也是一个产品，如果从做产品的思维来说，很重要的一点就是迭代开发，当我完成产品的基本功能后，我就应该去上线，和用户交流，再继续迭代开发下一版本的产品。目前我觉得我的代码整体架构差不多了，所以我觉得可以放到GitHub上了。
- 开源代码的目的主要还是为了想更多的人参与进来，本质也是为了督促自己学习。目前App功能还不完善，个人的力量也有限，希望能有更多的人加入进来，众人拾柴火焰高。
- 另外将自己的代码暴露出来，让大家批评指正，也是增强自己技术的有效途径。如果有幸能得到大神指点，那就一日千里了，哈哈（做梦吧你）！其实我觉得自己之前一直蒙头做自己的事，不和外界交流，这样不好，容易成为井底之蛙。
- 最后一个也是比较重要的——满足我的虚荣心（大家不要吝啬，多给我点小星星。哈哈，我就是这么不要脸！不要脸！要脸！脸！）
2.新版本i博客园App效果
之前版本的i博客园请移步《博客园第三方客户端-i博客园正式发布App Store》。因为换了新的Web API，所以增加了很多新功能，比如文库、登录等等。
| 博客 | 新闻 | 文库 |
 |
 |
 |
| 我-登录 | 我-非登录 | |
 |
 |
3. i博客园代码结构简介
3.1 代码整体结构
整体代码是按功能模块来划分的，而每个功能模块是按MVC来的（下面会介绍）。这里我一共分为7个模块：1.博客(Blog) 2.新闻(News) 3.文库(知识库Library) 4.闪存(暂时未实现,Flash) 5.我(Me) 6.引导页(Guide) 7.主要(Main)
3.2 各模块介绍
3.2.1 博客
博客的内容主要包括两部分，一个是首页，另一个精选。
首页部分使用的是简单的tableView，每个cell的类型就是放在BlogHomeTableViewCell目录下的ICBlogHomeTableViewCell。其中动态计算cell高度是使用了UITableView+FDTemplateLayoutCell这个库。精选部分使用了自定义collectionViewLayout，名叫ICBlogPickedCollectionViewLayout。另外，这两个部分放在了一个scrollView(ICBlogScrollView)中。
| 首页 | 精选 |
 |
 |
至于每个Blog的内容呈现，我使用的是KINWebBrowser库，而非使用从服务器端获取的JSON数据来解析，因为JSON解析的效果很差，还不如直接用Web浏览器显示好看。使用KINWebBrowser时，你只需双击页面，即可放大到最佳阅读模式，使用UIWebView无法做到这一点。
3.2.2 新闻
新闻的内容主要包括三个部分：最新(ICNewsNewestTableView)、推荐(ICNewsRecommendTableView)、热门(ICNewsHotTableView)。
三者都使用了tableView，放在一个scrollView(ICNewsScrollView)中。每个tableViewCell都是ICNewsTableViewCell类型。个人比较喜欢简洁风格。
不过新闻的内容显示，我是自己解析JSON数据进行排版的。自定义了一个ContentHTMLTemplateWithArgs的宏函数来构建HTML数据。
3.2.3 文库
基本同新闻，不过tableViewCell使用的是ICLibraryTableViewCell。
3.2.4 闪存(暂时未实现)
这一块后面会重点做一下，因为这是用户交流比较重度的一部分。
3.2.5.我
这一块做的比较久，UI相对来说比较复杂，另外也涉及到OAuth的知识。OAuth部分推荐dudu的OAuth系列博客。
Me这一块其实是由两个两部分组成，一个是登录部分，一个是个人中心部分。
**登录部分**
1.获取用户名和密码
2.将用户名和密码使用openssl进行rsa加密
3.再利用grant_type为password的OAuth认证方式来登录。
**个人中心**
我的博客和我的收藏都很简单，就是简单的tableView，连cell都没自定义。
设置部分功能就比较杂：
①清除缓存使用的是SDWebImage，异步清除，代码如下：
ICLog(@"size count : %ld",[[SDImageCache sharedImageCache] getSize]);
dispatch_async(dispatch_get_global_queue(DISPATCH_QUEUE_PRIORITY_DEFAULT, 0), ^{
[[SDImageCache sharedImageCache] clearDiskOnCompletion:^{
ICLog(@"清除成功");
ICLog(@"size count : %ld",[[SDImageCache sharedImageCache] getSize]);
cell.textLabel.text = [self getCacheSize];
}];
});
②关于部分是使用了CNPPopupController，之所以这个简单的功能也使用第三方库，是因为我还没想好怎么做这种弹窗后背景模糊的效果，后面会更换成自己的库。
③评价就很简单了，不赘述了。
④退出账号其实就是删除了本地存储的账号信息文件。
3.2.6 引导页
请参考我之前的博客《博客园第三方客户端-i博客园正式发布App Store》，此处就不赘述了。
3.2.7 主要(Main)
这部分内容很多，所以我分开来说，至于这里Helper和Tool有什么区别，大家请无视，本人经验尚浅，还回答不了。
3.2.7.1 Vender
存放的是openssl的rsa加密的算法。具体可以参见博客《RSA加密》。
3.2.7.2 Category
这个存放的东西就比较多了。我一直很认同田伟宇的一句话，category是典型的化继承为组合的方法。而且这里我尽量不会把强业务放在category中，我觉得category应该放一些弱业务的东西。
3.2.7.3 Helper
将dataSource从ViewController中分离，做到light View Controller。参考文章《更轻量的 View Controllers》。
3.2.7.4 Tool
**ICControllerTool**
主要是解决第一次安装，或者更新App后，应该先启动引导界面的问题。
**ICNetworkTool**
在AFNetworking上面分装了一层，不过此处我觉得设计的不是很好。暂时先这样，后面尝试下离散型API调用。
**ICOAuthTool/ICClientCredentialsOAuthTool**
因为网络请求的时候会用到各种access_token，比如grant_type为client credentials和grant_type为password/refresh_token的access token就不一样。
因此我定义了这两个Tool来管理相对的请求。对应的Model就是ICOAuth和ICClientCredentialsOAuth。
3.2.7.5 Controller
**ICLeftMenuViewController/ICLeftSideMenu**
因为使用了RESideMenu，所以ICLeftSideMenu其实就是RESideMenu的子类，而ICLeftMenuViewController其实就是RESideMenu的LeftMenuViewController。
3.2.7.6 Other
放AppDelegate和main。
3.2.7.7 View
ICLeftMenuHeaderView其实就是ICLeftSideMenu上的这个：
4.开源的相关事项
4.1 开源地址
GitHub：https://github.com/polobymulberry/iCnblogs
4.2 开源后的工作
- 闪存部分
- 目前其他部分只能查看，还不能评论，删除
- 搜索部分
- 分享功能
- refresh token不起作用
- 还有很多，想到了我就加到GitHub页面上……
4.3 开源注意事项
因为有些地方涉及到隐私，所以我会将代码进行脱敏（ClientID和ClientSecret）。大家下载以后不一定能直接运行。如果你感兴趣的话，可以去博客园申请一个ClientID和ClientSecret。
5. 感谢
感谢博客园的管理员的帮助和指导。