Watch Star Fork

翔妖除魔 / ZhiHuDaily-SwiftSwift

个人练习swift用的 知乎日报的 IOS 客户端
克隆/下载
取消
提示: 由于 Git 不支持空文件夾,创建文件夹后会生成空的 .keep 文件
2015-10-18 16:02
Loading...
README.md 17.58 KB

JAVA程序猿一枚,开始学习Swift一个多月,以前没有iOS的经验.在看了官方的文档和老镇的豆瓣电台视频后,想自己做一个东西来练手,因此有了这个东西.说实话iOS开发和JAVA开发区别还是很大的,最简单的就是IDE用起来各种不顺手...就更别说语法,思维,理念上的差别了.这方面也是需要我认真学习的.

在做的过程中,遇到了很多的问题,没想到一个看似很简单的东西,真要给它做像了,还是比较麻烦的,要学习的东西很多. 我现在只能尽量的把样子做像了,代码这些一团糟,毫无章法可言,很多思维都还是JAVA的思维,希望各位大神不要耻笑.等以后接触多了后,再来重构吧.

因为我没有入手开发者账号,因此我只在模拟器中运行了,并且是 iOS8和iphone6的模式下测试.估计选择其他的是有问题的.不过,貌似Xcode7支持非开发者真机调试了,这真是令开发大快人心的大好事.到时候我再来尝试兼容ipad,估计要改很多的地方.

#Screenshot @新的截图太大(25MB),请点击此处查看

新增加了3D-Touch 功能:

alt text

#API 说明

  • API这里要感谢@izzyleung , 给予了很大的帮助,基本上就是把他的分析稍微有些修改.感谢@izzyleung! @izzyleung! @izzyleung!重要的事情要说三遍.
  • 知乎日报的消息以 JSON 格式输出
  • 网址中 api 后数字代表 API 版本,过高或过低均会得到错误信息
  • 较老的接口(启动界面图像获取,最新消息,过往消息)中将数字 2 替换为 1.2 获得效果相同,替换为 1.1 获得的是老版本 API 输出的 JSON 格式(替换为更低,如 1.0,或更高,如 1.3,将会获得错误消息)
  • 以下所有 API 使用的 HTTP Method 均为 GET

#API 分析

###1. 启动界面图像获取

  • URL: http://news-at.zhihu.com/api/4/start-image/{aspec}
  • start-image 后为图像分辨率,接受如下格式
    • 320*432
    • 480*728
    • 720*1184
    • 1080*1776
  • 响应实例:
{
	text: "© Fido Dido",
	img: "http://p2.zhimg.com/10/7b/107bb4894b46d75a892da6fa80ef504a.jpg"
	} 
  • 分析:
字段名 备注
text 供显示的图片版权信息
img 图像的URL地址

###2. 软件版本查询

  • Android:http://news-at.zhihu.com/api/4/version/android/2.3.0

  • IOS:http://news-at.zhihu.com/api/4/version/ios/{version}

  • URL 最后部分的数字代表所安装『知乎日报』的版本

  • 响应实例:

    • 软件为最新版本时:
     {
     "status": 0,
     "latest": "2.2.0"
     }
    
    • 软件为较老版本时:
     {
     "status": 1,
     "msg": "【更新内容】(后略)",
     "latest": "2.2.0"
     }
    
  • 分析:

字段名 备注
status 0 代表软件为最新版本,1 代表软件需要升级
latest 软件最新版本的版本号(数字的第二段会比最新的版本号低 1)
msg 仅出现在软件需要升级的情形下,提示用户升级软件的对话框中显示的消息

###3. 最新消息

  • URL:http://news-at.zhihu.com/api/4/news/latest
  • 响应实例:
{
	date: "20140523",
	stories: [
	{
	title: "中国古代家具发展到今天有两个高峰,一个两宋一个明末(多图)",
	ga_prefix: "052321",
	images: [
	"http://p1.zhimg.com/45/b9/45b9f057fc1957ed2c946814342c0f02.jpg"
	 ],
	type: 0,
	id: 3930445
	},
	...
	],
	top_stories: [
	{
	title: "商场和很多人家里,竹制家具越来越多(多图)",
	image: "http://p2.zhimg.com/9a/15/9a1570bb9e5fa53ae9fb9269a56ee019.jpg",
	ga_prefix: "052315",
	type: 0,
	id: 3930883
	},
	...
	]
	}
  • 分析
字段名 备注
date 日期
stories 当日新闻
-> title 新闻标题
-> images 图像地址(官方 API 使用数组形式。目前暂未有使用多张图片的情形出现,曾见无 images 属性的情况,请在使用中注意 )
-> ga_prefix 供 Google Analytics 使用
-> type 作用未知
-> id url 与 share_url 中最后的数字(应为内容的 id)
-> multipic 消息是否包含多张图片(仅出现在包含多图的新闻中)
top_stories 界面顶部 ViewPager 滚动显示的显示内容(子项格式同上)

###4. 消息内容获取与离线下载

  • URL:http://news-at.zhihu.com/api/4/news/{id}
  • 响应实例:
{
    body: "<div class=\"main-wrap content-wrap\">\n<div class=\"headline\">\n\n<div class=\"img-place-holder\"></div>\n\n\n\n</div>\n\n<div class=\"content-inner\">\n\n\n\n\n<div class=\"question\"> ... </div>",
    image_source: "Yestone.com 版权图片库",
    title: "瞎扯 · 如何正确地吐槽",
    image: "http://pic2.zhimg.com/9fe062c07b11959a2dd47068e116a9d5.jpg",
    share_url: "http://daily.zhihu.com/story/4760976",
    js: [],
    recommenders: [
        {
            avatar: "http://pic3.zhimg.com/449b2931521389e4fcbc31a0e2d9d896_m.jpg"
        },
        {
            avatar: "http://pic1.zhimg.com/4e45f545ee8b194476d3131ca7f3a9c8_m.jpg"
        },
        {
            avatar: "http://pic4.zhimg.com/6a682ab23_m.jpg"
        }
    ],
    ga_prefix: "052606",
    section: {
        thumbnail: "http://pic3.zhimg.com/a82322fc78dff305c3df43fcc4cb96c2.jpg",
        id: 2,
        name: "瞎扯"
    },
    type: 0,
    id: 4760976,
    css: [
        "http://news.at.zhihu.com/css/news_qa.auto.css?v=1edab"
    ]
}

*分析:

字段名 备注
body HTML格式的新闻内容
image-source 图片的内容提供方。为了避免被起诉非法使用图片,在显示图片时最好附上其版权信息。
title 新闻标题
image 获得的图片同 最新消息 获得的图片分辨率不同。这里获得的是在文章浏览界面中使用的大图。
share_url 供在线查看内容与分享至 SNS 用的 URL
js 供手机端的 WebView(UIWebView) 使用
recommenders 推荐者
-> avatar 推荐者的头像
ga_prefix 供 Google Analytics 使用
section 栏目
-> thumbnail 缩略图
-> id 栏目id
-> name 栏目名称
type 新闻的类型
id 新闻的 id
css 供手机端的 WebView(UIWebView) 使用

可知,知乎日报的文章浏览界面利用 WebView(UIWebView) 实现

  • 特别注意
    在较为特殊的情况下,知乎日报可能将某个主题日报的站外文章推送至知乎日报首页。

    • 响应实例:
     {
    

"theme_name": "电影日报", "title": "五分钟读懂明星的花样昵称:一美、法鲨……", "share_url": "http://daily.zhihu.com/story/3942319", "js": [], "ga_prefix": "052921", "editor_name": "邹波", "theme_id": 3, "type": 1, "id": 3942319, "css": [ "http://news.at.zhihu.com/css/news_qa.6.css?v=b390f" ] } ```

此时返回的 JSON 数据缺少 `body`,`iamge-source`,`image`,`js` 属性。多出 `theme_name`,`editor_name`,`theme_id` 三个属性。`type` 由 0 变为 1。

###4.5 新闻推荐者信息

  • URL:http://news-at.zhihu.com/api/4/story/#{id}/recommenders
  • 这个返回的就是某一篇新闻的推荐者的详细信息.
  • 响应实例:
{
    "items": [
        {
            "index": 1,
            "recommenders": [
                {
                    "bio": "",
                    "zhihu_url_token": "90b373201c03b47548dcac5832da1a95",
                    "id": 1162,
                    "avatar": "http://pic1.zhimg.com/f81b942d0_m.jpg",
                    "name": "Wang Chris"
                },
                {
                    "bio": "Phys2CS",
                    "zhihu_url_token": "d2facf05b7138a6eb4631a161915f7d4",
                    "id": 629,
                    "avatar": "http://pic3.zhimg.com/9dfd356e2f137540439448fa25ef0ea6_m.jpg",
                    "name": "Badger"
                },
                {
                    "bio": "",
                    "zhihu_url_token": "75a591efecfd4c22a6fc778a38a90f8d",
                    "id": 69,
                    "avatar": "http://pic1.zhimg.com/428ce35d11440c08c83f46dbfe435a5c_m.jpg",
                    "name": "One Two"
                },
                {
                    "bio": "重新做人",
                    "zhihu_url_token": "4d2540e03e0e5e225f4817f7ff7fc389",
                    "id": 7895,
                    "avatar": "http://pic3.zhimg.com/816934c948f5e3cc781ecda1ece08c3e_m.jpg",
                    "name": "王RRR"
                },
                {
                    "bio": "金融菜鸟 音乐草根 技能点加歪",
                    "zhihu_url_token": "b929aa5072baae224a74a18b5bd65376",
                    "id": 2576,
                    "avatar": "http://pic4.zhimg.com/1814a1b987a44cc49a448268412dbe23_m.jpg",
                    "name": "酷冰"
                },
                {
                    "bio": "你读书少,不骗你骗谁。",
                    "zhihu_url_token": "1cd7424d0a7990aaff8e2ed24644992a",
                    "id": 369,
                    "avatar": "http://pic3.zhimg.com/bbb689a7a_m.jpg",
                    "name": "卞卡"
                },
                {
                    "bio": "智商捉不了鸡",
                    "zhihu_url_token": "794c4d35096ad3dafb802124cdd83294",
                    "id": 5778,
                    "avatar": "http://pic4.zhimg.com/131bb14f5a12920afc975b3833538027_m.jpg",
                    "name": "二核桃"
                },
                {
                    "bio": "软件工程师",
                    "zhihu_url_token": "93ce68e327ef290f84192014bbc168b2",
                    "id": 6519,
                    "avatar": "http://pic2.zhimg.com/5d55b2e8d_m.jpg",
                    "name": "戴威"
                }
            ],
            "author": {
                "name": "灿妞儿"
            }
        },
        {
            "index": 2,
            "recommenders": [
                {
                    "bio": "",
                    "zhihu_url_token": "75a591efecfd4c22a6fc778a38a90f8d",
                    "id": 69,
                    "avatar": "http://pic1.zhimg.com/428ce35d11440c08c83f46dbfe435a5c_m.jpg",
                    "name": "One Two"
                }
            ],
            "author": {
                "name": "Badger"
            }
        }
    ],
    "item_count": 3
}
  • 分析:
字段名 备注
item_count 表示这篇日报里面有 几篇内容
items 表示推荐者信息
-->index 表示这个推荐信息对应的是日报中的第几篇内容
-->recommenders 推荐者信息
---->bio 推荐者的个性备注
---->zhihu_url_token 用户的token
---->id 用户id
---->avatar 用户头像
---->name 用户名
--> author 第几篇内容对应的作者
----> name 第几篇内容对应的作者的名字

###5. 过往消息

  • URL:http://news.at.zhihu.com/api/4/news/before/{date}
  • 若果需要查询 11 月 18 日的消息,{date}的数字应为 20131119
  • 知乎日报的生日为 2013 年 5 月 19 日,若 {date}数字小于 20130520 ,只会接收到空消息
  • 响应实例:
{
	date: "20131118",
	stories: [
	    {
	        title: "深夜食堂 · 我的张曼妮",
	        ga_prefix: "111822",
	        images: [
	            "http://p4.zhimg.com/7b/c8/7bc8ef5947b069513c51e4b9521b5c82.jpg"
	        ],
	        type: 0,
	        id: 1747159
	    },
	...
	]
}

格式与前同,恕不再赘述

###6. 新闻额外信息

  • URL: http://news-at.zhihu.com/api/4/story-extra/#{id}
  • 输入新闻的ID,获取对应新闻的额外信息,如评论数量,所获的『赞』的数量。
  • 响应实例:
{
"long_comments": 0,
"popularity": 161,
"short_comments": 19,
"comments": 19,
}
  • 分析:
字段名 备注
long_comments 长评论总数
popularity 点赞总数
short_comments 短评论总数
comments 评论总数

###7. 新闻对应长评论查看

  • URL: http://news-at.zhihu.com/api/4/story/#{id}/long-comments
  • 使用在 最新消息 中获得的 id,传入#{id},得到长评论 JSON 格式的内容
  • 最新的测试结果,一次只返回20条.找到显示全的方法了,调用 http://news-at.zhihu.com/api/4/story/#{id}/long-comments/before/#{lasetId} 就可以获取lasetId评论之前的的评论了,还是返回20个.不断的重复,就可以读取完成所有的评论
  • 响应实例:
{
	"comments": [
	    {
	        "author": "EleganceWorld",
	        "id": 545442,
	        "content": "上海到济南,无尽的猪排盖饭… (后略)",
	        "likes": 0,
	        "time": 1413589303,
	        "avatar": "http://pic2.zhimg.com/1f76e6a25_im.jpg"
	    },
	    ...
	]
}

*分析:

字段名 备注
comments 长评论列表,形式为数组(请注意,其长度可能为 0)
author 评论作者
id 评论者的唯一标识符
content 评论的内容
likes 评论所获『赞』的数量
time 评论时间
avatar 用户头像图片的地址

###8. 新闻对应短评论查看

  • URL: http://news-at.zhihu.com/api/4/story/#{id}/short-comments
  • 使用在 最新消息 中获得的 id,传入#{id},得到短评论 JSON 格式的内容
  • 最新的测试结果,一次只返回20条.找到显示全的方法了,调用 http://news-at.zhihu.com/api/4/story/#{id}/short-comments/before/#{lasetId} 就可以获取lasetId评论之前的的评论了,还是返回20个.不断的重复,就可以读取完成所有的评论
  • 响应实例:
{
	"comments": [
	    {
	        "author": "Xiaole说",
	        "id": 545721,
	        "content": "就吃了个花生米,呵呵",
	        "likes": 0,
	        "time": 1413600071,
	        "avatar": "http://pic1.zhimg.com/c41f035ab_im.jpg"
	    },
	    ...
	]
}

格式与前同,恕不再赘述

###9. 主题日报列表查看

{
    "limit": 1000,
    "subscribed": [],
    "others": [
        {
            "color": 15007,
            "thumbnail": "http://pic3.zhimg.com/0e71e90fd6be47630399d63c58beebfc.jpg",
            "description": "了解自己和别人,了解彼此的欲望和局限。",
            "id": 13,
            "name": "日常心理学"
        }
        ...
    ]
}
  • 分析:
字段名 备注
limit 返回数目之限制(仅为猜测)
subscribed 已订阅条目
others 其他条目
-> color 颜色,作用未知
-> thumbnail 供显示的图片地址
-> description 主题日报的介绍
-> id 该主题日报的编号
-> name 供显示的主题日报名称

###10. 主题日报内容查看

{
    "stories": [
        {
            "images": [
                "http://pic4.zhimg.com/fabeb6ece13d1b4f3fecd484f475feeb_t.jpg"
            ],
            "type": 2,
            "id": 4759968,
            "title": "你的密码保护问题真的安全吗?"
        },
        {
            "images": [
                "http://pic2.zhimg.com/969a13db3fad18b1d35ce9d3e2633ef1_t.jpg"
            ],
            "type": 2,
            "id": 4745004,
            "title": "当DNS泄漏让VPN不再安全,我们该怎么办?"
        },
 		...
    ],
    "description": "把黑客知识科普到你的面前",
    "background": "http://p4.zhimg.com/32/55/32557676e84fcfda4d82d9b8042464e1.jpg",
    "color": 9699556,
    "name": "互联网安全",
    "image": "http://p4.zhimg.com/30/6f/306f3ab291c415f40fe4485b75627230.jpg",
    "editors": [
        {
            "url": "http://www.zhihu.com/people/THANKS",
            "bio": "FreeBuf.com 小编,专注黑客与极客",
            "id": 65,
            "avatar": "http://pic4.zhimg.com/ecd93e213_m.jpg",
            "name": "THANKS"
        },
        {
            "url": "http://www.zhihu.com/people/____",
            "bio": "PKAV & Wooyun",
            "id": 38,
            "avatar": "http://pic1.zhimg.com/815b2ec82_m.jpg",
            "name": "长短短"
        },
        ...
    ],
    "image_source": ""
}
  • 分析:
字段名 备注
stories 该主题日报中的文章列表
-> images 图像地址(其类型为数组。请留意在代码中处理无该属性与数组长度为 0 的情况)
-> type 类型,作用未知
-> title 消息的标题
-> id 消息的id
description 该主题日报的介绍
background 该主题日报的背景图片(大图)
color 颜色,作用未知
name 该主题日报的名称
image 背景图片的小图版本
editors 该主题日报的编辑(『用户推荐日报』中此项的指是一个空数组,在 App 中的主编栏显示为『许多人』,点击后访问该主题日报的介绍页面,请留意)
-> url 主编的知乎用户主页
-> bio 主编的个人简介
-> id 数据库中的唯一表示符
-> avatar 主编的头像
-> name 主编的姓名
image_source 图像的版权信息

项目点评 ( 4 )

你可以在登录后,对此项目发表评论

6_float_left_people 6_float_left_close