按照惯例, 先上效果图
前言
做这个项目是因为刚好在逛博客园的时候看到一篇文章 博客园第三方客户端-i博客园正式发布App Store, 这里就帮忙贴下链接吧.
整个项目做下来大概做了半个月, 今天算是做出1.0版本, 已经贴上github(https://github.com/samAroundGitHub/CNBlog), 欢迎各路人士指导交流啦.
项目介绍
1. 工具和资料
博客园官方open web api网址:(再次感谢桑果, 因为我不会找api...(╮(╯▽╰)╭))
第三方框架 (这次主要想说不要用太多第三方, 所以为了开发效率只用了几个)
-
- SDWebImage
- MJRefresh
- SVProgressHUD
2. UI设计
这里就贴下我的一些UI杰作好了(^^)
项目中用到的UI, 像appIcon, LaunchImage, 还有一些占位图标我是自己做的(Sketch), 然后有一部分是http://www.easyicon.net上的, 还有一部分是以前项目的图标, 我也有从ituns下载app, 打开它的包想拿它的图片, 竟然没找到想要的那几个, 应该是发网络请求获取的吧.
不知道怎么获取app图片资源的, 这里推荐一个网址:iOS,如何模仿一个App
开发难点
1. 博客园api数据解析
博客园返回的数据是xml, 所以我选择用苹果官方自带的NSXMLParser进行解析, 为此我特地写了一个工具类(SMXMLParserTool), 这里介绍一下用法, 有需要的可以拖到你的项目自己就使用.
.h文件
+ (instancetype)sm_toolWithURLString:(NSString *)urlString nodeName:(NSString *)nodeName completeHandler:(void (^)(NSArray *contentArray, NSError *error))completerHandler;
- (instancetype)sm_initWithURLString:(NSString *)urlString nodeName:(NSString *)nodeName completeHandler:(void (^)(NSArray *contentArray, NSError *error))completerHandler;
@property (nonatomic, readonly, strong) NSArray *contentArray;
@property (nonatomic, strong) NSString *nodeName;
使用的时候只需要调用类方法, [SMXMLParserTool sm_toolWithURLString:...], 需要传入一个xml节点的名称, 比如博客园的xml节点结构如下的话,
<doc>
<feed>
<title>博客园_48小时阅读排行</title>
<id>d2e2f719-12cd-414e-ac2c-9d376c950c8a;id=...</id>
// 刷新时间
<updated></updated>
<entry> </entry>
<entry> </entry>
<entry> </entry>
</feed>
</doc>
// 博客信息
<entry>
// 文章id
<id></id>
// 博客题目
<title></title>
// 文章概述
<summary></summary>
// 发布时间
<published></published>
// 获取时间
<updated></updated>
// 发布人信息
<author>
// 姓名
<name></name>
// 博客首页
<uri></uri>
<avatar>
// 头像
<http/>
</avatar>
</author>
<link></link>
// 推荐人数
<diggs></diggs>
// 阅读过的人数
<views></views>
// 评论数
<comments></comments>
</entry>
你只要传入@"entry", 然后就会得到节点entry下以各子节点为key值为value的dictionary然后存入到contentArray, 在回调函数completeHandler中可以直接使用获得的数据contentArray. 如果解析过程发生错误, error信息会被打印到控制台.
2. 第二个难点还是博客园api的数据解析
因为博客园返回博客的文章格式是html格式的. 所以需要解析html语句. 这里我采用的方法是[UIWebView LoadHtmlString:..];
然后会发现解析完的页面图片会超出显示范围, 这是需要用到 [webView stringByEvaluatingJavaScriptFromString:..] 用javaScript改变图片大小
// 设置图片的宽高适应屏幕
[webView stringByEvaluatingJavaScriptFromString:[NSString stringWithFormat:
@"var script = document.createElement('script');"
"script.type = 'text/javascript';"
"script.text = \"function ResizeImages() { "
"var myImg,oldWidth,oldHeight;"
"var maxWidth=%f;"// 图片宽度
"for(i=0;i <document.images.length;i++){"
"myImg = document.images[i];"
"oldWidth = myImg.width;oldHeight = myImg.height;"
"var scale = oldWidth/oldHeight;"
"if(myImg.width > maxWidth){"
"myImg.width = maxWidth;myImg.height = maxWidth/scale;"
"}"
"}"
"}\";"
"document.getElementsByTagName('head')[0].appendChild(script);", kScreenW-20]];
[webView stringByEvaluatingJavaScriptFromString:@"ResizeImages();"];
这样就可以把超过的图片显示到你要的范围内了.
3. 第三个难点还是博客园api数据解析
这次是为什么这样说呢? 因为如果你要点击webView下的图片有响应, 还得再次用到刚刚的方法 [UIWebView LoadHtmlString:..];
默认的情况下点击是不会触发事件的, 所以要用javaScript让图片有onclick()方法, 然后改变document.loaction的值, 实现页面跳转, 在UIWebView代理方法 - (BOOL)webView:(UIWebView *)webView shouldStartLoadWithRequest:(NSURLRequest *)request navigationType:(UIWebViewNavigationType)navigationType; 下捕捉事件进行处理
// 添加图片的onclick方法
NSString *setImageOnclickString = [NSString stringWithFormat:
@"function setImageOnclick() {\
var imgs = document.getElementsByTagName('img');\
for(var i=0; i<imgs.length; i++) {\
imgs[i].onclick = function(){\
document.location = this.src;}}}"];
[webView stringByEvaluatingJavaScriptFromString:setImageOnclickString];
[webView stringByEvaluatingJavaScriptFromString:@"setImageOnclick()"];
我处理的方法是用苹果新的内嵌SFSafariViewController实现跳转, 这样的好处是直接可以在app内享有safari自带的功能, 比如保存图片, 进入阅读模式等等, 而且还是在app内没有离开你的app. 使用SFSafariViewController前需要 #import <SafariServices/SafariServices.h>
4. 第四个难点依然是博客园api数据解析
醉了, 是不是. 哈哈. 不过这次我说的难点是在逻辑上不是在技术上的. 获取数据的数目上下拉的获取多少数据, 总共有多少数据, 不一次性获取数据的情况下每次获取多少数据可以避免流量浪费, 反正是一系列逻辑上要解决的问题, 由于情况很多, 我就不贴代码了, 有遇到问题再交流交流.
5. tarBarHideWhenPush
终于第五个难点不是api数据解析了, 但是其实tarBarHideWhenPush也不算难点, 只是会经常走弯路, 当UITabBarViewController嵌套UINavgationController附加有UIViewController, 反正关系一复杂起来, 就会发现很多人问hidesBottomBarWhenPushed = YES为什么不管用, 我也百度过试过很多方法, 比如
self.hidesBottomBarWhenPushed = YES;
[self.navigationController pushViewController:.. animated:YES];
self.hidesBottomBarWhenPushed = NO;
再比如, 在viewDidappear中才加入 self.hidesBottomBarWhenPushed = YES. 反正就是很多说法, 但是都不怎么有效..
我独门的解决方法是在你要隐藏tarBar的VC中调用
// push后隐藏tabBar
- (BOOL)hidesBottomBarWhenPushed {
return YES;
}