一个简单的 GitHub iPhone 客户端:MrCode

jopen 9年前

MrCodeis a simple GitHub iPhone App that can cache Markdown content (include images in HTML) for read it later.

MrCode是一个简单的 GitHub iPhone 客户端,可以缓存项目中的 Markdown 渲染之后的 HTML 及其图片,方便稍后阅读。

MrCode命名源自 Mr. Robot(黑客军团,当时出了一两集就有人说是神剧的美剧)。

Why make this


最初目的是想在 iPhone 上读这本书 guidetodatamining,每一章都是 Markdown 格式,用 Safari 进行阅读,个人认为 GitHub 渲染后(包含代码)的 HTML 是阅读效果最好的。

虽然 iOctocatCodeHub 这些 App 已经有 GitHub 非常全面的功能,但缺少我想要的缓存功能。

因为这书每个章节很长,班车上半小时内看不完,为了减少手机流量消耗才打算做一个 App 在本地缓存 Markdown 文件渲染后的 HTML,以及 HTML 中的图片。

Features


  • 实现了简单易用的 GitHub API Client(基于 Safari 进行 OAuth 授权),官方提供的 octokit.objc 有点复杂
  • 不需要在应用内输入 GitHub 密码,只要跳 Safari 登录 GitHub 进行 OAuth 授权
  • 缓存 star 过的资源库以及自己的公开资源库
  • 可以 star / fork / watch 资源库
  • 缓存 .md 或 .markdown 文件的渲染后的 HTML 及其图片
  • 可以按语言/时间段查看 GitHub Trending(ThanksCodeHub提供的 GitHub-Trending

另外,整个应用全部使用 Storyboard 进行页面跳转的逻辑关系,UI 用 Masonry 库纯手工写布局。事实上这个应用没有大的难点,基本上全部是 UITableView 的简单使用,用 Masonry 简单布局 UITableViewCell。

一个简单的 GitHub iPhone 客户端:MrCode

将 HTML 中的image.src替换成原生进行下载并缓存是用了这篇文章(UIWebView与JS的深度交互)的思路和代码(需要一些修改)。

Screenshots


一个简单的 GitHub iPhone 客户端:MrCode

一个简单的 GitHub iPhone 客户端:MrCode

一个简单的 GitHub iPhone 客户端:MrCode

Build


Requirements

  • iOS 8.0+
  • Xcode 6.4+

Build to your device with Xcode 7

git clone然后打开MrCode.xcworkspace。

如果像我这样没有 Apple 开发者账号,直接使用 Xcode 7 连接上你的设备,简单设置一下就行(参考 Xcode 7 真机调试详细步骤)。

p.s. App 首次安装到设备之后,要在设置-通用-描述文件中信任你在 Xcode Accounts 的这个开发者。

(optional) Use your own GitHub application Client ID & Secret

目前源码已经包含可用的 Client ID & Secret,如果要改成你自己的,要在 GitHub Developer applications 创建新的 application,得到 Client ID & Secret 填到MrCode/MrCode/AppDelegate.m即可。

Issues


目前最初的主要功能已经够用(其实在实现的过程中已经花了太多时间调其他功能了),但还是有很多问题,例如:

  1. star 一个新的资源库时不会更新本地的缓存(技术问题,要修复比较繁琐),也没用 KVO / Notification 更新已经显示的 UI

  2. Model 类里面混用了类方法和成员方法

  3. 代码很烂,通用的 WebViewController 为了便捷耦合了不该有的属性

  4. 原生下载图片缓存后,用 JS 更新 WebView 的 HTML 有时不会生效(返回并重新进入没问题)

  5. more...

Thanks


Thanks to these powerful projects.

  • CocoaPods
  • AFNetworking
  • MJExtension
  • OcticonsIOS
  • Masonry
  • UITableView+FDTemplateLayoutCell
  • DateTools
  • SDWebImage
  • ChameleonFramework
  • YTKKeyValueStore
  • MJRefresh
  • MBProgressHUD
  • WebViewJavascriptBridge
  • MMPopupView
  • KxMenu

项目主页:http://www.open-open.com/lib/view/home/1444547874232