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成功以后，便可看见如下效果图

 但愿对你们有所帮助~