Qt5 के लिए Qt4 अनुप्रयोग पोर्ट करना

यहाँ कहीं हाल ही में Qt5 में नवाचारों के बारे में एक पोस्ट थी। सब कुछ बहुत अच्छा लग रहा है, लेकिन मौजूदा अनुप्रयोगों के संबंध में चीजें वास्तव में कैसी हैं? इस लेख में, मैं Qt4 के साथ स्रोत संगतता बनाए रखते हुए अपनी एक परियोजना को Qt5 में पोर्ट करने के उदाहरण पर विचार करूंगा।

इसलिए, जैसा कि आप उम्मीद करेंगे, मेरा GUI एप्लिकेशन नहीं जा रहा है। और यह नहीं जा रहा है क्योंकि मैं मानक क्यूटी विजेट का उपयोग करता हूं। एक छोटे परीक्षण के बाद, यह पता चला है कि विगेट्स अब एक अलग मॉड्यूल में हैं और इसे स्पष्ट रूप से शामिल किया जाना चाहिए। चलिए इसे Qt4 के साथ संगत करते हैं - हमारी परियोजना qmake फ़ाइल में निम्न कोड जोड़ें (* .pro | *। .Pri):

greaterThan(QT_MAJOR_VERSION, 4) { QT += widgets DEFINES += HAVE_QT5 } 

इसके अलावा अब से, अतिरिक्त परिभाषित के लिए धन्यवाद, आप अपने कोड में कहीं भी #ifdef HAVE_QT5 सम्मिलित कर सकते हैं और फिर Qt5- विशिष्ट कोड लिख सकते हैं। Ifdef के साथ एक ही प्रभाव सामग्री के साथ एक precompiled शीर्षक बनाकर प्राप्त किया जा सकता है:

 #define HAVE_QT5 (QT_VERSION >= QT_VERSION_CHECK(5, 0, 0)) 

और फिर, मेरी परियोजना नहीं जा रही है। इस बार, कारण लापता Q_WS_ * परिभाषित है। Q_WS_WIN और Q_WS_MAC के साथ सब कुछ बहुत स्पष्ट प्रतीत होता है, बस उन्हें क्रमशः Q_OS_WIN और Q_OS_MAC में बदल दें। लेकिन Q_WS_X11 के साथ क्या करना है? अक्सर, Q_WS_X11 का उपयोग मैक ओएस (X) के अपवाद के साथ यूनिक्स जैसी प्रणालियों के संकेत के रूप में किया जाता है, लेकिन यह भी होता है कि इस परिभाषित कोड के तहत जो X11 के लिए विशिष्ट है, छिपा हुआ है। लेकिन मेरे मामले में, यह मूल रूप से एक ही बात है, इसलिए आप इसे केवल कुछ अन्य परिभाषित के साथ बदल सकते हैं (हम सिर्फ Q_WS_X11 को फिर से परिभाषित नहीं कर सकते, क्योंकि Qt के कुछ हिस्से अभी भी इस परिभाषा का उपयोग करते हैं) और इसे सही जगह पर घोषित करते हैं, उदाहरण के लिए प्रोजेक्ट फ़ाइल में:

 unix:!mac:DEFINES += HAVE_X11 

आगे बढ़ो। मेरा प्रोजेक्ट काफी पुराना है और इसमें बहुत सारी अप्रचलित कक्षाएं या क्लास मेथड या ऐसी कोई भी चीज इस्तेमाल की जाती है जिसे पहले ही Qt5 में फेंक दिया गया हो या प्रतिबंधित कर दिया गया हो। विधानसभा फिर नहीं जाती। जो कुछ निकाला गया है वह Qt5 प्रलेखन में पाया जा सकता है। एक नियम के रूप में, एक ही प्रलेखन कहता है कि बदले में क्या उपयोग किया जाना चाहिए, हालांकि अपवाद हैं कि मैं नीचे चर्चा करूंगा। यदि पुरानी कक्षाएं और उनके तरीके Qt5 प्रलेखन में नहीं पाए जाते हैं, तो ये संभवतः Qt3 के अवशेष हैं और Qt4 प्रलेखन में पाए जा सकते हैं। जो मैं इसके पार आया था, वह ध्यान देने योग्य है: QIconSet, QMenuItem (qt3। क्रमशः QIcon और QAction में परिवर्तित करें), QAbstractItemModel :: reset (use startResResModel / endResetModel), QKeySequence अब int (हम) के माध्यम से (एलओयू) के माध्यम से हमारे तत्वों (लूप) में शामिल हैं। नई QUrlQuery वर्ग में माइग्रेट किया गया, Qt :: एस्केप को हटा दिया गया (इसके इनलाइन रैपर ओवर Qt :: एस्केप और QString :: toHtmlEscaped), qInstallMsgHandler (qInstallMessageHandler) ...

अगला QPA है । सब कुछ ठीक हो जाएगा, लेकिन क्यूटी से इस चीज के आगमन के साथ एक बहुत ही उपयोगी वर्ग QX11Info गायब हो गया, और इस विषय पर प्रलेखन में कुछ भी समझ में नहीं आया। वह गायब हो गया क्योंकि वह ज़लीब से सख्ती से बंधा हुआ था। इसके बजाय, QPlatformNativeInterface Qt5 में दिखाई दिया, जो, हालांकि, जल्द ही प्रतिबंधित कर दिया गया था और अब केवल एक निजी वर्ग / हेडर के रूप में उपलब्ध है। मेरी परियोजना में, एक त्वरित समाधान के रूप में, जो अभी भी ज़लीब से जुड़ा हुआ है, मैंने अभी QX11Info पर एक आवरण लिखा है, जो Qt5 के मामले में इसका स्वयं का कार्यान्वयन है:
x11info.h

 #ifndef X11INFO_H #define X11INFO_H typedef struct _XDisplay Display; class X11Info { static Display *_display; public: static Display* display(); static unsigned long appRootWindow(int screen = -1); }; #endif // X11INFO_H 

x11info.cpp

 #include "x11info.h" #ifdef HAVE_QT5 # include <X11/Xlib.h> # include <QtGlobal> #else # include <QX11Info> #endif Display* X11Info::display() { #ifdef HAVE_QT5 if (!_display) { _display = XOpenDisplay(NULL); } return _display; #else return QX11Info::display(); #endif } unsigned long X11Info::appRootWindow(int screen) { #ifdef HAVE_QT5 return screen == -1? XDefaultRootWindow(display()) : XRootWindowOfScreen(XScreenOfDisplay(display(), screen)); #else return QX11Info::appRootWindow(screen); #endif } Display* X11Info::_display = 0; 

मैं कार्यान्वयन की तार्किक निष्ठा के लिए प्रतिज्ञा नहीं कर सकता, क्योंकि इस लेख के अंत तक कोड का अभी तक परीक्षण नहीं किया गया है।
मेरे पास उदाहरण के लिए QApplication :: x11EventFilter जैसे देशी इवेंट हैंडलर भी हैं। Qt5 में, निश्चित रूप से, उन्हें फिर से लिखना पड़ा। ऐसा करने के लिए, हमें एक QAbstractNativeEventFilter और xcb प्रोग्रामिंग के कुछ ज्ञान की आवश्यकता है (Xlib यहां काम नहीं करेगा क्योंकि QPA इसके बारे में कुछ भी नहीं जानता है)। सिद्धांत रूप में, इन दो पुस्तकालयों के एपीआई की समानता के कारण xcb में संक्रमण बहुत जटिल नहीं है, लेकिन यह मैनुअल पर स्टॉक करने के लिए चोट नहीं पहुंचाएगा। मेरे मामले में, कार्यान्वयन काफी तुच्छ था: अपने आवेदन वर्ग में, x11EventFilter के बगल में, इसने एक और तरीका जोड़ा, जिसे xcbEventFilter कहा जाता है और कई ifdefs केवल आवश्यक विधि को संकलित करने के लिए। इसके बाद, मैंने QAbstractNativeEventFilter से विरासत में एक वर्ग बनाया और इसमें से मैंने सभी xcb घटनाओं के प्रसंस्करण को हमारी विधि में पुनः निर्देशित किया:

 #ifdef HAVE_X11 # ifdef HAVE_QT5 class XcbEventFiter : public QAbstractNativeEventFilter { MyApplication *app; public: XcbEventFiter(MyApplication *app) : app(app) {} virtual bool nativeEventFilter(const QByteArray &eventType, void *message, long *) Q_DECL_OVERRIDE { if (eventType == "xcb_generic_event_t") { return app->xcbEventFilter(message); } return false; } }; # endif // .... #endif 

यदि आप एप्लिकेशन को इनिशियलाइज़ करना चाहते हैं, तो आप ऐप्लिकेशन के सिंगलटन कस्टम को nativeEventFilter में बदल सकते हैं।

आगे प्लगइन्स। Qt5 में, उन्हें एक अलग, असंगत तरीके से लोड किया जाता है और इसे अलग तरह से भी घोषित किया जाना चाहिए। अनुकूलन करने के लिए इस तरह के एक अप्रिय ब्रेकडाउन किया गया था (अब यह सुनिश्चित करने के लिए एक पूर्ण साझा पुस्तकालय के रूप में पूरे प्लगइन को लोड करना आवश्यक नहीं है कि यह सामान्य रूप से एक क्यूटी प्लगइन है और इससे कोई मेटा जानकारी प्राप्त करने के लिए, उदाहरण के लिए, प्रोग्राम का संस्करण जिसके साथ यह प्लगइन है संगत। यहाँ अधिक जानकारी), लेकिन फिर भी इसे किसी भी तरह से मरम्मत करने की आवश्यकता है।
शुरू करने के लिए, हमारे प्लगइन्स के सभी निर्यात मैक्रो इस तरह सशर्त हैं:

 #ifndef HAVE_QT5 Q_EXPORT_PLUGIN2(myplugin, MyPlugin); #endif 

प्लगइन वर्ग में भी, हम सशर्त रूप से एक नया Qt5- विशिष्ट मैक्रो Q_PLUGIN_METADATA कहीं भी Q_INTERFACES के पास जोड़ते हैं, लेकिन Q_OBJECT के बाद:

 #ifdef HAVE_QT5 Q_PLUGIN_METADATA(IID "tld.domain.Project.MyPluginInterface" FILE "myplugin.json") #endif 

File भाग "myplugin.json" केवल तभी आवश्यक है जब हमें प्लगइन में मेटाडेटा की आवश्यकता है, और "tld.domain.Project.MyPluginInterface" इंटरफ़ेस के लिए, यह Q_DECLARE_INTERFACE की तरह ही है। मेरे मामले में, मेटाडेटा में शामिल होगा: प्लगइन संस्करण, कार्यक्रम का न्यूनतम संस्करण और डाउनलोड प्राथमिकता। इसके अलावा, प्लगइन परियोजना फ़ाइलों के लिए HAVE_QT5 घोषणा के साथ जादू जोड़ने के लिए मत भूलना, अच्छी तरह से, या, जादू के बिना एक त्वरित विकल्प के रूप में, #if QT_VERSION> = 0x050000 का उपयोग करें।
स्टैटिक प्लग इन के मामले में, आपको कॉल को Q_IMPORT_PLUGIN मैक्रोज़ में बदलना होगा। वे अब प्लगइन श्रेणी के नाम को एक पैरामीटर के रूप में लेते हैं, न कि Q_EXPORT_PLUGIN2 में पहला पैरामीटर क्या था।

तो, लॉन्च करें! और, जैसा कि अपेक्षित था, सेगफॉल्ट। मेरा कोड QMetaType :: Void == 0 की अपेक्षा करता है, लेकिन Qt5 में यह नहीं है। ओके, फिक्स, रन एंड सेगफॉल्ट फिर से रन। इस बार, समस्या यह है कि कुछ प्रकार एक ही स्थान पर घोषित किए गए हैं, और उनके लिए Q_DECLARE_METATYPE दूसरे में है। किस कारण से, उत्तरार्द्ध, यहां तक ​​कि जब स्पष्ट रूप से एक प्रकार के साथ सक्षम होता है, तो सही ढंग से काम नहीं करता है। मुझे समझ नहीं आ रहा था कि वास्तव में रोड़ा क्या था, मैंने बस Q_DECLARE_METATYPE को उनकी हेडर फ़ाइलों के प्रकारों में स्थानांतरित कर दिया। और फिर से लॉन्च - यह काम करता है!

कार्यक्रम शुरू हो गया है, लेकिन अभी भी बहुत काम है। Xcb में संक्रमण अभी भी भरा होना चाहिए, अर्थात मेरे X11Info वर्ग को xcb का उपयोग करके फिर से लिखने की आवश्यकता है। इसके अलावा, संचालन के लिए जाँच करना आवश्यक है जो कि पैच किया गया था, हालांकि, साथ ही साथ पैच नहीं किया गया था। लेकिन, मुझे आशा है, सबसे मुश्किल खत्म हो गया है!

मुझे आशा है कि मेरा अनुभव आपके लिए उपयोगी होगा। नीचे कुछ लिंक दिए गए हैं जिनसे मुझे Qt5 पहेली हल करने में मदद मिली:

www.kdab.com/porting-from-qt-4-to-qt-5
xcb.freedesktop.org/tutorial
qt-project.org/doc/qt-5.0/qtwidgets/tools-plugandpaint.html
google.com

अद्यतन: Qt5 में निषिद्ध हल करने के लिए उपयोगी बैसाखी