मैक ओएस एक्स (कोको और उद्देश्य-सी ++ का उपयोग करके) में क्यूटी अनुप्रयोगों को एकीकृत करना

सभी को शुभ दिन!

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

एक नियमित क्यूटी कार्यक्रम में ऐप्पल एचआईजी के साथ कई विसंगतियां हैं। अधिक सटीक रूप से, यह हो सकता है, क्योंकि सभी कार्यक्रमों को अतिरिक्त कार्यक्षमता की आवश्यकता नहीं है। उदाहरण के लिए, प्रत्येक प्रोग्राम को गोदी में आइकन के शीर्ष पर बैज होने की आवश्यकता नहीं है, डॉक मेनू का विस्तार करें या पॉपपी मेनू में कुछ फ़ंक्शन को हटाएं / डुप्लिकेट करें।

लेकिन क्या होगा अगर इस कार्यक्षमता की आवश्यकता है? यदि आपको गोदी में सूचनाओं की संख्या (एक ला स्काइप) प्रदर्शित करने की आवश्यकता है, तो गोदी में आइकन पर क्लिक करें, अपने मेनू आइटम को गोदी में जोड़ें, और यहां तक ​​कि एक सामान्य मेनू भी है, सामान्य रूप से, कार्यक्रम मैक ओएस के मूल जैसा दिखता है? इसमें से कुछ नियमित या अर्ध-प्रलेखित क्यूटी कार्यों का उपयोग करके किया जा सकता है, और कुछ केवल कोको का उपयोग करके किया जा सकता है और तदनुसार, उद्देश्य-सी ... क्या करना है?

उद्देश्य-सी ++ हमारी मदद करेगा!

यह किस तरह का जानवर है और यह किसके साथ खाता है? संक्षेप में, यह उद्देश्य-सी और सी ++ कक्षाओं को एक स्रोत फ़ाइल में संयोजित करने की क्षमता है। इसके अलावा, शीर्षकों का विस्तार मानक (.h) रहता है, लेकिन स्रोतों के लिए आपको एक्सटेंशन निर्दिष्ट करने की आवश्यकता होती है। मिमी ताकि संकलक इसे खा जाए और चोक न हो।

अब कल्पना करें कि हमारे पास Qt के साथ लिखी गई कुछ (शायद एक बड़ी भी) परियोजना है। प्रारंभ में, यह विंडोज या लिनक्स के तहत लिखा गया था, लेकिन अब इसे मैक्रोज़ में स्थानांतरित किया जाना चाहिए, ताकि यह सुंदर और सुविधाजनक हो, ताकि खसखस ​​उत्पादकों को इस राक्षस की नजर में अपनी नाक नहीं झपके।

यह स्पष्ट है कि शुरुआत के लिए, आपको Apple HIG के लिए प्रोग्राम इंटरफ़ेस को ट्विस्ट करने की आवश्यकता है, इसके बिना कहीं भी, लेकिन यह इस लेख के दायरे से परे रहेगा, मैं केवल उपयोगी Q_WS_ * को परिभाषित करता हूं जो आपको विभिन्न ओएस के लिए अलग कोड संकलित करने की अनुमति देता है। हम उन साधनों के बारे में बात करेंगे जिनके द्वारा हम अपने एप्लिकेशन को नए वातावरण में अनुकूलित कर सकते हैं (या स्क्रैच से क्यूटी पर मैक एप्लिकेशन कैसे बनाएं - यह लक्ष्यों पर निर्भर करता है)।

तो चलिए क्रम में।

सामान्य एकीकरण

सबसे पहले, प्रोग्राम को नाम और आइकन दें। नहीं, वह नाम जो बंडल में है, लेकिन वह नाम जो अनुप्रयोग मेनू में प्रदर्शित किया जाएगा। ऐसा करने के लिए, हमें अपनी Info.plist फ़ाइल की आवश्यकता है, न कि उस qmake को उत्पन्न करने की। यह .pro में एक पंक्ति में किया जाता है:

macx: QMAKE_INFO_PLIST = MyInfo.plist 

हमारे .plist में हम कुछ इस तरह लिखते हैं:

 <?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd"> <plist version="1.0"> <dict> <key>LSHasLocalizedDisplayName</key> <true/> <key>CFBundleIconFile</key> <string>myicon.icns</string> <key>CFBundlePackageType</key> <string>APPL</string> <key>CFBundleGetInfoString</key> <string>Created by Qt/QMake</string> <key>CFBundleSignature</key> <string>????</string> <key>CFBundleExecutable</key> <string>MyAppName</string> <key>CFBundleIdentifier</key> <string>com.mycompany.myapp</string> <key>NOTE</key> <string>This file was generated by Qt/QMake.</string> </dict> </plist> 

बेशक, "MyAppName" और "com.mycompany.myapp" के बजाय हम कार्यक्रम का अंग्रेजी नाम और इसके बंडल पहचानकर्ता लिखते हैं। क्यों अंग्रेजी? हां, क्योंकि हम इसे किसी अन्य फ़ाइल में स्थानीयकृत करते हैं। यह सूची में बहुत पहले पैरामीटर द्वारा इंगित किया गया है: LSHasLocalizedDisplayName। निर्देशिका "ru.lproj" और फ़ाइल InfoPlist.strings बनाएँ। इस फ़ाइल में हम कुछ इस तरह लिखते हैं:

 /* Localized versions of Info.plist keys */ CFBundleName = "  "; CFBundleDisplayName = ""; 

यहां आपको पहले से ही बंडल का स्थानीय नाम और एप्लिकेशन मेनू में प्रदर्शित नाम निर्दिष्ट करना होगा। इस कार्य को करने के लिए, प्रोग्राम को इंस्टॉल करते समय, आपको इस निर्देशिका को AppName.app/Contents/Resources पर कॉपी करना होगा, .pro फ़ाइल में INSTALLS निर्दिष्ट करके ऐसा करना बेहतर है, कृपया विवरण के लिए qmake प्रलेखन देखें। स्क्रीनशॉट से पता चलता है कि एप्लिकेशन मेनू में एक रूसी नाम है, इस तथ्य के बावजूद कि बंडल का लैटिन में एक नाम है।


प्रोग्राम आइकन सेट करने के लिए (MyInfo.plist फ़ाइल में myicon.icns देखें), हमें एक .icns फ़ाइल की आवश्यकता है जिसे आप ग्राफिक्स एडिटर में खुद बना सकते हैं, या इसे .ico या प्रोग्राम या ऑनलाइन सेवाओं का उपयोग करके .png के झुंड में परिवर्तित कर सकते हैं । आइकन को अच्छा दिखने के लिए, इसे कई आकारों में बनाना बेहतर है: 512x512, 256x256, 128x128, 64x64, 48x48, 32x32, 16x16। सिस्टम स्वयं चुन लेगा कि किस स्थिति में किस आकार को प्रदर्शित करना है। आइकन वाली फाइल को रिसोर्स में भी इंस्टॉल किया जाना चाहिए। इसे स्थापित करने का सबसे आसान तरीका निम्नलिखित .pro फ़ाइल में लिखना है:

 macx: ICON = myicon.icns 

कोड जुदाई

उद्देश्य-सी ++ की कई सीमाएं हैं। यह असंभव है, उदाहरण के लिए, .cpp स्रोत फ़ाइल में एक उद्देश्य-सी वर्ग इंटरफ़ेस की घोषणा के साथ एक हेडर को शामिल करना, क्योंकि कंपाइलर चोक होगा। नई परियोजनाओं के लिए, केवल मैक ओएस एक्स के लिए डिज़ाइन किया गया है, यह एक सीमा नहीं होगी, क्योंकि आप सभी सी ++ कोड को .mm फ़ाइलों में रख सकते हैं और जीवन का आनंद ले सकते हैं। लेकिन Qt का अर्थ क्रॉस-प्लेटफ़ॉर्म है, इसलिए हम मान लेंगे कि हमारा स्रोत कोड अभी भी .cpp फ़ाइलों में है।

बाहर का रास्ता सरल है। आपको C ++ में Objective-C कॉल्स और क्लासेस के लिए एक रैपर बनाने की आवश्यकता है। मैंने इस संरचना को चुना: एक क्यूटी / सी ++ वर्ग है जो मैक ओएस एक्स के साथ एकीकरण प्रदान करता है। यह स्वयं कुछ काम करता है, और कुछ प्रतिनिधियों को "प्रतिनिधि", एक निजी वर्ग जो सक्रिय रूप से कोको / उद्देश्य-सी का उपयोग करता है। उसी समय, हमें निम्न फ़ाइलें मिलती हैं:

* myclass.h - मुख्य वर्ग के हेडर
* myclass.cpp - कार्यान्वयन
* myclass_p.h - निजी वर्ग हेडर (ऑब्जेक्टिव-सी इंटरफेस के बिना)
* myclass_p.mm - निजी वर्ग के स्रोत, उद्देश्य-सी कक्षाओं के इंटरफेस और कार्यान्वयन में शामिल हो सकते हैं, किसी भी हेडर आदि को शामिल कर सकते हैं।

इस प्रकार, हम स्पष्ट रूप से C ++ और Objective-C ++ के बीच अंतर करते हैं।

वैसे, उद्देश्य-सी ++ के काम करने के लिए, .pro में सभी हेडर / स्रोतों का उपयोग करके फ़ाइल को OBJECTIVE_HEADERS और OBJECTIVE_SORCES वर्गों में रखा जाना चाहिए। और, ज़ाहिर है, इसे macx ब्लॉक के अंदर करें: {}। और यह भी, अगर हम कोको का उपयोग करना चाहते हैं, तो हमें इस रूपरेखा को परियोजना में जोड़ना होगा। हम .pro में लिखते हैं:

 macx: QMAKE_LFLAGS += -framework Cocoa 

और अब मजा आएगा।

डॉक के साथ काम करें

डॉक के साथ काम करने के पांच मुख्य कार्यों पर विचार करें: एक बैज जोड़ना, एक ओवरले जोड़ना, डॉक में आइकन पर एक क्लिक संसाधित करना, डॉक में प्रोग्राम आइकन "टॉस" करना और अपना खुद का मेनू जोड़ना। Qt का उपयोग करके, आप केवल अंतिम समस्या को हल कर सकते हैं, और यहां तक ​​कि खराब दस्तावेज वाले फ़ंक्शन qt_mac_set_dock_menu (QMenu *) के साथ। इसके अलावा, यह खुद को बाहरी घोषित करना चाहिए:

 extern void qt_mac_set_dock_menu(QMenu *); // Qt internal function 

व्यक्तिगत अनुभव के आधार पर, "देशी" मैक मेनू की तुलना में मेनू पर कुछ प्रतिबंध लगाए गए हैं:

* निष्क्रिय (अक्षम) मेनू आइटम किसी कारण से सक्रिय हो जाते हैं
* QMenuTTHide और aboutToShow संकेतों का उत्सर्जन नहीं करता है
* आप किसी भी तत्व को इंडेंट नहीं कर सकते
* यदि मेनू में पहला QAction विभाजक है, तो यह दिखाई देगा (अन्य सभी QMenu अभिव्यक्तियों के विपरीत)

इसलिए आपको इसके अनुकूल होना होगा। आप निश्चित रूप से, उद्देश्य-सी / कोको पर सब कुछ कर सकते हैं, लेकिन फिर आपको QActions और मूल मेनू आइटम मैप करने के लिए अपना खुद का तंत्र बनाना होगा। लेकिन यह केवल यह करने के लिए समझ में आता है अगर इन प्रतिबंधों को खत्म करने की वास्तव में बहुत आवश्यकता है।


अब डॉक पर क्लिक पर विचार करें। अगर हम कोको में लिखते हैं, तो कोई समस्या नहीं होगी, यह आवेदन को लागू करने के लिए पर्याप्त होगा। ShouldHandleReopen: hasVanishWindows: AppDelegate में विधि। लेकिन Qt के आंतों में बनाए गए कार्यक्रम के प्रतिनिधि के पास हमारी सीधी पहुंच नहीं है। इसलिए, हम इस पद्धति के कार्यान्वयन को जोड़ने के लिए रनटाइम के जादू का उपयोग करेंगे। सबसे पहले, हम एक फ़ंक्शन की घोषणा करेंगे, जो हमें लागू होगा जो हमें चाहिए। ऐसा करने के लिए, हम अपनी निजी कक्षा को एक सिंगलटन में बदल देते हैं (वैसे भी, हमें इस वर्ग की एक से अधिक वस्तु की आवश्यकता नहीं है) और इस फ़ंक्शन को लिखें:

 void dockClickHandler(id self, SEL _cmd) { Q_UNUSED(self) Q_UNUSED(_cmd) MyPrivate::instance()->emitClick(); } 

एक फ़ंक्शन एक प्रतिनिधि में एम्बेड किए बिना मृत है। चलो इस के साथ संकोच नहीं है!

 MyPrivate::MyPrivate() : QObject(NULL) { Class cls = [[[NSApplication sharedApplication] delegate] class]; if (!class_addMethod(cls, @selector(applicationShouldHandleReopen:hasVisibleWindows:), (IMP) dockClickHandler, "v@:")) NSLog(@"MyPrivate::MyPrivate() : class_addMethod failed!"); } void MyPrivate::emitClick() { emit dockClicked(); } 

यहां हम अपने आवेदन के प्रतिनिधि वर्ग को लेते हैं और मक्खी पर इसकी विधि जोड़ते हैं। और उसी समय, हम emitClick () पद्धति को लागू करते हैं, जो एक क्लिक के बारे में Qt संकेत का उत्सर्जन करता है। वास्तव में, यह सब, अब हम गोदी पर क्लिक करके दिखा सकते हैं, उदाहरण के लिए, मुख्य कार्यक्रम विंडो।

इसके बाद, आप प्रोग्राम आइकन को डॉक में टॉस करने का प्रयास कर सकते हैं। मेरा पहला विचार: "QApplication :: सतर्क (QWidget *) एक ही काम कर सकता है!" सोचा सच है, लेकिन समय से पहले आशावादी है। बात यह है कि मैक ओएस एक्स 10.6 में। * यह फ़ंक्शन उसी तरह काम करता है, जैसा कि 10.7 में करना चाहिए। * यह किसी कारण से नहीं चाहता है (शायद यह इस तथ्य के कारण है कि क्यूटी 4.7.x आधिकारिक तौर पर शेर का समर्थन नहीं करता है, लेकिन 4.8 में यह तय हो जाएगा)। मुझे समझ नहीं आया कि ऐसा क्यों होता है, और बस कोको पर एक टॉस लिखा, क्योंकि यह एक पंक्ति में किया गया है:

 void MyPrivate::requestAttention() { [NSApp requestUserAttention: NSInformationalRequest]; } 

और कोड के इस टुकड़े को Qt-shn अलर्ट () को डुप्लिकेट करने दें, लेकिन यह Mac OS X के सभी संस्करणों में काम करेगा। और अन्य प्रणालियों के लिए, आप अभी भी अलर्ट () का उपयोग कर सकते हैं।

अब हम बैज के साथ सौदा करते हैं। यदि कोई नहीं जानता है, तो यह एक लाल वृत्त है, जो डॉक में प्रोग्राम आइकन के शीर्ष पर प्रदर्शित पाठ के साथ है। उदाहरण के लिए, इसका उपयोग Mail.app में अपठित संदेशों की संख्या प्रदर्शित करने के लिए किया जाता है। Apple का प्रलेखन कहता है कि इसे इस तरह किया जाना चाहिए:

 [[NSApp dockTile] setBadgeLabel: badgeString]; 

यहां बैजस्ट्रिंग टाइप NSString * है। हाँ, यह पहली असुविधा है! Qt में, QString को आमतौर पर हेरफेर किया जाता है, जिसका अर्थ है कि आपको स्ट्रिंग्स का एक निश्चित "कनवर्टर" लिखने की आवश्यकता है:

 // warning! nsstring isn't released! NSString * nsStringFromQString(const QString & s) { const char * utf8String = s.toUtf8().constData(); return [[NSString alloc] initWithUTF8String: utf8String]; } 

जैसा कि आप कोड से देख सकते हैं (और उस पर टिप्पणी से), लौटा हुआ स्ट्रिंग जारी नहीं किया जाएगा, इसलिए आपको इसे कॉलिंग कोड में करना होगा (क्यूटी एआरसी का उपयोग नहीं करता है, इसलिए हम मेमोरी की निगरानी खुद करेंगे)।

अब हम अपने निजी वर्ग के एक कार्य को लिख सकते हैं जो डॉक के बैज में हमारी ज़रूरत की रेखा प्रदर्शित करेगा:

 void MyPrivate::setDockBadge(const QString & badgeText) { NSString * badgeString = nsStringFromQString(badgeText); [[NSApp dockTile] setBadgeLabel: badgeString]; [badgeString release]; } 

अब डॉक के साथ काम करने का अंतिम पहलू डॉक में एक मनमाना ओवरले जोड़ना है। यह निम्नलिखित कोड का उपयोग करके किया जाता है:

 [[NSApp dockTile] setContentView: view]; 

यहाँ देखें NSView * है। लेकिन हम क्यूटी के साथ काम कर रहे हैं! इसलिए, हमें ओवरले में QWidget * लगाने की आवश्यकता है। QWidget से इसका NSView कैसे प्राप्त करें? हम एक साधारण कार्य लिखते हैं:

 NSView * nsViewFromWidget(QWidget * w) { return (NSView *)w->winId(); } 

यह सरल है, क्यूटी के रचनाकारों ने हमारे लिए लगभग सभी काम किए हैं।

लेकिन, अफसोस, एक बुमेर हमें इंतजार कर रहा है: QWidget से प्राप्त NSView डॉक में स्थापना के लिए अनुपयुक्त है। यही है, यह डाला जाता है, NSDockTile इसे खाता है, लेकिन डॉक में विजेट की सामग्री के बजाय, एक खाली स्थान बनता है। मुझे पता नहीं क्यों लेकिन क्यूटी क्रिएटर में भी, डॉक में प्रगति पट्टी को इसके शुद्ध NSView के माध्यम से ठीक से लटका दिया गया है, विशेष रूप से इसके लिए बनाया गया है। इसलिए, यदि आपको अपने स्वयं के ओवरले की आवश्यकता है, तो कोको में अपना दृष्टिकोण लिखने के लिए आपका स्वागत है। अफसोस।

मेनू के साथ काम करें

चलो खसखस ​​मेनू (शीर्ष पैनल पर एक) पर चलते हैं। डिफ़ॉल्ट रूप से, Qt प्रोग्राम इसे नहीं बनाता है (अच्छी तरह से, सिस्टम फ़ंक्शन के साथ मानक एप्लिकेशन मेनू को छोड़कर)। Qt डेवलपर के लिए पहली बात जो मन में आती है वह है QMenuBar। दरअसल, इसके लिए प्रलेखन का कहना है कि यह एक खसखस ​​मेनू के कार्यों को कर सकता है। लेकिन दो विकल्प हैं: या तो प्रत्येक प्रोग्राम विंडो के लिए एक अलग QMenuBar बनाएं, या एक वैश्विक बनाएं। हम इसके निर्विवाद फायदे के कारण दूसरा विकल्प चुनेंगे।

फिर से, प्रलेखन के आधार पर, हमें एक शून्य माता-पिता के साथ QMenuBar बनाने की आवश्यकता है, अर्थात, QMenuBar * macMenuBar = नया QMenuBar (NULL), तब यह वैश्विक होगा। अधिक सटीक रूप से, इस प्रकार बनाए गए मेनू बार में से पहला वैश्विक हो जाएगा।

और अब - हाथों से बहुत नीरस काम। हम "संपादित करें", "फ़ाइल", "सहायता" मेनू और इतने पर बनाते हैं। यह एक कठिन काम है, लेकिन इसके बिना यह कार्यक्रम अच्छा नहीं लगेगा। इसके अलावा, मानक शॉर्टकट andW और willM क्रमशः विंडोज़ को बंद और कम नहीं करेंगे। उन्हें अपने दम पर भी करना होगा (ठीक है, कम से कम haveQ तुरंत काम करता है)।

मैं मैक ओएस एक्स में QActions की कुछ विशेषताओं पर ध्यान नहीं दूंगा। यदि आप उन्हें शॉर्टकट निर्दिष्ट करते हैं, तो आपको .M शॉर्टकट बनाने के लिए QKeySequence कंस्ट्रक्टर को "Ctrl + M" पास करना होगा। और सामान्य तौर पर, खसखस ​​के तहत Qt में in कुंजी Ctrl की तरह हर जगह जाती है, और मेटा की तरह Ctrl कुंजी। संभवतः कार्यक्रमों की आसान पोर्टेबिलिटी के लिए।

खैर, मेनू बनाने के लिए इस दृष्टिकोण की सीमाओं के बारे में।

* आप मेनू आइटम इंडेंट नहीं कर सकते
* QMenuToHide सिग्नल (केवल aboutToShow) का उत्सर्जन नहीं करता है
* निम्नलिखित बग जगह लेता है: यदि मदद मेनू को "सहायता" कहा जाता है, तो मेनू आइटम खोजने के लिए एक सिस्टम ब्लॉक स्वचालित रूप से इसमें बनाया जाएगा, लेकिन अगर यह रूसी में नाम दिया गया है, तो ऐसा नहीं होगा, भले ही वर्तमान लोकेल रूसी हो । इस गड़बड़ से कैसे छुटकारा पाएं, मुझे अभी तक नहीं मिला है।

लगभग अंतिम - Qt में कस्टम विंडो शीर्षक

मैंने पिछले लेख में Qt प्रोग्राम में जो कुछ लिखा था, उसे लागू करने के लिए, आपको निम्नलिखित कार्य करने होंगे। सबसे पहले, हम निर्धारित करते हैं कि हमें कहाँ बनाए रखना / जारी करना है, क्योंकि एआरसी शामिल नहीं है। दूसरी बात, ऑब्जेक्टिव-सी ++ में, यह अनुमति दी जाती है कि शुद्ध ऑब्जेक्टिव-सी में क्या नहीं किया जा सकता है: एक क्लास लेना अगर यह केवल एक फॉरवर्ड के रूप में घोषित किया जाता है:

 id _class = [NSThemeFrame class]; 

यह हमें इस फ़ंक्शन को कॉल करने से पहले प्रोग्राम में कम से कम एक विंडो होने से बचाता है। अन्यथा, सब कुछ समान है, इसलिए मैंने यहां कोड को कॉपी-पेस्ट नहीं किया। आप इसे उदाहरण में देख सकते हैं (नीचे लिंक)।

निष्कर्ष

इसलिए, हमने ऑब्जेक्टिव-सी ++ की जांच की, जैसा कि मैक ओएस एक्स में एक क्यूटी प्रोग्राम को एकीकृत करने के लिए क्यूटी + कोको बंडल के लिए लागू किया गया है। बड़े और इसमें कुछ भी जटिल नहीं है, अगर आपको ऑब्जेक्टिव-सी और कोको के बुनियादी ज्ञान हैं। आपको इस लेख में ध्यान देने की कोशिश की गई कुछ विशेषताओं को जानना होगा।

अगर किसी को परीक्षण परियोजना के पूर्ण स्रोत कोड में रुचि है, तो GitHub में आपका स्वागत है !

पुनश्च: कोई भी ग्रोथ के माध्यम से कार्यक्रम की सूचनाओं में एम्बेड करने पर विचार कर सकता है, लेकिन पाठक स्वयं ऐसा कर सकता है यदि उसने सामग्री सीखी हो।