Xcode插件开发

news2024/12/23 5:23:10

Xcode插件开发

文章目录

Xcode插件开发
- 一、插件开发流程
- - 创建插件
  - Extension文件介绍
  - 文件说明
- 二、插件使用安装说明

一、插件开发流程

创建插件的过程并不复杂，只是官方教程，过于简单，所以这里补充下创建细节

创建插件

环境：Xcode 15.2
先创建一个Mac App
选择 Xcode - File - New - Project，选择macOS - App - Next，跟创建iOS App类似
在这里插入图片描述

然后Target里添加一个Extension
选择 Xcode - File - New - Target，选择macOS - Xcode Source Editor Extension
在这里插入图片描述

创建后文件目录
在这里插入图片描述

这里可能需要重新引用下，否则在Xcode中，会找不到该插件
选择Targets - TestDemoExtension - General - Frameworks and Libraries，添加XcodeKit，并将XcodeKit修改为Embed&Sign
在这里插入图片描述

这样一个Xcode插件就创建完成了，这时我们没有修改任何代码，直接选择Extension然后运行，就会出现一个重新启动一个新的Xcode（在Xcode15之前是显示为灰色图标的，Xcode15之后是带颜色的，如下图），是作为调试的Xcode，使用该Xcode打开的Project，在菜单栏的Editor，就会出现我们开发的插件了
在这里插入图片描述

在这里插入图片描述

选中Project中的任意一个.swift文件或者.h/.m文件，Editor - TestDemoExtension - Source Editor Command
在这里插入图片描述

Extension文件介绍

上面运行后能看到插件的名称以及默认选项，是因为创建Extension时，会自动创建一个默认的选项，在Info.plist文件中，我们可以根据自己的业务需要修改，或者添加其他的定义

添加或修改插件的菜单名称和命令，有两种方式：
第一种：直接在Info.plist文件中添加或修改
在这里插入图片描述

XCSourceEditorCommandClassName：处理此菜单的类名
XCSourceEditorCommandIdentifier：此菜单的标识，可以在处理类中用户判断点击了哪一个菜单（如果有多个的情况）
XCSourceEditorCommandName：菜单的名称

运行结果：
在这里插入图片描述

第二种：修改SourceEditorExtension.swift代码文件添加或修改
在这里插入图片描述

nameKey: 菜单的名称
identifierKey：菜单的标识，可以在处理类中用于判断点击了哪一个菜单（如果有多个的情况）
classNameKey：处理此菜单的类名，这里我们直接使用className()获取，如果你直接写字符串记得在类名前加上模块名

运行结果：
在这里插入图片描述

可以看到经过上面的验证，SourceEditorExtension.swift文件中的返回值优先级高于info.plist文件，实际情况中我们使用一种设置即可。

文件说明

SourceEditorExtension：设置插件的菜单键以及对应的配置信息，包括菜单的名称、菜单的唯一标识以及菜单的处理类
SourceEditorCommand：就是对应菜单的处理类，需要遵守XCSourceEditorCommand协议，并且实现以下方法，用作点击菜单的具体处理逻辑：

class SourceEditorCommand: NSObject, XCSourceEditorCommand {
    
    func perform(with invocation: XCSourceEditorCommandInvocation, completionHandler: @escaping (Error?) -> Void ) -> Void {
        // Implement your command here, invoking the completion handler when done. Pass it nil on success, and an NSError on failure.
        
        completionHandler(nil)
    }
    
}

如果有多个菜单，为了独立开来，可以自行创建一个处理类，比如，上面添加的三个菜单都是引用同一个处理类，那么代码会集中在同一个文件，为了区分，为菜单2创建单独的处理类Menu2Command.swift，代码如下

import Foundation
import XcodeKit

class Menu2Command: NSObject, XCSourceEditorCommand {
    
    func perform(with invocation: XCSourceEditorCommandInvocation, completionHandler: @escaping (Error?) -> Void ) -> Void {
        // Implement your command here, invoking the completion handler when done. Pass it nil on success, and an NSError on failure.
        
        print("点击菜单2")
        completionHandler(nil)
    }
    
}

运行结果，分别点击菜单2、菜单1、菜单3，打印结果：
在这里插入图片描述