fir-mac 开发笔记

练手 Cocoa 开发,开发并开源了一款 fir.im 的 Mac 客户端,此篇主要记录其开发历程,总结一下遇到的问题

缘由

某一天突然翻到自己 GitHub 下有一个空仓库,名字叫 fir-mac,提交时间在 2016 年 6 月 22 号,恍然大悟原来又是弃坑项目之一。
由于从事 iOS 开发后一直对 macOS 开发比较感兴趣,感觉 Mac 应用有一种天生的美感,更是在 OS X 10.10 Yosemite 之后的扁平化、毛玻璃、各种窗口细节的优化感到和往日使用 Windows 的差异;那既然都已入苹果的坑,何不顺势玩玩 Cocoa 桌面开发呢, 业余时间前后写了 MyMacMusicPlayerCubicBezier,也算小入了一点点 Cocoa 的门,想继续找项目在实战中磨练自己,然后因为有段时间用 fir.im 比较多,隧萌生了为其做一个 Mac 客户端的想法。

准备

开发之前首先得想想会遇到最大的问题是什么?那应该是 fir 的接口,官方有没有开放接口?接口有没有限制?这是我作为一个第三方开发人员无法控制的事情,所辛 fir 在很早的时候就开放了他们的 API 及其文档,并且借口都比较齐全,证明他们对此是保持开放态度,那么接口的障碍没有了还有其他问题吗?
这时我就预估一下了应用的整体功能模块,以及大致实现方法,把项目难点提前筛出来看看,fir-mac 作为一个基于 Mac 系统的 GUI 客户端,首先是 UI 的搭建,最初想法,用一个列表(NSTableView)呈现账户下所有的应用,然后点击应用可以展开其详细信息,感觉应该可以实现,当然 UI 动画、优化什么的暂且先不提,毕竟先得把功能做出来才是第一步。

功能架构

功能上主要参考 fir web 端,包括上传应用、查看应用列表、查看应用详情,差不多就这样,简简单单实实在在。

sketch

后来有朋友在微博上评论说想要扫二维码下载的功能,很快也增加进去了。
如果你是本软件的使用者,有什么功能上的意见或想法欢迎与我联系哦。

UI设计

UI 最终成品基本上也继承与最初的想法而来,简单的 List,弹开应用详情,采用 Vertical Split View Controller 分栏设计,把左右两边分开并各自独立 NSViewController,从而使业务逻辑分离开来,在 Storyboard 上看起来是这个样子:

Storyboard

右边的块区域用了 NSBox 作收纳子元素和框样式,隐藏掉了 Title,想想在 iOS 上搞这个还得弄个 UIView 设设圆角什么的。(有时候总会想到 CocoaTouch 里的东西去)
Cocoa 里原生提供了三种列表组建,分别是 TableView、Outline View、Source List,而 Outline View、Source List 都是基于 NSOutlineView 的定制,而 NSOutlineViewNSTableView 的定制,所以归其总都是 NSTableView 一个东西。

TableView

fir-mac 左边侧边栏的列表则用的 TableView,自定义其 Cell 来展示的:

CustomCell

最后的实际运行效果如下:

Screenshot

可以看到其实和 Storyboard 相似度很高,开发此类小应用使用 Storyboard 构建 UI 效率非常高,并且因为窗口设计成固定大小,要么缩小要么关闭,不能缩放,所以也不用去拉 AutoLayout,真的省心。

困难1:接口的调试

从最开始本以为很简单的 form-upload 操作,废了两晚上时间才搞定,因为 fir 的应用包是存在静态文件服务器上的,而且后端采用了不同的云存储商,所以上传文件需要两个步骤,第一步先获取凭证,第二步再用拿到的凭证进行表单上传,因为应用二进制和应用图标是分开上传,所以一次提交应用的操作其实会发三个请求,[拿 Token] -> 上传图标 -> 上传应用。
有点不明白的是应用图标本身也是从其应用文件中提取出来的,为什么不把这一步拿到服务端做呢?为了节省服务器资源吗?还有其应用信息,感觉放到服务端做会更可靠,因为 fir 不止一个客户端工具去做上传,比如 Website、Command Line Tool,各种 IDE 插件,每个端都需要去编写这套包解析和两次上传请求,首先维护成本增高,解析提交的数据还不一定是可靠内容,造成脏数据提交到服务端。
好吧先不纠结这个接口设计了,想说的是为啥在一个上传文件的功能上绕了弯路,最后找到问题是因为一个参数的参数名写错了,并且服务端没有错误反馈,仍然返回的请求成功,这我就懵了,然后抓了一下 web 所请求的参数值,拿过来用错误的参数名提交居然也成功了。这就是为啥蒙圈在这这么久的原因。

困难2:包解析

本以为 fir 的接口如上文所说是由服务端解析应用包,提取出应用信息比如应用名、版本号等等,结果发现其实是本地解析拿到这些信息然后再提交给接口,拿 iOS 的包来说,后缀为 .ipa,在 macOS 本地的流程大致如下:

  1. mktemp 命令创建临时目录
  2. unzip 解压 .ipa 到临时目录
  3. 逐级目录查找到 Payload 文件夹
  4. 读取 Info.plist 文件
  5. 根据 CFBundleIdentifierCFBundleShortVersionString… 提取出应用信息和 ICON 图标
  6. 删除之前生成的临时目录

mktemp 是一个 linux 命令会在系统层级创建一个临时目录,路径是随机名大致如下 /var/folders/r3/x98gzjpn7rxct9y4rtnjsv5m0000gn/T/,不会重复保证一定安全性

unzip 是 linux 下解压 zip 文件的命令,通过参数 -d 来指定解压目的地为之前生成的临时目录

读取 Info.plist 文件本打算用 defaults 命令来完成,后来发现实在不如读取进 Dict 操作方便

以上便是用户选择一个 .ipa 文件提交上传前所需做的工作,由于 Android 包 .apk 数据结构又不一样,所以支持 Android 应用上传需要另外编写一套解析逻辑,故目前 .apk 上传还未支持。(话说写这个真累,项目开源欢迎有志之士共享一份力量!)

引用

由于应用主要建立在与 fir.im 接口的 HTTP 通信上,所以引入了 Alamofire 来做所有的网络请求,包括数据拉取和文件上传;然后因为接口返回所有数据格式均为 JSON,为了人性化编程又引入了 SwiftyJSON;项目列表还存在网络图加载,为了省事也直接用了 Kingfisher;因为有了这些项目的积淀,我们才能把更多的注意力放在其他事情上,避免很多重复而基础的工作,感谢开源!

开源协议

关于选择开源协议,一直都没有太深刻的理解,只知道 MIT 最开放自由,那就 MIT 咯,后来看到微博上大家评论说 MIT 难道不怕又被翻去上架卖钱吗?之前就有 PPRows 的事情,PPRows 的作者也来跟我说让我换掉开源协议。
翻看了一下,像开发组件大部分都采用 MIT,宽松,但是很多完整项目都采用了 GPL-3.0,比如 PHP CMS 系统 Drupal ,播放器 iina、SQLite 数据库浏览器 sqlitebrowser 等等,他们采用 GPL-3.0 更是为了限制商业使用。作为一个开源作者的心愿首先肯定是希望自己的项目能发展起来,项目被他人商业化估计很多作者都是不愿看到的事,开源界关于协议版权的闹的事情已经很多了,希望那些不劳而获通过开源项目结合流量与市场榨取用户的人,能把更多注意力放在做事情本身,而不是一点蝇头小利和旁门左道。

一不小心吐槽了一番,本文差不多就这样结束了,如果你还没有 star 这个项目,赶紧来吧:https://github.com/isaced/fir-mac

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 212,542评论 6 493
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 90,596评论 3 385
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 158,021评论 0 348
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 56,682评论 1 284
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 65,792评论 6 386
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 49,985评论 1 291
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 39,107评论 3 410
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 37,845评论 0 268
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 44,299评论 1 303
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 36,612评论 2 327
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 38,747评论 1 341
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 34,441评论 4 333
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 40,072评论 3 317
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 30,828评论 0 21
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,069评论 1 267
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 46,545评论 2 362
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 43,658评论 2 350

推荐阅读更多精彩内容

  • Android 自定义View的各种姿势1 Activity的显示之ViewRootImpl详解 Activity...
    passiontim阅读 171,846评论 25 707
  • 今日作业;如何用介绍的六种清单思维模型找到高价值的事情,建立自己的时间管理体系 1想要知道如何建立自己的时间管理体...
    9一维c阅读 175评论 0 0
  • 2013.10.28 最近,可能是因为对过往的告别,特别喜欢听轻摇滚的音乐,如汪峰的《飞得更高》、《像梦一样自由》...
    Wien超仙子阅读 256评论 0 1
  • 夜很深, 睡前我还在想你。 我也在好奇你怎么老是在我脑里兜兜转转, 应该说, 我满脑子都是你。 不知不觉睡着了, ...
    ZZZ大茗阅读 316评论 1 1
  • 第四篇了,写完今天这事儿应该就能做下去了,先从最简单的做起,坚持写上几年,总能够越来越好的。 1:给猫小主听的音乐...
    coocaa阅读 167评论 0 0