अपने Xcode प्लगइन लेखन

अक्सर ऐसी परिस्थितियां होती हैं जब आईडीई की कार्यक्षमता का विस्तार करना होता है। यह भाग्यशाली है अगर ऐसा करने के लिए डेवलपर को उपकरण और प्रलेखन के साथ प्रदान किया जाता है। दुर्भाग्य से, सी एक्सकोड के मामले में, यह मामला नहीं है। Xcode 3.0 के संस्करण पर सुविधाओं का दस्तावेज़ीकरण बंद हो गया है, इसलिए कोई भी गारंटी नहीं देता है कि अगले संस्करण में आपके द्वारा लिखा गया प्लगइन काम करेगा।

नोट: ColorSense-for-Xcode प्लगइन को इस विषय को लिखने के लिए आधार के रूप में लिया गया था।

जैसा कि मैंने कहा, आधिकारिक तौर पर, Xcode प्लगइन्स लिखने के लिए एक सार्वजनिक एपीआई प्रदान नहीं करता है। जब अनुप्रयोग शुरू होता है, तो Xcode प्लगइन्स फ़ोल्डर (~ / लाइब्रेरी / एप्लिकेशन सपोर्ट / डेवलपर / साझा / Xcode / प्लग-इन) को स्कैन करता है और जो (.xcplugin) पाया जाता है उसे डाउनलोड करता है।

वास्तव में, एक साधारण प्लग-इन कुछ घंटों में लिखा जाता है, जिसे आप बाद में देखेंगे।

एक नया Xcode प्रोजेक्ट बनाएं

प्लगइन सिर्फ एक ओएस एक्स बंडल है, टाइप 'बंडल' के साथ एक नया प्रोजेक्ट बनाएं।



प्रोजेक्ट बनाते समय, आपको यह सुनिश्चित करने की आवश्यकता होती है कि ARC बंद हो गया है, क्योंकि Xcode कचरा कलेक्टर के नियंत्रण में काम करता है, वही प्लगइन पर लागू होता है।

प्लगइन का लक्ष्य खोलें और निम्नलिखित सेटिंग्स सेट करें:

• XC4Compatible = हाँ
• XCPluginHasUI = सं
• XCGCReady = YES
• प्रिंसिपल वर्ग = {प्लगइन के मुख्य वर्ग का नाम}

कॉन्फ़िगर सेटिंग्स बनाएँ

हम सेटिंग बनाने और निम्नलिखित सेटिंग्स सेट करने के लिए जाते हैं:

• स्थापना निर्माण उत्पाद स्थान = $ {HOME}
• स्थापना निर्देशिका = / लाइब्रेरी / अनुप्रयोग समर्थन / डेवलपर / साझा / Xcode / प्लग-इन
• तैनाती स्थान = हाँ
• आवरण विस्तार = xcplugin

इसके अलावा, आपको कुछ उपयोगकर्ता-निर्धारित सेटिंग्स जोड़ने की आवश्यकता है:

• GCC_ENABLE_OBJC_GC = समर्थित
• GCC_MODEL_TUNING = G5

हमने संकेत दिया कि असेंबली के बाद हमारा प्लगइन कहाँ स्थापित होना चाहिए। महत्वपूर्ण: प्लगइन्स की डीबगिंग के साथ, सब कुछ दुखी है, और आपको प्रत्येक निर्माण के बाद Xcode को फिर से शुरू करना होगा।

एक प्लगइन लेखन

चलो एक नया वर्ग बनाते हैं और इसे वह नाम कहते हैं जो आपको प्रिंसिपल वर्ग की सेटिंग में मिला था। जब Xcode प्लगइन को लोड करता है, तो + (शून्य) pluginDidLoad: (NSBundle *) प्लगइन विधि कहा जाएगा, जिसमें आप प्लगइन के प्रारंभिक कॉन्फ़िगरेशन (एक नियम के रूप में, प्लगइन एक सिंगलटन है) कर सकते हैं।

+ (void) pluginDidLoad: (NSBundle*) plugin { static id sharedPlugin = nil; static dispatch_once_t once; dispatch_once(&once, ^{ sharedPlugin = [[self alloc] init]; }); } - (id)init { if (self = [super init]) { [[NSNotificationCenter defaultCenter] addObserver:self selector:@selector(applicationDidFinishLaunching:) name:NSApplicationDidFinishLaunchingNotification object:nil]; } return self; } 

ApplicationDidFinishLaunching हैंडलर में: हम सीधे प्लगइन लॉजिक को निष्पादित कर सकते हैं। हमारे मामले में, हम संपादक में कर्सर की स्थिति में परिवर्तन की सूचनाओं की सदस्यता लेंगे, और संपादन मेनू में एक नया आइटम भी जोड़ सकते हैं।

 - (void)applicationDidFinishLaunching:(NSNotification*)notification { [[NSNotificationCenter defaultCenter] addObserver:self selector:@selector(selectionDidChange:) name:NSTextViewDidChangeSelectionNotification object:nil]; NSMenuItem* editMenuItem = [[NSApp mainMenu] itemWithTitle:@"Edit"]; if (editMenuItem) { [[editMenuItem submenu] addItem:[NSMenuItem separatorItem]]; NSMenuItem* newMenuItem = [[NSMenuItem alloc] initWithTitle:@"Show autoresizing masks" action:@selector(toggleMasks:) keyEquivalent:@"m"]; [newMenuItem setTarget:self]; [newMenuItem setKeyEquivalentModifierMask:NSAlternateKeyMask]; [[editMenuItem submenu] addItem:newMenuItem]; [newMenuItem release]; } } 

उदाहरण के लिए, हम कर्सर स्थिति को बदलकर एक पंक्ति का उत्पादन करेंगे:

 - (void)selectionDidChange:(NSNotification*)notification { if ([[notification object] isKindOfClass:[NSTextView class]]) { NSTextView* textView = (NSTextView *)[notification object]; if (![[NSUserDefaults standardUserDefaults] boolForKey:kDLShowSizingsPreferencesKey]) { return; } NSArray* selectedRanges = [textView selectedRanges]; if (selectedRanges.count >= 1) { NSRange selectedRange = [[selectedRanges objectAtIndex:0] rangeValue]; NSString *text = textView.textStorage.string; NSRange lineRange = [text lineRangeForRange:selectedRange]; NSString *line = [text substringWithRange:lineRange]; } NSAlert *alert = [[[NSAlert alloc] init] autorelease]; [alert setMessageText:line]; [alert runModal]; } 

सबसे सरल, कुछ भी उपयोगी प्लगइन नहीं तैयार है!

टिप्पणी

जैसा कि मैंने ऊपर कहा, एक प्लगइन डीबग करना केवल Xcode को पुनरारंभ करने से संभव है (जब मैंने प्लगइन लिखा था, मैंने हर जगह NSAlert डाल दिया और आवश्यक जानकारी प्रदर्शित की)। इस तथ्य के कारण कि कोई दस्तावेज नहीं है, जैसे कि पदानुक्रम में वांछित दृश्य को खोजने के लिए, या यह पता लगाने के लिए कि कौन सी सूचनाएं भेजी गई हैं, उसी चाल को निष्पादित करने के लिए आवश्यक है: जानकारी को लॉग या अलर्ट पर आउटपुट करें। यदि प्लगइन क्रैश हो जाता है, तो Xcode शुरू नहीं होगा, और प्लगइन को '~ / लाइब्रेरी / एप्लिकेशन सपोर्ट / डेवलपर / साझा / Xcode / प्लग-इन' से हटाया जाना चाहिए।

अधिक कार्यात्मक उदाहरण

इस लेख को लिखने के लिए एक शर्त जो मैंने लिखी थी, एक छोटा सा प्लगइन था, जो UIView के लिए ऑटो-साइज़ मास्क प्रदर्शित करता है:



गीथूब पर स्रोत

आपका ध्यान के लिए धन्यवाद!