您现在的位置: IOS教程網 >> IOS系統 >  >> iOS 訊息 >> iOS 相關資訊

Xcode 6 插件開發入門指南

編輯:iOS 相關資訊

Xcode 提供了建立 App 所需的一切,但因為它並未開源、也沒有官方的插件開發文件,當我們想加入自己的巧思時就顯得缺乏彈性。所幸我們仍能透過一些非官方途徑擴充 Xcode,並把成果分享出去。

Xcode 插件能做什麼

可能性非常多。例如自動產生程式碼註解(VVDocumenter)、在編輯器中直接預覽 UIColor 的實際色彩(ColorSense-for-Xcode)、直接顯示 UIImage 圖檔(KSImageNamed-Xcode),甚至調整控制台配色、修改程式碼風格等等。

此外還可以用 Alcatraz 來管理插件,非常方便。

插件放在哪裡

所有 Xcode 插件都放在這個目錄下:

~/Library/Application Support/Developer/Shared/Xcode/Plug-ins

並以 .xcplugin 作為副檔名。

開發自己的插件

準備工作

  1. 前往 Xcode-Plugin-Template 專案(https://github.com/kattrali/Xcode-Plugin-Template)下載插件開發模板。
  2. 把下載的 template 複製到 ~/Library/Developer/Xcode/Templates/Project Templates/Application Plug-in/Xcode5 Plugin.xctemplate,若缺少對應目錄就自行建立。
  3. 重啟 Xcode,新增專案時就能在 OSX 分類下看到 Application Plug-in 選項,裡面有一個 Xcode Plug-in 模板。

開始開發

用這個模板建立專案後,會發現它已經幫你產生了不少程式碼。先看你專案同名檔案的 initWithBundle 方法:模板在 Edit 選單中加了一個 Do Action 的項目,點擊後會回呼 doMenuAction。

直接執行專案,你會看到一個新的 Xcode 被啟動——畢竟我們做的是 Xcode 插件,用 Xcode 來開發 Xcode 的程式碼,本身就挺有意思。試著點一下新 Xcode 的 Edit 選單裡的 Do Action,並在回呼方法上打中斷點,看看是否真的進入。

DVTPlugInCompatibilityUUIDs

你很可能會發現回呼根本沒被觸發。原因是你的插件不認識目前這個 Xcode 版本,只要把版本資訊告訴它就行了。

  1. 開啟插件專案的 Info.plist,找到 DVTPlugInCompatibilityUUIDs 並展開,這裡列出了你的插件「認識」的所有 Xcode 版本。
  2. 在終端機執行 defaults read /Applications/Xcode.app/Contents/Info DVTPlugInCompatibilityUUID,會回傳一串字串,那就是你目前 Xcode 的 UUID,把它補進 DVTPlugInCompatibilityUUIDs。
  3. 再執行一次,這次就能正常回呼了。

竊聽 Xcode 的通知

由於 Apple 至今未公開 Xcode 插件文件,我們得換個思路摸索——例如監聽操作 Xcode 時它發出的各種通知。

[[NSNotificationCenter defaultCenter] addObserver:self selector:@selector(notificationLog:) name:nil object:nil];

- (void)notificationLog:(NSNotification *)notify {
    NSLog(@"%@", notify.name);
}

把這兩段加進初始化流程,執行後你會看到 Xcode 的通知如雪片般飛來,這些都是理解 Xcode 行為的線索。

動手做一個功能

需求

在 Xcode 的檔案導航區,若想得知某檔案在 Finder 中的位置,得在檔案上按右鍵再選 Show in Finder,而這個項目還沒有快捷鍵。若能一鍵完成,效率會好很多。

思路

  1. 監聽檔案導航區選中檔案變動的通知,保存目前選中檔案的路徑。
  2. 建立一個 NSMenuItem 並設定快捷鍵。
  3. 按下快捷鍵時開啟 workspace 並定位到該檔案。

程式碼

第一步,攔截通知並保存路徑。從先前監听到的通知清單中,可以發現名為 transition from one file to another 的通知,正是我們要的:

- (void)notificationLog:(NSNotification *)notify {
    if ([notify.name isEqualToString:@"transition from one file to another"]) {
        NSURL *originURL = [[notify.object valueForKey:@"next"] valueForKey:@"documentURL"];
        if (originURL != nil && [originURL absoluteString].length >= 7) {
            self.url = [originURL.absoluteString substringFromIndex:7];
        }
    }
}

這裡之所以要 substringFromIndex:7,是因為取到的 URL 形如 file:///User...,而我們需要的是 /User... 的格式。

第二步,建立選單項並綁快捷鍵。改寫模板產生的那幾行即可:

NSMenuItem *menuItem = [[NSApp mainMenu] itemWithTitle:@"Edit"];
if (menuItem) {
    [[menuItem submenu] addItem:[NSMenuItem separatorItem]];
    NSMenuItem *actionMenuItem = [[NSMenuItem alloc] initWithTitle:@"Do action" action:@selector(doMenuAction) keyEquivalent:@"F"];
    [actionMenuItem setKeyEquivalentModifierMask:NSShiftKeyMask];
    [actionMenuItem setTarget:self];
    [[menuItem submenu] addItem:actionMenuItem];
}

關鍵在最後幾行:keyEquivalent 設為 F,修飾鍵設為 Shift,於是快捷鍵就是 Shift + F,你可以依喜好調整。

第三步,按下快捷鍵時定位檔案:

- (void)doMenuAction {
    self.url = [self.url stringByURLDecodingStringParameter];
    [[NSWorkspace sharedWorkspace] selectFile:self.url inFileViewerRootedAtPath:nil];
}

把第一步保存的 URL 傳進去即可,但要記得做一次 URL 解碼,因為 Xcode 給我們的是編碼過的字串。

可用的 Xcode「API」

Xcode 插件開發並不新鮮,因此已有不少開發者 dump 出了 Xcode 的私有 API,可以依需要放進自己的專案。

操作專案檔案:XcodeEditor 提供了一組強大的專案檔操作 API,例如讀取 header、列出 frameworks、加入類別等。要對專案檔做處理時別忘了它。

NSTask:功能等同在終端機執行命令,非常實用。

Cocoa:注意是 Cocoa 而不是 Cocoa Touch,因為 Xcode 是跑在 macOS 上的 App,寫插件時會大量用到 Cocoa API,需要具備 Cocoa 開發基礎。

  1. 上一篇文章:
  2. 下一篇文章:
蘋果刷機越獄教程| IOS教程問題解答| IOS技巧綜合| IOS7技巧| IOS8教程
Copyright © IOS教程網 All Rights Reserved