C ++ QML के साथ एकीकरण

प्रविष्टि

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

• QML / जावास्क्रिप्ट वातावरण के बाहर से कार्यक्षमता तक पहुँचना
• कार्यक्षमता-महत्वपूर्ण कार्यों का कार्यान्वयन जहां दक्षता बढ़ाने के लिए मूल कोड आवश्यक है
• बड़े या जटिल गैर-घोषणात्मक कोड जो जावास्क्रिप्ट में लागू करने के लिए थकाऊ होंगे

जैसा कि आप बाद में देखेंगे, Qt QML के लिए आसानी से C ++ कोड प्रदर्शित करता है। इस लेख में, हम एक छोटा लेकिन कार्यात्मक अनुप्रयोग बनाएंगे जो ऐसा करता है। उदाहरण Qt 5 के लिए लिखा गया है और Qt Quick के घटकों का उपयोग करता है, इसलिए उदाहरण को चलाने के लिए आपको कम से कम Qt 5.1.0 की आवश्यकता होती है।

सिंहावलोकन

C ++ प्रकार दिखाने के लिए बुनियादी कदम, इसके गुण, विधियों, संकेतों और स्लॉट्स के साथ, QML वातावरण:

• QObject से विरासत में मिली एक नई कक्षा को परिभाषित करना
• Qt मेटा-ऑब्जेक्ट सिस्टम की सिग्नल, स्लॉट और अन्य सेवाओं का समर्थन करने के लिए एक वर्ग घोषणा में Q_OBJECT मैक्रो रखकर।
• Q_PROPERTY मैक्रो का उपयोग करके गुण घोषित करना
• Qt क्विक इंजन में टाइप रजिस्टर करने के लिए C ++ एप्लिकेशन कोड में qmlRegisterType () को कॉल करें

विवरण Qt दस्तावेज़ीकरण अनुभाग में हैं, MML C ++ QML के लिए विशेषताएँ, और QML के लिए C ++ एक्सटेंशन बनाना ट्यूटोरियल में।

SSH कुंजी जनरेटर

उदाहरण के लिए, चलिए एक छोटा अनुप्रयोग बनाते हैं जो GUI का उपयोग करके सार्वजनिक / निजी SSH कुंजी की एक जोड़ी उत्पन्न करेगा। उपयोगकर्ता को संबंधित मापदंडों के लिए नियंत्रण के साथ प्रदान किया जाएगा, फिर ssh-keygen प्रोग्राम को एक महत्वपूर्ण जोड़ी बनाने के लिए लॉन्च किया जाएगा।

हम नए Qt क्विक कंट्रोल का उपयोग करके यूजर इंटरफेस को लागू कर रहे हैं, क्योंकि यह एक डेस्कटॉप एप्लिकेशन के रूप में था। प्रारंभ में, कुछ अनुभव प्राप्त करने के लिए, हम QML स्रोत कोड के साथ qmlscene चलाते हैं। स्क्रीनशॉट नीचे दिखाया गया है:



उपयोगकर्ता इंटरफ़ेस उपयोगकर्ता से कुंजी के प्रकार के बारे में जानकारी के लिए पूछता है, उत्पन्न निजी कुंजी के लिए फ़ाइल का नाम, और, वैकल्पिक रूप से, एक गुप्त वाक्यांश जिसे पुष्टि करने की आवश्यकता है।

सी ++ वर्ग

अब, एक इंटरफ़ेस होने से, हमें आंतरिक कार्यक्षमता को लागू करने की आवश्यकता है। हम QML से सीधे किसी बाहरी प्रोग्राम को कॉल नहीं कर सकते हैं, इसलिए हमें इसे C ++ (जो हमारे एप्लिकेशन का उद्देश्य है) में लिखना होगा।

सबसे पहले, हम एक वर्ग को परिभाषित करते हैं जो एक कुंजी उत्पन्न करने के लिए कार्यक्षमता को एन्क्रिप्ट करता है (इसे QML में एक नए KeyGenerator वर्ग के रूप में प्रदर्शित किया जाएगा)। यह KeyGenerator.h हेडर फ़ाइल में किया गया है:

#ifndef KEYGENERATOR_H #define KEYGENERATOR_H #include <QObject> #include <QString> #include <QStringList> // Simple QML object to generate SSH key pairs by calling ssh-keygen. class KeyGenerator : public QObject { Q_OBJECT Q_PROPERTY(QString type READ type WRITE setType NOTIFY typeChanged) Q_PROPERTY(QStringList types READ types NOTIFY typesChanged) Q_PROPERTY(QString filename READ filename WRITE setFilename NOTIFY filenameChanged) Q_PROPERTY(QString passphrase READ passphrase WRITE setPassphrase NOTIFY passphraseChanged) public: KeyGenerator(); ~KeyGenerator(); QString type(); void setType(const QString &t); QStringList types(); QString filename(); void setFilename(const QString &f); QString passphrase(); void setPassphrase(const QString &p); public slots: void generateKey(); signals: void typeChanged(); void typesChanged(); void filenameChanged(); void passphraseChanged(); void keyGenerated(bool success); private: QString _type; QString _filename; QString _passphrase; QStringList _types; }; #endif 

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

वैसे, Qt 5.1.0 में Q_PROPERTY मैक्रो की एक नई विशेषता तर्क तर्क है। यह आपको एक वैरिएबल सेट करने की अनुमति देता है जो एक वर्ग का एक सदस्य है जो गेट और सेट फ़ंक्शन को लागू किए बिना एक संपत्ति के लिए बाध्य होगा। यहाँ इस सुविधा का उपयोग नहीं किया गया है।

अगला, हम सेटिंग और प्राप्त करने और संकेतों के लिए तरीकों की घोषणा करते हैं। इसके अलावा जेनरेटके () नाम से एक स्लॉट घोषित करें। यह सब QML के लिए उपलब्ध होगा। यदि हम QML को नियमित विधि बनाना चाहते हैं, तो हमें इसे Q_INVOKABLE के रूप में चिह्नित करना होगा। इस मामले में, जनरेट () विधि को एक स्लॉट बनाने का निर्णय लिया गया था, जितना संभव हो भविष्य में उपयोगी होगा, लेकिन यह आसानी से एक तथाकथित विधि हो सकती है।

अंत में, हम अपनी ज़रूरत के वर्ग के सभी निजी सदस्यों की घोषणा करते हैं।

C ++ कार्यान्वयन

अब, KeyGenerator.cpp में कक्षा के कार्यान्वयन को देखते हैं । यहाँ स्रोत कोड है:

 #include <QFile> #include <QProcess> #include "KeyGenerator.h" KeyGenerator::KeyGenerator() : _type("rsa"), _types{"dsa", "ecdsa", "rsa", "rsa1"} { } KeyGenerator::~KeyGenerator() { } QString KeyGenerator::type() { return _type; } void KeyGenerator::setType(const QString &t) { // Check for valid type. if (!_types.contains(t)) return; if (t != _type) { _type = t; emit typeChanged(); } } QStringList KeyGenerator::types() { return _types; } QString KeyGenerator::filename() { return _filename; } void KeyGenerator::setFilename(const QString &f) { if (f != _filename) { _filename = f; emit filenameChanged(); } } QString KeyGenerator::passphrase() { return _passphrase; } void KeyGenerator::setPassphrase(const QString &p) { if (p != _passphrase) { _passphrase = p; emit passphraseChanged(); } } void KeyGenerator::generateKey() { // Sanity check on arguments if (_type.isEmpty() or _filename.isEmpty() or (_passphrase.length() > 0 and _passphrase.length() < 5)) { emit keyGenerated(false); return; } // Remove key file if it already exists if (QFile::exists(_filename)) { QFile::remove(_filename); } // Execute ssh-keygen -t type -N passphrase -f keyfileq QProcess *proc = new QProcess; QString prog = "ssh-keygen"; QStringList args{"-t", _type, "-N", _passphrase, "-f", _filename}; proc->start(prog, args); proc->waitForFinished(); emit keyGenerated(proc->exitCode() == 0); delete proc; } 

निर्माणकर्ता कुछ चर, वर्ग के सदस्यों को आरंभ करता है। मज़े के लिए, C ++ 11 सुविधा _types वर्ग के एक सदस्य चर को आरंभीकृत करने के लिए आरंभीकरण सूची का उपयोग करती है, जो कि QStringList प्रकार की है। विध्वंसक अब कुछ नहीं करता है, लेकिन पूर्णता और भविष्य के विस्तार के लिए मौजूद है।

टाइप के रूप में पुनर्प्राप्ति कार्य () केवल वर्ग के संबंधित सदस्य चर का मान लौटाते हैं। इंस्टॉलेशन फ़ंक्शंस उपयुक्त चर निर्धारित करते हैं, यह ध्यान रखते हुए कि नया मान पुराने से अलग है और यदि ऐसा है, तो संबंधित सिग्नल का उत्सर्जन करें। कृपया ध्यान दें कि MOC द्वारा बनाए गए संकेतों को, हमेशा की तरह, कार्यान्वित करने की आवश्यकता नहीं है, वे केवल सही समय पर उत्सर्जित हो सकते हैं।

केवल गैर-तुच्छ पद्धति जेनरेटके () स्लॉट है। यह कुछ तर्क जाँच करता है और बाहरी ssh-keygen प्रोग्राम को चलाने के लिए QProcess बनाता है। सरलता के लिए, और चूंकि यह आमतौर पर तेज़ है, हम इसे सिंक्रोनाइज़ करते हैं और ssh-keygen के पूरा होने का इंतज़ार करते हैं। जब यह कार्यक्रम पूरा हो जाता है, तो हम एक संकेत का उत्सर्जन करते हैं जिसमें टाइप बूलियन का तर्क होता है, जो इंगित करता है कि कुंजी पीढ़ी सफल थी या नहीं।

QML कोड

अब main.qml में QML कोड पर एक नज़र डालें :

 // SSH key generator UI import QtQuick 2.1 import QtQuick.Controls 1.0 import QtQuick.Layouts 1.0 import QtQuick.Dialogs 1.0 import com.ics.demo 1.0 ApplicationWindow { title: qsTr("SSH Key Generator") statusBar: StatusBar { RowLayout { Label { id: status } } } width: 369 height: 166 ColumnLayout { x: 10 y: 10 // Key type RowLayout { Label { text: qsTr("Key type:") } ComboBox { id: combobox Layout.fillWidth: true model: keygen.types currentIndex: 2 } } // Filename RowLayout { Label { text: qsTr("Filename:") } TextField { id: filename implicitWidth: 200 onTextChanged: updateStatusBar() } Button { text: qsTr("&Browse...") onClicked: filedialog.visible = true } } // Passphrase RowLayout { Label { text: qsTr("Pass phrase:") } TextField { id: passphrase Layout.fillWidth: true echoMode: TextInput.Password onTextChanged: updateStatusBar() } } // Confirm Passphrase RowLayout { Label { text: qsTr("Confirm pass phrase:") } TextField { id: confirm Layout.fillWidth: true echoMode: TextInput.Password onTextChanged: updateStatusBar() } } // Buttons: Generate, Quit RowLayout { Button { id: generate text: qsTr("&Generate") onClicked: keygen.generateKey() } Button { text: qsTr("&Quit") onClicked: Qt.quit() } } } FileDialog { id: filedialog title: qsTr("Select a file") selectMultiple: false selectFolder: false nameFilters: [ "All files (*)" ] selectedNameFilter: "All files (*)" onAccepted: { filename.text = fileUrl.toString().replace("file://", "") } } KeyGenerator { id: keygen filename: filename.text passphrase: passphrase.text type: combobox.currentText onKeyGenerated: { if (success) { status.text = qsTr('<font color="green">Key generation succeeded.</font>') } else { status.text = qsTr('<font color="red">Key generation failed</font>') } } } function updateStatusBar() { if (passphrase.text != confirm.text) { status.text = qsTr('<font color="red">Pass phrase does not match.</font>') generate.enabled = false } else if (passphrase.text.length > 0 && passphrase.text.length < 5) { status.text = qsTr('<font color="red">Pass phrase too short.</font>') generate.enabled = false } else if (filename.text == "") { status.text = qsTr('<font color="red">Enter a filename.</font>') generate.enabled = false } else { status.text = "" generate.enabled = true } } Component.onCompleted: updateStatusBar() } 

उपरोक्त कोड थोड़ा बड़ा है, हालांकि, अधिकांश कार्य जीयूआई घटकों के लेआउट से संबंधित हैं। इस कोड को स्थानांतरित करने के लिए अत्यंत सरल होना चाहिए।

ध्यान दें कि हम com.ics.demo संस्करण 1.0 आयात करते हैं। जल्द ही, हम देखेंगे कि इस मॉड्यूल का नाम कहां दिखाई देता है। यह नया QML प्रकार KeyGenerator उपलब्ध कराता है और हम इसका एक उदाहरण घोषित करते हैं। इसकी C ++ प्रॉपर्टीज़ तक पहुँच, QML प्रॉपर्टीज़ के रूप में, आप इसके तरीकों को कॉल कर सकते हैं और सिग्नल के साथ काम कर सकते हैं, जैसा कि onKeyGenerated के साथ किया जाता है।

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

हमारा मुख्य कार्यक्रम अनिवार्य रूप से एक आवरण है जैसे कि qmlscene । इसके लिए हमें QML इंजन में इसे एक्सेस करने के लिए अपना टाइप रजिस्टर करना होगा:

 qmlRegisterType<KeyGenerator>("com.ics.demo", 1, 0, "KeyGenerator"); 

यह C ++ प्रकार KeyGenerator को QML प्रकार KeyGenerator के रूप में मॉड्यूल com.ics.demo संस्करण 1.0 में उपलब्ध कराता है, जिसे आयात किया जाएगा।

एक नियम के रूप में, एक निष्पादन योग्य फ़ाइल से QML कोड को चलाने के लिए, मुख्य प्रोग्राम में आप QGuiApplication और QQuickView बनाते हैं । अब, क्यूटी क्विक घटकों का उपयोग करने के लिए थोड़ा अतिरिक्त काम करना पड़ता है यदि शीर्ष-स्तरीय तत्व ApplicationWindow या विंडो है । आप स्रोत कोड देख सकते हैं कि यह कैसे लागू किया जाता है। यह qmlscene का एक छीन लिया गया संस्करण है, उदाहरण के लिए आवश्यक न्यूनतम।

यहाँ मुख्य कार्यक्रम, main.cpp की पूरी सूची दी गई है:

 #include <QApplication> #include <QObject> #include <QQmlComponent> #include <QQmlEngine> #include <QQuickWindow> #include <QSurfaceFormat> #include "KeyGenerator.h" // Main wrapper program. // Special handling is needed when using Qt Quick Controls for the top window. // The code here is based on what qmlscene does. int main(int argc, char ** argv) { QApplication app(argc, argv); // Register our component type with QML. qmlRegisterType<KeyGenerator>("com.ics.demo", 1, 0, "KeyGenerator"); int rc = 0; QQmlEngine engine; QQmlComponent *component = new QQmlComponent(&engine); QObject::connect(&engine, SIGNAL(quit()), QCoreApplication::instance(), SLOT(quit())); component->loadUrl(QUrl("main.qml")); if (!component->isReady() ) { qWarning("%s", qPrintable(component->errorString())); return -1; } QObject *topLevel = component->create(); QQuickWindow *window = qobject_cast<QQuickWindow *>(topLevel); QSurfaceFormat surfaceFormat = window->requestedFormat(); window->setFormat(surfaceFormat); window->show(); rc = app.exec(); delete component; return rc; } 

यदि यह स्पष्ट नहीं है, तो QML के साथ C ++ में लिखे गए मॉड्यूल का उपयोग करते समय, आप qmlscene प्रोग्राम का उपयोग नहीं कर सकते क्योंकि C ++ कोड लिंक नहीं किया जाएगा। यदि आप यह कोशिश करते हैं, तो आपको एक त्रुटि संदेश मिलेगा कि मॉड्यूल स्थापित नहीं है।

निष्कर्ष

यह उदाहरण दिखाता है कि C ++ में नए QML घटक बनाना कितना आसान है और गुण, सिग्नल और स्लॉट प्रदर्शित करते हैं। हालाँकि QML के साथ बहुत कुछ किया जा सकता है, C ++ अभी भी उपयोगी है और आमतौर पर किसी भी गैर-तुच्छ एप्लिकेशन में QML के साथ संयोजन में उपयोग किया जाएगा।

आप यहाँ से सभी नमूना स्रोत कोड डाउनलोड कर सकते हैं ।