自定义 Xcode ViewController 类模板

写之前先感谢下 @ColeXm偷懒宝典--打造属于自己的 Xcode 类模板 让我知道能够知道还能自定义 Xcode 类模板。

然后 有兴趣的可以看看我自己 博客 ,排版应该稍微好点。

话不多说我们先来体验下 :

图1

什么是 Xcode 类模板 ?

说到 Xcode 类模板有些人可能觉得陌生,其实作为一名 iOS 开发,我们每天都会用到 Xcode 类模板,例如创建一个 UIViewController,一个 Category 等等,这些其实都是 Xcode 帮我们集成好的模板。

我们先看看系统的 VC 模版怎么创建的 :

图2

为什么要自定义 Xcode 类模板 ?

当我们用 Xcode 自带的模板创建一个 UIViewController 的子类时,我们会发现 .m 文件会多出一些方法 :

图3

而我们平时的开发中,或多或少都有自己的一些规范,尤其是在多人合作开发的情况下,一些好的开发规范是相当必要的。

我的 UIViewController 规范:

#import "MyViewController.h"

@interface MyViewController ()
// <UITableViewDelegate,UITableViewDataSource>

@end

@implementation MyViewController

#pragma mark - LifeCyle

- (void)viewDidLoad {
[super viewDidLoad];
}
/*
- (void)viewWillAppear:(BOOL)animated {
[super viewWillAppear:animated];
}

- (void)viewDidAppear:(BOOL)animated {
[super viewDidAppear:animated];
}

- (void)viewWillDisappear:(BOOL)animated {
[super viewWillDisappear:animated];
}

-(void)viewDidDisappear:(BOOL)animated {
[super viewDidDisappear:animated];
}
**/
- (void)dealloc {
NSLog(@"%@-释放了",self.class);
}

#pragma mark - Intial Methods

#pragma mark - Target Methods

#pragma mark - Private Method

#pragma mark - Setter Getter Methods

#pragma mark - External Delegate

#pragma mark - UITableViewDelegate,UITableViewDataSource
/*
- (NSInteger)numberOfSectionsInTableView:(UITableView *)tableView {
return <#section#>;
}

- (NSInteger)tableView:(UITableView *)tableView numberOfRowsInSection:(NSInteger)section {
return <#row#>;
}

- (UITableViewCell *)tableView:(UITableView *)tableView cellForRowAtIndexPath:(NSIndexPath *)indexPath {
return <# UITableViewCell #>;
}

- (CGFloat)tableView:(UITableView *)tableView heightForRowAtIndexPath:(NSIndexPath *)indexPath {
return <#height#>;
}
**/
@end

这么一堆东西写起来也是要点时间的,如果每创建个 VC 就要写一遍也太不优雅了。

有没有什么办法能够在我们创建 VC 的时候自动生成这些呢?

创建自己的 Xcode 类模板

一份成品模版结构大概这样 :

图4

介绍下里面的东西 (xxx 就是你自定义模版的名字) :

xxx.xctemplate:模版文件。

xxxObjective-C:OC模版文件,里面包含 ___FILEBASENAME___.h___FILEBASENAME___.m 两个文件。

xxxXIBObjective-C:xxxObjective-C 多了个 ___FILEBASENAME___.xib 文件,可自定义。

xxxSwift:Swift模版文件,里面包含一个 ___FILEBASENAME___.swift 文件。

xxxXIBSwift:xxxSwift 多了个 ___FILEBASENAME___.xib 文件,可自定义。

TemplateIcon.png:模版显示的图片。

TemplateInfo.plist:模版的配置信息,图7

重新写一份模版太繁琐,我们直接拷贝一份系统的模版来修改

  • 拷贝 Cocoa Class.xctemplate,修改名称并删除不需要的文件。(我这边是 Xcode 8.2.1, 以后路径可能有变)
/Applications/Xcode.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/Library/Xcode/Templates/File Templates/Source

  • 修改 .h 为 :
//  ___FILENAME___
//  ___PROJECTNAME___
//
//  Created by ___FULLUSERNAME___ on ___DATE___.
//___COPYRIGHT___
//

___IMPORTHEADER_cocoaSubclass___

@interface ___FILEBASENAMEASIDENTIFIER___ : UIViewController

@end
  • 修改 .m 只需要添加自己需要的规范就行,可以参考 上面我的 VC 模板。
  • 修改 .swift 为:
//  ___FILENAME___
//  ___PROJECTNAME___
//
//  Created by ___FULLUSERNAME___ on ___DATE___.
//___COPYRIGHT___
//

import UIKit

class ___FILEBASENAMEASIDENTIFIER___: UIViewController {

//MARK: - LifeCyle

override func viewDidLoad() {
super.viewDidLoad()
}

deinit {
print("\(object_getClassName(self)) - 释放了!")
}

//MARK: - Intial Methods

//MARK: - Target Methods

//MARK: - Private Method

//MARK: - Setter Getter Methods

//MARK: - External Delegate

}

  • 新建 .xib 重命名 ___FILEBASENAME___.xib 并按照下图修改:
图5
图6

上面 .h .m 里面 有些词可能不明白,这里再稍稍解释下:

1)DATE:标识当前时间;

2)FILENAME:带文件后缀的全名;

3)FILEBASENAME:不带文件后缀的名字;

4)FULLUSERNAME:当前的用户名;

6)PROJECTNAME:工程名字;

7)FILEBASENAMEASIDENTIFIER: VC 类名称;

8)IMPORTHEADER_cocoaSubclass: 导入的头文件。

TemplateInfo.plist :

图7

讲解一些需要改动的东西 :

SortOrder:模版在界面中的位置;

Options:对应 图2 四行;

FallbackHeader:.h 导入的头文件;

RequiredOptions -> cocoaSubclass:是否支持选择 xib;Default 默认 true 自动勾选;

Values:自定义模版的名称(一定要保持一致);

Suffixes:模版默认类名,效果如下图。

图8

最后把创建好的 xxx.xctemplate 文件直接拷贝到系统路径下就可以直接使用了:

/Applications/Xcode.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/Library/Xcode/Templates/File Templates/Source  

修改系统模板

平常开发中,我们经常用xib来画一个View,之前用系统的模板创建View的时候是有勾选是否创建对应xib的这个选项的,苹果不知道什么时候改了,现在貌似不行了:

这样导致我们创建完View后,还需要再创建个对应的xib文件,简直神烦!
怎么能自动创建xib文件呢?我们完全可以修改系统的模板来满足我们的刚需:

  • 进入目录,找到Cocoa Touch Class.xctemplate文件
/Applications/Xcode.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/Library/Xcode/Templates/File Templates/Source  
  • 拷贝一份 UIViewObjective-C文件并改名为UIViewXIBObjective-C,然后到其他有xib的文件夹里面,拷贝一份xibUIViewXIBObjective-C里面,xib可自行修改。(我这里只配置了Objective-C的,Swift步骤类似)
  • 找到 当前目录的TemplateInfo.plist文件,如下修改:
  • 重新创建系统 View模板:

大功告成!

Demo

最后放上我自己的一个 UIViewController 模板 懒得自己写的可以直接用或者在我的模板基础上修改!

参考链接

http://www.jianshu.com/p/93527682d8d3

http://www.bobmccune.com/2012/03/04/creating-custom-xcode-4-file-templates/

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

推荐阅读更多精彩内容

  • Xcode 类模板 例如创建一个 UIViewController,一个 Category 等等,这些其实都是 X...
    andyJi阅读 1,989评论 0 0
  • 发现 关注 消息 iOS 第三方库、插件、知名博客总结 作者大灰狼的小绵羊哥哥关注 2017.06.26 09:4...
    肇东周阅读 12,092评论 4 62
  • 一、为什么要自定义模板 1.节省重复代码手写时间2.统一规范代码,提高代码可读性3.减少手写代码,XIB或修改相关...
    huluo666阅读 7,938评论 10 49
  • 文/蛟龙 世界是如此的安静 仔细聆听 没有秋虫呢喃 也没有鸟语花香 沉寂在某个角落里 世界很忙碌 开始怀疑世界 怀...
    F芳子阅读 228评论 0 0
  • 说到专心致志,我想到了韩非子讲过的一个故事。 赵襄主跟王子期学驾车,学得差不多了,要和老师比试比试。他在比赛的过程...
    二班班阅读 314评论 0 0