Xcode插件开发教程指南

在平时开发过程中我们使用了很多的Xcode插件,虽然官方对于插件制作没有提供任何支持,但是加载三方的插件,默认还是被允许的。第三方的插件,存放在
~/Library/Application Support/Developer/Shared/Xcode/Plug-ins文件夹中,后缀名必须是.xcplugin ,其实际上是一种bundle。所以我们创建一个插件工程,直接创建bundle工程即可。然后通过修改后缀名为.xcplugin,将其放到~/Library/Application Support/Developer/Shared/Xcode/Plug-ins目录中即可。

Xcode插件开发现在主要通过两种方式实现,其实也就是一种,只不过其中一种是使用别人提供的开发模板来省去很多中间步骤而已。文章会依次详细介绍两种的实现方法。

准备工作

方式一:通过Bundle实现

1.创建Bundle工程


2.工程设置
插件工程和普通的bundle工程还是有区别的,所以需要进行特殊的设置。
1)工程的plist文件

添加三项:
XCPluginHasUI = NO
XC4Compatible = YES
DVTPlugInCompatibilityUUIDs 这是一个数组。数组内容字符串,指示了该插件兼容的Xcode版本,只有对应版本的Xcode的UIID加入这个数组,插件才能被加载。
否则,即使将插件放入Xcode的插件文件夹,插件也不会被加载。获取当前版本的Xcode的UUID方式:
在terminal中输入命令:
defaults read /Applications/Xcode.app/Contents/Info DVTPlugInCompatibilityUUID
terminal会返回一串字符串,这就是Xcode的DVTPlugInCompatibilityUUID。
2)Build Setting


Installation Build Products Location 设置为 ${HOME} [显示的时候,显示的是你的用户目录],这个是products的根目录。
Installation Directory 设置为 /Library/Application Support/Developer/Shared/Xcode/Plug-ins,这个是指定你的插件安装的目录。
注意,这里填入的其实是相对目录。
插件的绝对目录是这样的,例如 /Users/yohunl/Library/Application\ Support/Developer/Shared/Xcode/Plug-ins/Alcatraz.xcplugin ,最后的绝对目录是 Installation Build Products Location和Installation Directory的结合,这也是为什么两者都要设置的原因。
Deployment Location 设置为 YES,这个是指示该工程不使用设置里的build location,而是用Installation Directory来确定build后放置的位置。

默认工程生成的相关文件位置都是 Build Locations指定的,通过Deployment Location 设置为 YES告诉工程,我们不使用这个默认的设置,而是我们自定义的。
Wrapper extension 设置为 xcplugin,后缀名必须为xcplugin,否则不会被加载。

方式二:通过模板实现

1)下载Xcode插件开发模板
地址:https://github.com/kattrali/Xcode-Plugin-Template
2)将下载下来的template复制到 ~/Library/Developer/Xcode/Templates/Project Templates/Application Plug-in/Xcode Plugin.xctemplate文件夹中,如果没有对应的文件夹就自己手动创建一个。
3)重启Xcode,当你新建一个工程的时候就可以在OS X中看到一个Application Plug-in的选项,里面有一个Xcode Plug-in模板。

实现

通过以上的两种准备方式,我们已可以创建Xcode插件工程,接下来就是如何实现插件功能。
1.功能需求
在当前选中文件中实现代码风格重构,目前主要实现setter方法这一风格重构。例如,
[self setName:@"Davy"]; ==> self.name = @"Davy";
2.思路分析
1)找到当前文件中符合setter方法命名风格的方法调用。
2)替换找到的符合重构风格的代码,提醒用户保存。
3.技术难点
1)Xcode代码编辑框文件内容操作。
2)正则表达式书写。
3)Xcode代码编辑框提醒用户保存文件。
关于最后一点,因为Xcode对于没有保存的已修改过的文件会显灰以提示用户该文件需要保存,我们可以借鉴这种方式。另外,在查找时,如果能够实现高亮并且跟随滚动,效果会更佳。
4.关键代码
以上这些问题,本人在“Refactor Code”插件中全部实现,现在放上关键方法。
1)添加菜单

-(void) setupMenuItem {
    // Menu Item:
    NSMenuItem *editMenuItem = [[NSApp mainMenu] itemWithTitle:@"Edit"];
    if (editMenuItem) {
        [[editMenuItem submenu] addItem:[NSMenuItem separatorItem]];
        NSMenu *refactorCodeMenu = [[NSMenu alloc] initWithTitle:@"Refactor Code"];
        NSMenuItem *menuItem;
        menuItem = [[NSMenuItem alloc] initWithTitle:@"Refactor Method Style" action:@selector(refactorMethodStyleMenuAction) keyEquivalent:@""];
        [menuItem setTarget:self]; [refactorCodeMenu addItem:menuItem];
        NSMenuItem *refactorCodeMenuItem = [[NSMenuItem alloc] initWithTitle:@"Refactor Code" action:nil keyEquivalent:@""];
        [refactorCodeMenuItem setSubmenu:refactorCodeMenu];
        [[editMenuItem submenu] addItem:refactorCodeMenuItem];
    }
}

效果图如下:


2)显示操作面板

- (void)refactorMethodStyleMenuAction {
    [self.operateController showWindow:nil];
    NSURL *url = [[NSBundle bundleForClass:[self class]] URLForResource:@"DZOperateController" withExtension:@"nib"];
    if (!url) {
        NSAlert *alert = [[NSAlert alloc] init];
        alert.messageText = @"Refactor Method Style could not be shown because the plugin is corrupted.";
        alert.informativeText = @"If you build the plugin from sources using Xcode, make sure to perform “Clean Build Folder“ in        Xcode and then build the plugin again.\n\nIf you installed the plugin via Alctraz, there is a pending issue causing        some files to be missing in the plugin. Prefer to install it via the plugin webpage.";
        [alert addButtonWithTitle:@"Download Latest"];
        [alert addButtonWithTitle:@"Cancel"];
        NSModalResponse result = [alert runModal];
        if (result == NSAlertFirstButtonReturn) {
            [[NSWorkspace sharedWorkspace] openURL:[NSURL URLWithString:@"https://github.com/CharsDavy/RefactorCodePlugin-Xcode"]];
        }
    }
}

效果图如下:


3)查找替换代码风格
这一部分是重点部分,包括如何书写正则表达式,并且利用正则表达式生成替换字符。还包括高亮代码,具体可以参见本人源码:https://github.com/CharsDavy/RefactorCodePlugin-Xcode
4)最终效果图

提交插件至Alcatraz

1.打开Alcatraz的插件包仓库,地址:https://github.com/supermarin/alcatraz-packages
2.在简介里可以看到Alcatraz的包分为三类,分别为:插件(plugins),配色方案(color schemes)和模板(templates)。每个包都必须包含”name”、”url”和”description”字段,还有一个可选的”screenshot”字段。
3.Fork这个仓库,再克隆到本地。
4.以添加”Refactor Code”插件为例,打开packages.json文件,在”plugins”数组里加入:

{ 
  "name": "Refactor Code",
  "url": "https://github.com/CharsDavy/RefactorCodePlugin-Xcode.git",
  "description": "Refactor code style,such as setter method.",
  "screenshot": "https://github.com/CharsDavy/RefactorCodePlugin-Xcode/raw/master/Screenshots/window.png"
}

5.提交代码到Fork的地址,再提交一个pull request到Master即可。
6.merged成功之后,即可看见以下效果图


希望对大家有所帮助。

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

推荐阅读更多精彩内容