iOS 插件制作

时间:2021-04-03 04:42:52

iOS 插件制作

概述

我们平时也使用了非常多的xcode插件,尽管官方对于插件制作没有提供不论什么支持,可是载入三方的插件,默认还是被同意的.第三方的插件,须要存放在 ~/Library/Application Support/Developer/Shared/Xcode/Plug-ins目录中,后缀名必须是.xcplugin (只是事实上际上是一种bundle).

所以我们创建一个插件project,直接创建bundleproject就可以,然后通过改动后缀名为.xcplugin,将其放到~/Library/Application Support/Developer/Shared/Xcode/Plug-ins文件夹中就能够了

第一个demo插件功能:在xcode的edit菜单中增加一个叫做 測试菜单 的项目,当点击的时候,弹出一个警告框,显示一句话,完整的project放在TestPluginBundle

具体过程

创建Bundleproject TestPluginBundle

iOS 插件制作

project名称就是 TestPluginBundle

project设置

插件project和普通的bundleproject还是有差别的,所以须要进行特殊的设置

首先是project的plist文件

iOS 插件制作

加入 三项

XCPluginHasUI = NO

XC4Compatible = YES

DVTPlugInCompatibilityUUIDs 这是一个数组.数组内容字符串,指示了该插件兼容的xcode版本号,仅仅有相应版本号的xcode的UIID增加这个数组了,插件才干被载入,否则,即使你将插件放入xcode的插件目录,插件也不会被载入的

那么怎么获取你当前版本号的xcode的UUID呢?在terminal中输入 defaults read /Applications/Xcode.app/Contents/Info DVTPlugInCompatibilityUUID ,terminal会返回一串字符串给你,这就是你的Xcode的DVTPlugInCompatibilityUUID.

接下来是 Build Setting了

iOS 插件制作

iOS 插件制作

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,这个是指示该project不使用设置里的build location,而是用Installation Directory来确定build后放哪儿

iOS 插件制作

我们默认project生成的相关文件放在哪.都是 Build Locations指示的,通过Deployment Location 设置为 YES告诉project,我们不使用这个默认的设置,而是我们自己定义的

Wrapper extension 设置为 xcplugin,后缀名必须为xcplugin,否则不会被载入

接下来就是插件的实现过程了

在project中加入一个文件 ,名称为 TestPluginBundle (当然,名字随便什么都能够),在当中加入代码

@implementation TestPluginBundle+(void)pluginDidLoad:(NSBundle *)plugin {    NSLog(@"插件执行了!");    [TestPluginBundle sharedInstance];}- (instancetype)init{    self = [super init];    if (self) {        [[NSNotificationCenter defaultCenter] addObserver:self                                                 selector:@selector(didApplicationFinishLaunchingNotification:)                                                     name:NSApplicationDidFinishLaunchingNotification                                                   object:nil];    }    return  self;}- (void)didApplicationFinishLaunchingNotification:(NSNotification*)noti{    [[NSNotificationCenter defaultCenter] removeObserver:self name:NSApplicationDidFinishLaunchingNotification object:nil];    NSMenuItem *menuItem = [[NSApp mainMenu] itemWithTitle:@"Edit"];    if (menuItem) {        [[menuItem submenu] addItem:[NSMenuItem separatorItem]];        NSMenuItem *actionMenuItem = [[NSMenuItem alloc] initWithTitle:@"測试菜单" action:@selector(doMenuAction) keyEquivalent:@""];        [actionMenuItem setTarget:self];        [[menuItem submenu] addItem:actionMenuItem];    }}- (void)doMenuAction{    NSAlert *alert = [[NSAlert alloc] init];    [alert setMessageText:@"測试菜单执行"];    [alert runModal];}- (void)dealloc{    [[NSNotificationCenter defaultCenter] removeObserver:self];}+ (instancetype)sharedInstance{    static id instance;    static dispatch_once_t onceToken;    dispatch_once(&onceToken, ^{        instance = [[self alloc] init];    });    return instance;}@end

ctrl+B来Buildproject,查看路径下/Library/Application Support/Developer/Shared/Xcode/Plug-ins,能够看到我们的插件TestPluginBundle.xcplugin存在了,接下来,重新启动xcode

iOS 插件制作

点击 測试菜单

iOS 插件制作

可能你 会说,这样尽管是起作用了,可是,难道开发一个插件project,没打单步调试么?

??

,当然不是啊

编辑project的scheme,将Executable设置为Xcode.app,意思是project调试的时候挂载到xcode中

iOS 插件制作

将Options以下的Core Location,XPC Services,View Debugging前面的勾都去掉,否则,你调试的时候,可能会直接crash

iOS 插件制作

当设置完后,你的project的scheme的图标会从bundle图标变为xcode的图标

iOS 插件制作

再执行(这里是执行了,不是编译了)

不出意外的话,会出现xode启动另外一个xcode,接下来和你普通的调试project就是一样的了!

说了这么多,事实上仅仅是想让你明确一个插件的初始化的配置,调试等

上面的过程,已经有国外大神制作成了一个 project模板了,https://github.com/kattrali/Xcode-Plugin-Template 其支持OC和Swift,当你安装它后,会在新建project时候,看到
Xcode Plugin模板,使用这个模板创建一个新project,以上的配置等,就都设置好了,直接执行就是一个demo了.

iOS 插件制作