iOS项目重构周记(一)

最近开始做公司的iOS项目重构,现准备每周做一次汇总,把重构过程中遇到的问题和解决方案记录下来,做一个记录和分享。

1.文件目录结构

我们在Xcode中使用“new group”创建一个新的目录时,对应的文件系统中并不会相应的创建一个实体文件夹,只是在Xcode中创建一个便于管理的虚拟文件夹。这样就导致添加的所有文件最终都放在文件系统的同一目录下,这里面可能会包含.h文件、.m文件、nib文件,图片等等一系列的资源文件。当项目最终变的比较庞大时,众多的文件将变的极难管理。而且,当我们使用SVN或Git来做版本控制时,一旦产生工程文件冲突,重新添加文件也很难定位,并且容易遗漏文件。

所以我们应该使用实体文件夹来构建项目中的Group,另外当项目比较庞大时,Group的划分也是需要斟酌的一项。好的结构划分能够帮助我们快速定位代码,有助于理解整个项目的架构和逻辑。所以我建议基于以下几条来区分目录结构。

  • 公共部分和各功能模块的区分
    公共部分和各功能模块应该区分开来,公共模块一般包含公共模型、方法、视图、第三方库。我们写的任何可被其他功能模块调用的组件都应该包含到公共目录下。

  • 资源类型的区分
    所有的图片、数据库文件、bundle、plist等等资源文件都应该统一包含到资源目录下。

  • MVC的区分
    各功能模块都可按MVC来区分,视图模型控制器的区分可以帮助自己和他人更快的定位代码。

另外说一下添加文件夹到工程中时,“Create groups”和“Create folder references”的区别。

img
img

Create group类似于我们“new group”时创建的组,其中包含的文件会自动添加到Compile Sources中,Create folder references只会引用文件夹,文件夹里面的东西都会直接拷贝到bundle包,不参与编译。

2.注释

注释也是重构中的一部分,好的注释能够极大程度上帮助自己和他人理解代码。我相信对注释负责的人,也从侧面证明是一个靠谱的人。只是这里要注意注释的格式。

这里推荐一个喵神写的自动注释工具:VVDocumentor
这是一个Xcode插件,只需要在要写文档的代码上面连打三个斜杠,就能自动提取参数等生成规范的Javadoc格式文档注释,下载编译一下,然后重启Xcode就可以使用了。

img
img

使用这种方式的注释,只要按住option键+鼠标左键,是可以在调用时直接查看注释内容的:
img
img

3.手写代码 or Xib?

关于这个问题相信很多同学都有困惑,国内iOS界的大神唐巧和喵神对这个问题也都有自己的见解,大家可以移步到他们的博客看看:
唐巧:http://blog.devtang.com/blog/2015/03/22/ios-dev-controversy-2/
喵神:http://onevcat.com/2013/12/code-vs-xib-vs-storyboard/
借用唐巧的几句话:

  • 对于复杂的、动态生成的界面,建议使用手工编写界面。
  • 对于需要统一风格的按钮或UI控件,建议使用手工用代码来构造。方便之后的修改和复用。
  • 对于需要有继承或组合关系的 UIView 类或 UIViewController 类,建议用代码手工编写界面。
  • 对于那些简单的、静态的、非核心功能界面,可以考虑使用 xib 或 storyboard 来完成。

4.多用类型常量,少用#define

一个庞大的项目中,常常使用了大量的宏定义。宏定义的初衷之一是提高了程序的可读性,同时也方便进行修改。可是过度的宏定义往往违背了它的初衷。

例如

#define ANIMATION_DURATION 0.3 

我们并不能很直观的理解它其中的时间含义,而

static const NSTimeInterval kAnimationDuration = 0.3;

就很好的描述了常量的含义。

此外,为什么要加一个static和const来同时命名?因为static意味着该变量仅在定义此变量的编译单元中可见。编译器每收到一个编译单元,就会相应的输出一份目标文件(object file即.o文件)。假如我们不声明static,编译器就会为它创建一个“外部符号”。此时如果另一个编译单元也声明了一个同名变量,那么编译器就会抛出一条错误消息。事实上,如果同时用static和const命名,编译器根本不会创建符号,而是会像#define预处理指令一样,把所有遇到的变量都替换为常值。不过还是有一点区别的,用这种方式定义的常量是带有类型信息的。

不管是#define还是static const都不应该在头文件里声明,因为常量名称很有可能互相冲突,如果一定要这么做的话,要加上前缀,表明它输入哪个类。

再延伸的说一下extern:
extern常用于NSNotification中等,供外部使用,extern常量放在“全局符号表”中,以便可以在定义该常量的编译单元之外使用。这也是不用使用#import引入其所在头文件的原因,需注意,此类常量必须要定义,而且只能定义一次。

5.Reveal

对于庞大的项目,纯代码构建的UI,使用Reveal来调试界面的用处还是很大的。可以帮助我们更直观的了解代码,快速定位UI细节。颜色,位置,大小,间距,和View之间的相对关系都可以一目了然。Reveal甚至比Xcode自带的Interface Builder做的还要好。对于越狱的设备,Reveal还可以用来分析其他应用程序的UI,实在是不可多得的利器。

img
img

Reveal加载的三个方法

加载方法1

下载Reveal之后打开,在菜单中的Help中可以找到集成到Xcode项目的方法,这里不再赘述。

加载方法2

此方法可以在不改变工程设置的前提下加载Reveal
打开终端,输入

vim ~/.lldbinit

LLDB每次启动的时候都会加载这个文件。输入:

command alias reveal_load_sim expr (void*)dlopen("/Applications/Reveal.app/Contents/SharedSupport/iOS-Libraries/libReveal.dylib", 0x2);

command alias reveal_load_dev expr (void*)dlopen([(NSString*)[(NSBundle*)[NSBundle mainBundle] pathForResource:@"libReveal" ofType:@"dylib"] cStringUsingEncoding:0x4], 0x2);

command alias reveal_start expr (void)[(NSNotificationCenter*)[NSNotificationCenter defaultCenter] postNotificationName:@"IBARevealRequestStart" object:nil];

command alias reveal_stop expr (void)[(NSNotificationCenter*)[NSNotificationCenter defaultCenter] postNotificationName:@"IBARevealRequestStop" object:nil];

然后输入control+c,w q enter退出终端。
上述文件创建了4个命令:

reveal_load_sim,reveal_load_dev, reveal_start 和 reveal_stop
  • reveal_load_sim 这个只在iOS模拟器上有效。它从Reveal的应用程序bundle中找到并加载libReveal.dylib(请确保你把Reveal安装到了系统的Application文件夹,如果你换地方了,你修改上述的文件)。

  • reveal_load_dev 这个命令在iOS设备和模拟器上都有效。不过,它需要你在Build Phase中的的Copy Bundle Resources中加上libReveal.dylib,请确保没有放到Link Binary With Libraries这个地方。

  • reveal_start 这个命令发出一个通知启动Reveal Server。

  • reveal_stop 这个命令发出一个通知停止Reveal Server。

如果在模拟器下调试,只需要在- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions方法中加入一个断点并且如图所示编辑:

img
img

编译运行即可。

在真机下,需在工程中导入Reveal的动态库,打开Reveal,点击Help-Show Library in Finder,将libReveal.dylib文件拖动到目标Xcode工程中,Xcode默认情况下错误地将libReveal.dylib设置到了”Link Binary With Libraries”下,我们需要进行一下调整,将其中”Link Binary With Libraries”中删除,然后将其添加到“Copy Bundle Resources”下面。

img
img

之后用Reveal连接真机的方式和连接模拟器的方式类似,我们只需要把模拟器调试下的断点Action的内容从reveal_load_sim改成reveal_load_dev即可。

加载方法3

对于越狱的机器,可以用Reveal来”调试“其它应用界面,什么时候会有这种奇怪的需求呢?——当我们想学习别人是如何实现界面效果的时候。iOS设备的目录/Library/MobileSubstrate/DynamicLibraries下存放着所有在系统启动时就需要加载的动态链接库,所以我们只需要将Reveal的动态链接库上传到该目录即可。

对于越狱的设备,我们可以在安装OpenSSH之后,用scp来上传该文件。具体步骤如下:
1.将libReveal.dylib 上传到/Library/MobileSubstrate/DynamicLibraries
2.如果libReveal.dylib没有执行权限,用chmod +x libReveal.dylib命令,给其增加执行权限
3.执行killall SpringBoard重启桌面

另外需要注意的是,使用Reveal真机测试时手机和电脑应处于同一网络下。

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

推荐阅读更多精彩内容

  • Swift版本点击这里欢迎加入QQ群交流: 594119878最新更新日期:18-09-17 About A cu...
    ylgwhyh阅读 25,212评论 7 249
  • 发现 关注 消息 iOS 第三方库、插件、知名博客总结 作者大灰狼的小绵羊哥哥关注 2017.06.26 09:4...
    肇东周阅读 11,943评论 4 60
  • 还记得我们刚踏进学校那会吗? 那时候我们就像迷路的小羔羊 身上满满的都是稚气 眼里是前所未有的迷茫和害怕 每个人心...
    江潇然阅读 276评论 0 1
  • 昨日的汗 浸湿地面 是份苦咸 我的明天 今日的天 十分蔚蓝 苦中有甘 我的明天 明日的山 会更巍然 涌出甘甜 ...
    雨林笔墨阅读 141评论 0 1
  • 选择 人一生的过程在于选择,所有的痛苦源于选择。 婴儿时,吃了睡,睡了吃,便无选择,便没有痛苦...
    石三英语阅读 221评论 0 0