Xcode 插件沒有官方完整支援,但可透過 Bundle 與私有 API 注入功能。本文以早期 Xcode 4 插件概念為基礎,說明插件載入、選單注入、通知監聽與方法交換等常見做法;Xcode 5 之後還需留意 ARC 與 UUID 檢查機制。
Xcode 啟動時會搜尋 ~/Library/Application Support/Developer/Shared/Xcode/Plug-ins 中的 .xcplugin bundle。只要建立 Bundle 工程並把編譯結果放到該目錄,就能讓 Xcode 載入插件。

建立 OS X Framework & Library 下的 Bundle 工程,Framework 選擇 Cocoa。早期插件通常需關閉 ARC,並使用 GC 支援。


在 Info.plist 中加入 XCGCReady、XCPluginHasUI、XC4Compatible 等鍵值,讓 Xcode 正確認識插件。


另外可在 User-Defined 中加入 GCC_ENABLE_OBJC_GC = supported,讓早期插件具備 GC 支援。
建立一個 NSObject 子類別,實作 pluginDidLoad:,在 Xcode 載入插件時輸出日誌。Build 後重新啟動 Xcode,即可在 Console 看到訊息。

在 pluginDidLoad: 中建立 shared 單例,並在 init 監聽 NSApplicationDidFinishLaunchingNotification。Xcode 完成啟動後,再把自訂項目加入 Edit 選單。

監聽 NSTextViewDidChangeSelectionNotification,保存目前選取文字;按下 What is selected 時,用 NSAlert 顯示內容。

把 NSNotificationCenter 的 addObserver:selector:name:object: 中 name 設為 nil,可接收所有通知,藉此找出 Xcode 內部需要監聽的事件。

使用 Objective-C runtime 交換方法,可攔截 Xcode 行為。私有 API 可從 DVTKit、IDEKit、DVTFoundation、IDEFoundation 等 framework 著手,並用 class-dump 取得頭文件。

建立 DVTTextCompletionController 的 Category,在 +load 交換 acceptCurrentCompletion,即可在補全發生時插入日誌。


對 NSView 撰寫遞迴 dump 方法,可輸出 Xcode 主視窗的子檢視結構,幫助理解 IDE 介面組成。

插件與 Xcode 同進程,若插件 crash,Xcode 也會結束。Xcode 升級後,插件可能因 UUID 或私有 API 不相容而失效,可刪除問題插件或等待社群更新。
GitHub 上有許多開源插件可參考,例如 Alcatraz、VVDocumenter、ColorSense、Dash-Plugin、MiniXcode、KSImageNamed、XVim、SCXcodeMiniMap 等。