自定义 Xcode ViewController 类模板

Posted iOS大全

tags:

篇首语：本文由小常识网(cha138.com)小编为大家整理，主要介绍了自定义 Xcode ViewController 类模板相关的知识，希望对你有一定的参考价值。

来源：ifelseboyxx 

www.jianshu.com/p/35a884e152c9


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


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


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



什么是 Xcode 类模板 ？


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


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


自定义 Xcode ViewController 类模板


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


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


自定义 Xcode ViewController 类模板


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


我的 UIViewController 规范：


#import "MyViewController.h"

 

@interface MyViewController ()

//

 

@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 ;

}

 

- (NSInteger)tableView:(UITableView *)tableView numberOfRowsInSection:(NSInteger)section {

return ;

}

 

- (UITableViewCell *)tableView:(UITableView *)tableView cellForRowAtIndexPath:(NSIndexPath *)indexPath {

return ;

}

 

- (CGFloat)tableView:(UITableView *)tableView heightForRowAtIndexPath:(NSIndexPath *)indexPath {

return ;

}

**/

@end


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


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


创建自己的 Xcode 类模板


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


自定义 Xcode ViewController 类模板


介绍下里面的东西 (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 并按照下图修改:


自定义 Xcode ViewController 类模板


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


1）DATE：标识当前时间；

2）FILENAME：带文件后缀的全名；

3）FILEBASENAME：不带文件后缀的名字；

4）FULLUSERNAME：当前的用户名；

6）PROJECTNAME：工程名字；

7）FILEBASENAMEASIDENTIFIER： VC 类名称；

8）IMPORTHEADER_cocoaSubclass： 导入的头文件。


TemplateInfo.plist ：


自定义 Xcode ViewController 类模板


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


SortOrder：模版在界面中的位置；

Options：对应 图2 四行；

FallbackHeader：.h 导入的头文件；

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

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

Suffixes：模版默认类名，效果如下图。


自定义 Xcode ViewController 类模板


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


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


修改系统模板


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


自定义 Xcode ViewController 类模板


这样导致我们创建完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的文件夹里面，拷贝一份xib到UIViewXIBObjective-C里面，xib可自行修改。（我这里只配置了Objective-C的，Swift步骤类似）

  • 找到 当前目录的TemplateInfo.plist文件，如下修改：


自定义 Xcode ViewController 类模板


  • 重新创建系统 View模板：



大功告成！


Demo


最后放上我自己的一个 UIViewController 模板（https://github.com/ifelseboyxx/CustomXcodeTempate） 懒得自己写的可以直接用或者在我的模板基础上修改！


参考链接


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


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


觉得本文对你有帮助？请分享给更多人

关注「 iOS大全 」

看更多精选 iOS 技术文章

以上是关于自定义 Xcode ViewController 类模板的主要内容，如果未能解决你的问题，请参考以下文章

Xcode 5 错误未定义符号的体系结构 i386

带有自定义单元格的 ViewController 内的 UITableView 没有情节提要

对于 iOS，将 ViewController.xib 自定义类更改为另一个类是啥意思？

XCode：在自定义 UIView 的顶部分层一个按钮

Interface Builder - 自定义类未显示

无法在新的自定义类 Xcode 11 中连接到 IBOutlet