N9 के लिए कैलेंडर फ़ीड: यह क्या है और इसे कैसे विकसित किया गया था

यह पोस्ट " स्मार्ट फोन फॉर स्मार्ट पोस्ट " प्रतियोगिता में भाग ले रही है।

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

सावधानी, बहुत पाठ है। यदि आप तैयार हैं, तो ...

तो, कैलेंडर फ़ीड आवेदन। यह पूरी तरह से ओएस में एकीकृत है और फिर से ओएस के माध्यम से बुलाया जाता है, और उपयोगकर्ता द्वारा नहीं (हालांकि उपयोगकर्ता सिस्टम को रीफ़्रेश बटन का उपयोग करके अपडेट डेटा के साथ जल्दी कर सकता है)। सेटिंग्स पूरी तरह से सिस्टम में एकीकृत हैं और इसके भाग की तरह दिखती हैं। ऑपरेशन के दौरान, एप्लिकेशन समय-समय पर (प्रत्येक 20 मिनट में एक बार) फीड को अपलोड करता है (रूसी संस्करण में चैनल) पुराने से हटाते हुए कैलेंडर से निकटतम घटनाओं के साथ एक तत्व। यह तत्व हमेशा शीर्ष एक होता है (इसका समय वर्तमान प्लस एक दिन के रूप में सेट किया जाता है)। एप्लिकेशन में कुछ सेटिंग्स हैं (यह अभी भी बहुत छोटा है और थोड़ा कर सकता है), लेकिन वे बुनियादी कार्यक्षमता की पूर्ण कार्यक्षमता के लिए पर्याप्त हैं। भविष्य में होने वाली घटनाओं (अगले साल या महीने से घटनाओं को दिखाने के लिए नहीं) के दिनों में आप भविष्य में होने वाली घटनाओं (अगर आज बहुत नहीं हैं) और प्रतिबंध (वियोग की संभावना के साथ) के पूरक या नहीं करने के लिए तत्व में घटनाओं की संख्या को कॉन्फ़िगर कर सकते हैं।
स्क्रीनशॉट


खैर, यह सभी गीत हैं और इस एप्लिकेशन के वास्तविक विकास के रूप में दिलचस्प नहीं हैं। अंत में, Habr एक तकनीकी संसाधन है। तो आइए जानें कि यह सब कैसे और अधिक विस्तार से विकसित किया गया।

निम्नलिखित बिंदुओं को हल किया जाएगा:

• घटनाओं को प्रदर्शित करें
  - वर्ग MEventFeed
  - DBus
  - हरमत्तन के कटोरे में DBus हस्ताक्षर संग्रहीत करने की विशेषताएं
• SyncFW
  - मेटाडेटा
  - साझा पुस्तकालय
  - SyncFW प्लगइन का स्थानीयकरण
  - ताज़ा करें बटन द्वारा अद्यतन
• अनुकूलन के लिए एप्लेट
  - एक एप्लेट बनाएं
  - GConfItem का उपयोग करना
• कैलेंडर डेटा पढ़ना
  - पूरे दिन की घटनाओं
  - टुडे तत्वों
  - समय क्षेत्र
• प्रोजेक्ट फाइलें और अन्य सामान्य ज्ञान
  - स्थापना स्क्रिप्ट

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

घटनाओं को प्रदर्शित करें

आवेदन की सबसे महत्वपूर्ण और बुनियादी कार्यक्षमता फ़ीड में तत्वों को जोड़ रही है। ढाई तरीके हैं:

• सरल - MEventFeed वर्ग के माध्यम से;
• अधिक कठिन - DBus के माध्यम से;
• आधे - DBus पर एक रैपर है, जोहान पॉल (जोहान पॉल) द्वारा लिखा गया है, इसे यहाँ देखा जा सकता है: gitorious.org/libharmattaneventview

हम अंतिम विकल्प पर विचार नहीं करेंगे, लेकिन पहले दो पर विचार करेंगे।

कक्षा MEventFeed

इस विकल्प का सुझाव हरमत्तन प्रलेखन द्वारा दिया गया है। वह कुल्हाड़ी की तरह सरल है। एक MEventFeed वर्ग है जिसमें 2 विधियाँ हैं (हालाँकि ऑनलाइन दस्तावेज़ के अनुसार उनमें से तीन हैं, लेकिन तीसरा जो QtSDK लक्ष्य में उपलब्ध नहीं है): addItem और removeItemsBySourceName । पहली विधि फ़ीड में एक तत्व जोड़ती है, दूसरा सभी तत्वों को एक ही स्रोत से हटाता है।

qlonglong addItem(const QString &icon, //  ( ) const QString &title, //  ( ) const QString &body, //    const QStringList &imageList, //  ,      (  Facebook') const QDateTime ×tamp, //   (      ) const QString &footer, //  ( ,   ) bool video, //      imageList    (          ,   ) const QUrl &url, // ,        const QString &sourceName, // Id  const QString &sourceDisplayName //   (      . ,     ) ); 

पहली बार जब मैंने यह देखा, तो मेरा चेहरा खिंच गया था। क्या गेटर्स और सेटरों के साथ एक छोटा वर्ग बनाना और इसे पारित करना वास्तव में असंभव है? खैर, ठीक है, जो दिया गया था, हम उसी के साथ काम कर रहे हैं। टिप्पणियाँ इंगित करती हैं कि प्रत्येक पैरामीटर का क्या अर्थ है। विधि या तो तत्व की आईडी या -1 लौटती है (यदि कुछ गलत हो गया है। अधिकतर, ये गलत तरीके से निर्दिष्ट पैरामीटर हैं)।

 void removeItemsBySourceName(const QString &sourceName); 

वैसे, यहाँ सब कुछ सरल है। हम उसी आईडी को पास करते हैं जिसे पिछली विधि में निर्दिष्ट किया गया था, और इस आईडी वाले सभी तत्व हटा दिए गए हैं।

यह मार्ग सरल और सुविधाजनक है, लेकिन यह हमें संभावनाओं में सीमित करता है। तथ्य यह है कि url के माध्यम से नेविगेट करने के अलावा, एक dbus विधि कॉल अभी भी संभव है। लेकिन इस वर्ग की मदद से आप कॉल की गई विधि के हस्ताक्षर को निर्दिष्ट नहीं कर सकते हैं, इसलिए हम फीड - डब के साथ काम करने के अधिक सार्वभौमिक तरीके पर विचार करेंगे।

DBus

 QDBusMessage message = QDBusMessage::createMethodCall( "com.nokia.home.EventFeed", "/eventfeed", "com.nokia.home.EventFeed", "addItem"); QList<QVariant> args; QVariantMap itemArgs; itemArgs.insert("title", "Calendar"); itemArgs.insert("icon", icon); itemArgs.insert("body", body); itemArgs.insert("timestamp", QDateTime::currentDateTime().addDays(1).toString("yyyy-MM-dd hh:mm:ss")); itemArgs.insert("sourceName", "SyncFW-calendarfeed"); itemArgs.insert("sourceDisplayName", "Calendar Feed"); itemArgs.insert("action", action); QDBusConnection bus = QDBusConnection::sessionBus(); args.append(itemArgs); message.setArguments(args); bus.callWithCallback(message, this, SLOT(dbusRequestCompleted(QDBusMessage))); 

यहां अधिक कोड है, लेकिन हमारे पास एक्शन प्रॉपर्टी सेट करने की क्षमता है (जो डब विधि के हस्ताक्षर को संग्रहीत करता है, लेकिन बाद में और अधिक)। आप उन सभी मापदंडों को सेट कर सकते हैं जो MEventFeed में थे: addItem और प्लस एक्शन। याद रखने वाली एकमात्र चीज टाइमस्टैम्प का स्थानांतरण है। इसे "-- ::". के रूप में एक पंक्ति में प्रेषित किया जाता है "-- ::".
आइकन का उपयोग सिस्टम किया जा सकता है, आइकॉन के पथ के बजाए इसकी आईडी (जो कैलेंडर फ़ीड का उपयोग करता है। आइकॉन के साथ आइकन-एल-कैलेंडर -12 का उपयोग किया जाता है , जहां 12 के बजाय सूची में पहले ईवेंट की संख्या प्रतिस्थापित की जाती है)।

इसके अलावा, DBus का उपयोग करने से आईडी द्वारा आइटम को हटाना और अद्यतन करना संभव हो जाता है (जो MEventFeed में उपलब्ध नहीं है)।

हरमाटन DBus हस्ताक्षर भंडारण सुविधाएँ

मुझे इस पहेली को कुछ शाम को हल करने के लिए काम करना था, लेकिन अंत में ( हेक्सडम्प , स्ट्रिंग्स और ऐसी और ऐसी माँ का उपयोग करके), मैं यह समझने में सक्षम था कि विधि हस्ताक्षर कैसे पारित किया जाए ताकि इसे सही ढंग से कहा जाए।

हमारे पास निम्नलिखित हस्ताक्षर हैं:
com.nokia.Calendar / com.nokia.maemo.meegotouch.CalendarInterface.showMonthView 2011 11 25
जब आप इस पद्धति को डिवाइस पर इन मापदंडों के साथ कॉल करते हैं, तो एक कैलेंडर चयनित दृश्य में 25 नवंबर, 2011 के साथ महीने में खुलता है।

इस विधि को कॉल करने के लिए, हमें तत्व की क्रिया में निम्नलिखित पंक्ति डालने की आवश्यकता है:
com.nokia.Calendar / com.nokia.maemo.meegotouch.CalendarInterface showMonthView AAAAAgAAAAfb AAAAAgAAAAAL AAAAAgAAAAAZ

खैर, इंटरफ़ेस और विधि के नाम के बीच की जगह के साथ, सब कुछ स्पष्ट है। QDBusMessage कंस्ट्रक्टर में , उन्हें दो अलग-अलग मापदंडों में भी विभाजित किया गया है। लेकिन तीन संख्याओं के बजाय तीन अजीब स्ट्रिंग तर्क क्या हैं? सब कुछ बहुत सरल है जब आप जानते हैं, हेह (मैंने 2 या 3 को शाम को बायनेरिज़ और डबस तरीकों में खोदकर मार डाला)। यह एक QDataStream में क्रमबद्ध QVariant ऑब्जेक्ट से Base64 है।

ऐसी लाइनें बनाने के लिए सहायक विधि:

 QString CalendarFeedPlugin::base64SerializedVariant(const QVariant &value) const { QByteArray ba; QDataStream stream(&ba, QIODevice::WriteOnly); stream << value; return ba.toBase64(); } 

यह संदेह है कि इस तरह के एक अंकन का उपयोग हरमत्तन में हर जगह किया जाता है, जहां डब विधि का हस्ताक्षर संग्रहीत किया जाता है।

SyncFW

हमने फ़ीड तत्व बनाने का तरीका सीखा। अब हमें समय-समय पर इसे किसी तरह जोड़ने की जरूरत है। यह सलाह दी जाती है कि राक्षसों को बाड़ न दें जो बैटरी खाएंगे, लेकिन सिस्टम में जितना संभव हो उतना एकीकृत करने के लिए ताकि यह तय हो जाए कि कब अद्यतन करना है।

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

एक महत्वपूर्ण बिंदु: PR1.0 में आपको एक नया प्लगइन स्थापित करने के बाद डिवाइस को रिबूट करने की आवश्यकता है। PR1.1 में, इस समस्या को दरकिनार किया जा सकता है (स्थापना लिपियों अनुभाग देखें)। लेकिन प्लगइन को अपडेट करने के लिए हमेशा रिबूट की आवश्यकता होती है। इसके बिना, पुराने साझा पुस्तकालय का उपयोग किया जाएगा (शायद किसी तरह रिबूट किए बिना इसे अनलोड किया जा सकता है, लेकिन मुझे इस पद्धति का पता नहीं है) नए मेटाडेटा के साथ।

एक अन्य महत्वपूर्ण बिंदु: जहाँ भी कैलेंडरफ़ीड नाम का उपयोग उदाहरणों में किया गया है, यह निहित है कि एक प्लगइन नाम होना चाहिए (पुस्तकालय को lib <plugin_name> -client.so कहा जाना चाहिए, अर्थात हमारे मामले में यह libcalendarfeed -client.so है)। प्लगइन के नाम पर हाइफ़न नहीं होना चाहिए। आदर्श रूप से - केवल लैटिन अक्षर, मुझे लगता है कि संख्याओं के उपयोग की भी अनुमति है (जांच नहीं की)।

मेटाडाटा

प्लगइन का वर्णन करने के लिए, हमें निम्नलिखित फ़ाइलों की आवश्यकता है:

• /etc/sync/profiles/client/calendarfeed.xml
• /etc/sync/profiles/service/calendarfeed.xml
• /etc/sync/profiles/sync/calendarfeed.xml

/etc/sync/profiles/client/calendarfeed.xml

 <?xml version="1.0" encoding="UTF-8"?> <profile name="calendarfeed" type="client" > </profile> 

बस ग्राहक पक्ष की एक प्रोफ़ाइल बनाएँ (साझा पुस्तकालय ग्राहक के रूप में कार्य करता है)

/etc/sync/profiles/service/calendarfeed.xml

 <?xml version="1.0" encoding="UTF-8"?> <profile name="calendarfeed" type="service"> <key name="destinationtype" value="offline"/> <profile name="calendarfeed" type="client" > </profile> </profile> 

हम एक सेवा प्रोफ़ाइल बनाते हैं और इंगित करते हैं कि यह ऑफ़लाइन काम कर सकती है। यही है, हमारे प्लगइन को सफलतापूर्वक काम करने के लिए इंटरनेट कनेक्शन की आवश्यकता नहीं है (भले ही हरमाटन प्रलेखन कहता है कि यह संभव नहीं है, यह वास्तव में संभव है)। एक ग्राहक प्रोफ़ाइल भी इंगित की गई है।

/etc/sync/profiles/sync/calendarfeed.xml

 <?xml version="1.0" encoding="UTF-8"?> <profile name="calendarfeed" type="sync" > <key name="displayname" value="Calendar Feed"/> <key name="enabled" value="true" /> <key name="use_accounts" value="false" /> <key name="hidden" value="true" /> <profile type="service" name="calendarfeed" > </profile> <schedule enabled="true" interval="20" days="1,2,3,4,5,6,7" syncconfiguredtime="" time=""> </schedule> </profile> 

एक सिंक्रनाइज़ेशन प्रोफ़ाइल बनाएं। प्रोफ़ाइल नोड सामग्री:

• displayname - वह नाम जो UI में प्रदर्शित किया जाएगा
• सक्षम - सक्रिय या प्रोफ़ाइल नहीं
• use_accounts - खाता रूपरेखा का उपयोग करना है या नहीं
• hidden - क्या यह प्रोफाइल UI में छिपा है
• प्रोफ़ाइल - सेवा प्रोफ़ाइल

यहाँ सबसे महत्वपूर्ण हिस्सा, निश्चित रूप से, अनुसूची है। इस नोड से मिली जानकारी के अनुसार, हमारा प्लगइन पोल हो जाएगा। इस मामले में, सप्ताह के दिन की परवाह किए बिना हर 20 मिनट में पूछताछ की जाएगी।

लेकिन हमें क्या करना चाहिए अगर हमें हर आधे घंटे में सप्ताहांत पर और कार्यदिवस पर और एक बार हर 15 मिनट पर प्रश्न पूछने की आवश्यकता है? आधे घंटे के साथ यह स्पष्ट है 20 से 30 बदलें और सब कुछ ठीक है। अतिरिक्त शेड्यूल समय सेट करने के लिए, आपको शेड्यूल सबनोड के रूप में रश नोड को सक्षम करने की आवश्यकता है:

 <rush begin="00:00:00" enabled="true" interval="15" end="17:00:00" days="1,2,3,4,5"/> 

साझा पुस्तकालय

लाइब्रेरी में, हमें प्लगइन बनाने और हटाने के लिए वास्तव में एक ब्यूटो :: ClientPlugin वंशज वर्ग और दो बाहरी कार्यों की आवश्यकता है।

 class CalendarFeedPlugin : public Buteo::ClientPlugin { Q_OBJECT public: CalendarFeedPlugin( const QString &pluginName, const Buteo::SyncProfile &profile, Buteo::PluginCbInterface *cbInterface ); virtual ~CalendarFeedPlugin(); virtual bool init(); virtual bool uninit(); virtual bool startSync(); virtual void abortSync(Sync::SyncStatus status = Sync::SYNC_ABORTED); virtual Buteo::SyncResults getSyncResults() const; virtual bool cleanUp(); public slots: virtual void connectivityStateChanged( Sync::ConnectivityType type, bool state ); protected slots: void syncSuccess(); void syncFailed(); void updateFeed(); void dbusRequestCompleted(const QDBusMessage &reply); void dbusErrorOccured(const QDBusError &error, const QDBusMessage &message); private: void updateResults(const Buteo::SyncResults &results); QString base64SerializedVariant(const QVariant &value) const; Buteo::SyncResults m_results; }; extern "C" CalendarFeedPlugin* createPlugin( const QString& pluginName, const Buteo::SyncProfile &profile, Buteo::PluginCbInterface *cbInterface ); extern "C" void destroyPlugin( CalendarFeedPlugin *client ); 

इस हेडर में एक वर्ग होता है जो न्यूनतम आवश्यक के करीब होता है (न्यूनतम होगा यदि संरक्षित स्लॉट और निजी अनुभाग हटा दिए जाते हैं)। बाकी सब कुछ आभासी तरीकों का एक ओवरराइड है (अधिकांश भाग शुद्ध आभासी के लिए)।

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

वर्चुअल बूल यूनिनिट ();
प्लग-इन अनलोड होने से पहले कॉल किया जाता है, आमतौर पर यहां सफाई होती है।

आभासी बूल startSync ();
विधि यह जांचती है कि क्या (और उसे) अपडेट शुरू कर सकते हैं और इसे शुरू कर सकते हैं (एसिंक्रोनस रूप से)। अद्यतन शुरू करने की सफलता का परिणाम देता है।

आभासी शून्य abortSync (सिंक :: सिंकस्टैटस स्थिति = सिंक :: SYNC_ABORTED);
जब उपयोगकर्ता ने अपडेट रद्द कर दिया है तो कॉल किया गया। खातों (जहां ऐसा बटन है) के साथ काम करना आवश्यक है, हमारे मामले में, उपयोगकर्ता के पास अपडेट को रद्द करने का कोई अवसर नहीं है।

वर्चुअल ब्यूटियो :: SyncResults getSyncResults () कास्ट;
अंतिम अद्यतन के परिणाम लौटाता है।

वर्चुअल बूल क्लीनअप ();
जब कोई खाता हटा दिया जाता है तो कॉल किया जाता है। हमारे मामले में, फिर से, इसकी आवश्यकता नहीं है (हालांकि प्रलेखन कहता है कि बाद में इसका उपयोग करना संभव हो सकता है)।

आभासी शून्य कनेक्टिविटीस्टैचेंज (सिंक :: कनेक्टिविटी प्रकार, बूल राज्य);
अगर कनेक्शन की स्थिति बदल गई है तो कॉल किया जाता है। यदि प्लगइन नेटवर्क के साथ काम नहीं करता है, तो यह स्लॉट भी खाली होगा।

यह पता चला है कि सबसे दिलचस्प तरीका startSync () है। और ठीक ही तो है। इसमें, हम टाइमर (यानी, एसिंक्रोनस रूप से) एक विधि के माध्यम से चलाते हैं जो हमारे तत्व को फ़ीड में जोड़ता है। अन्य सभी विधियां ज्यादातर उपयोगिता हैं।

SyncFW प्लगइन का स्थानीयकरण

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

 MLocale locale; locale.installTrCatalog("calendarfeed"); //... itemArgs.insert("title", locale.translate("", "calendar_feed_item_title")); 

ताज़ा करें बटन अपडेट

जैसा कि इंटरनेट के बिना अपडेट करने के मामले में, प्रलेखन हमें बताता है कि रिफ्रेश बटन केवल एम्बेडेड अनुप्रयोगों को अपडेट कर सकता है (पढ़ें: ट्विटर, फेसबुक, आरएसएस फ़ीड, एपी मोबाइल)। लेकिन जब से हम अपने तरीके से जा रहे हैं, तब भी हम इस कथन को स्वयं सत्यापित करने का प्रयास करेंगे।

फ़ीड डेटाबेस में (यह /home/user/.config/meegotouchhome-nokia/eventsfeed.data फ़ाइल में स्थित है और एक नियमित Sqlite डेटाबेस है) हम तीन तालिकाओं को देखते हैं: ईवेंट, चित्र, रीफ्रेशमेंट। पहले दो इस मामले में हमारे लिए बहुत कम रुचि रखते हैं, लेकिन तीसरा बहुत दिलचस्प है। उसकी एक ही विशेषता है - क्रिया । चूंकि फ़ीड तत्व को जोड़कर नाम पहले से ही हमारे लिए परिचित है, इसलिए हम यहां dbus विधि कॉल (ऊपर वर्णित प्रारूप में) के हस्ताक्षर लगाने का प्रयास करेंगे। और यह काम करता है! प्रलेखन फिर से गलत था। ठीक है, ठीक है, लेकिन अब हम उस कार्यक्षमता को लागू कर सकते हैं जिसकी हमें बहुत आवश्यकता है। हम सिस्टम में अधिकतम एकीकरण के मार्ग का अनुसरण कर रहे हैं और यह बहुत अजीब होगा यदि एप्लिकेशन इस बटन का जवाब नहीं देता है।

ठीक है, हमने निर्धारित किया है कि बटन को कैसे बांधें, लेकिन हमारे प्लगइन को इसके शेड्यूल से बाहर कैसे करें? ऐसा करने के लिए, एक तर्क के साथ dbus विधि com.meego.msyncd / सिंक्रोनाइज़र com.meego.msyncd.startSync है - क्लाइंट प्रोफ़ाइल का नाम।

एक छोटा सा विवरण है ... इस तालिका में अपनी कार्रवाई कैसे जोड़ें? वास्तव में, वास्तव में एक SQL क्वेरी नहीं है। सौभाग्य से, dbus में addItem के बगल में addRefreshAction विधि है, जिसमें आप एक हस्ताक्षर के साथ एक पंक्ति पारित कर सकते हैं।

थोड़ी देर बाद, हम addRefreshAction से कॉल करने के लिए एक जगह पाएंगे । इस बीच, आवेदन के साथ ही जारी रखें।

अनुकूलन के लिए एप्लेट

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

एप्लेट निर्माण

MeeGo हरमाटन ऐपलेट बनाने के लिए 3 तरीके प्रदान करता है जिन्हें आप सेटिंग्स में सक्षम कर सकते हैं:

• घोषणा - सेटिंग का सेट xml फ़ाइल द्वारा वर्णित है
• बाइनरी - DcpAppletIf से विरासत के साथ एक साझा पुस्तकालय बनाता है
• बाहरी - एक नियमित अनुप्रयोग का उपयोग करना

तीसरा विकल्प बिल्कुल अच्छा नहीं है (और जिस तरह से प्रलेखन में अनुशंसित नहीं है), क्योंकि यह सेटिंग से एप्लिकेशन पर स्विच करने में देरी का कारण बन सकता है।
दूसरा विकल्प सबसे लचीला है, लेकिन पहले की तुलना में अधिक जटिल है।
पहला विकल्प न्यूनतम रूप से लचीला है, लेकिन एक ही समय में जितना संभव हो उतना सरल है।

चूंकि हमें विशेष रूप से जटिल सेटिंग्स की आवश्यकता नहीं है, इसलिए हम पहला तरीका करेंगे।

इसके लिए हमें दो फाइल चाहिए:

• /usr/share/duicontrolpanel/desktops/calendarfeed.desktop - ades .topktop फ़ाइल जो कि, क्या कहलाती है और कहाँ स्थित है (सामान्य तौर पर, .desktop फ़ाइल का पूरी तरह से मानक उद्देश्य)।
• /usr/share/duicontrolpanel/uideslass/calendarfeed.xml - स्क्रीन पर प्रदर्शित सेटिंग्स के एक सेट का विवरण

हम बदले में उनका विश्लेषण करेंगे।

/usr/share/duicontrolpanel/desktops/calendarfeed.desktop

 [Desktop Entry] Type=ControlPanelApplet Name=Calendar Feed X-logical-id=calendar_feed_title X-translation-catalog=calendarfeed Icon= X-Maemo-Service=com.nokia.DuiControlPanel X-Maemo-Method=com.nokia.DuiControlPanelIf.appletPage X-Maemo-Object-Path=/ # this has to be identical to the value in Name X-Maemo-Fixed-Args=Calendar Feed [DUI] X-DUIApplet-Applet=libdeclarative.so [DCP] Category=Events Feed Order=100 Part=calendarfeed.xml Text2=Calendar events at Feed screen Text2-logical-id=calendar_feed_subtitle 

पहला खंड मानक है। जब तक, X-Maemo- * मापदंडों के अलावा, जो कि इस डब विधि का वर्णन करता है और इस एप्लेट को खोलने के लिए किस तर्क के साथ कॉल करना है।

DUI अनुभाग बताता है कि साझा लाइब्रेरी को कैसे जोड़ा जाए। हमारे मामले में (घोषणात्मक एप्लेट) यह हमेशा libdeclarative.so है। एक बाइनरी एप्लेट के मामले में, DcpAppletIf वंशज के साथ साझा पुस्तकालय का नाम यहां होगा।

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

/usr/share/duicontrolpanel/uidescriptions/calendarfeed.xml

 <settings> <group title="calendar_feed_setting_group_behavior"> <boolean key="/apps/ControlPanel/CalendarFeed/EnableFeed" title="calendar_feed_setting_publish_to_feed"></boolean> <boolean key="/apps/ControlPanel/CalendarFeed/FillWithFuture" title="calendar_feed_setting_fill_with_future"></boolean> <boolean key="/apps/ControlPanel/CalendarFeed/LimitFuture" title="calendar_feed_setting_limit_future"></boolean> <integer key="/apps/ControlPanel/CalendarFeed/LimitDaysSize" title="calendar_feed_setting_future_limit_size" min="1" max="31"></integer> </group> <group title="calendar_feed_setting_group_display"> <integer key="/apps/ControlPanel/CalendarFeed/FeedSize" title="calendar_feed_setting_events_number" min="1" max="5"></integer> <boolean key="/apps/ControlPanel/CalendarFeed/ShowCalendarBar" title="calendar_feed_setting_show_calendar_bar"></boolean> <text key="/apps/ControlPanel/CalendarFeed/DateFormat" title="calendar_feed_setting_date_format">MMM, d</text> <boolean key="/apps/ControlPanel/CalendarFeed/HighlightToday" title="calendar_feed_setting_highlight_today"></boolean> </group> </settings> 

आप हँसेंगे, लेकिन यह उदाहरण एक को छोड़कर सभी प्रकार के नोड्स को सूचीबद्ध करता है, जो कि एक घोषणापत्र में हो सकता है।

सभी प्रकार के नोड्स के लिए, दो मानक मानक हैं:

• कुंजी - GConf में कुंजी
• शीर्षक - UI में प्रदर्शित नाम। आप अनुवादित होने के लिए स्ट्रिंग की आईडी निर्दिष्ट कर सकते हैं (जैसा कि उदाहरण में किया गया था)

हाँ! आश्चर्य, आश्चर्य की बात है! सभी स्वयं Qt-shny MeeGo हरामटन आंतरिक सेटिंग्स को संग्रहीत करने के लिए GConf का उपयोग करते हैं। वैसे, यह GConf की सेटिंग्स है जो बैकअप में आती है।

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

GConfItem का उपयोग करना

हालांकि GConf का उपयोग किया जाता है, फिर भी इसके साथ काम करने के लिए एक Qt वर्ग है - GConfItem। हमें इसके दो तरीके चाहिए: मूल्य () और सेट () । पहला QVariant में पैरामीटर का मान लौटाता है, दूसरा पैरामीटर के मान को बदलता है।

हालांकि, सभी प्रकार समर्थित नहीं हैं। निम्नलिखित नियम लागू होते हैं (gconf और qvariant सुविधाओं के कारण):

• QVariant :: अमान्य - गायब gconf पैरामीटर
• QVariant :: Int , QVariant :: Double , QVariant :: Bool उनके समकक्ष प्रकारों में अनुवाद करते हैं
• QVariant :: स्ट्रिंग केवल utf8 एन्कोडिंग के साथ समर्थित है
• QVariant :: StringList - utf8 में तार की एक सूची।
• QVariant :: सूची सूची QVariant :: Int , QVariant :: डबल , QVariant :: बूल या QVariant :: स्ट्रिंग ( QVariant :: StringList के रूप में लौटेगा ), लेकिन सभी तत्व एक ही प्रकार के होने चाहिए
• अन्य सभी प्रकार (दोनों तरफ) को अनदेखा किया जाता है।

एक घोषणापत्र एप्लेट के मामले में, यह पूरी तरह से उपयुक्त है, क्योंकि एप्लेट एक स्ट्रिंग, एक बूलियन और एक पूर्णांक प्रदान करता है।
GConfItem उदाहरण

 bool fillWithFuture = false; GConfItem fillConfItem("/apps/ControlPanel/CalendarFeed/FillWithFuture"); QVariant fillVariant = fillConfItem.value(); if (fillVariant.isValid()) fillWithFuture = fillVariant.toBool(); else fillConfItem.set(false); 

कैलेंडर डेटा पढ़ना

वास्तव में, आवेदन का सबसे महत्वपूर्ण हिस्सा है। अंत में, हम वहां से कार्यक्रम लाते हैं। सैद्धांतिक रूप से, सब कुछ क्यूटी गतिशीलता के माध्यम से और पूरी तरह से या इसके करीब काम करना चाहिए। आखिरकार, MeeGo अपने मूल में Qt का उपयोग करता है। नोकिया, जो एन 9 जारी करता है, अनिवार्य रूप से क्यूटी का मालिक है। सब कुछ जितना संभव हो उतना एकीकृत किया जाना चाहिए, है ना? Schschazz, हाँ। हमेशा की तरह, यहां एक सुअर लगाया जाता है। लेकिन इस और पोस्ट के लिए, वास्तव में। आने वाली पीढ़ियों के लिए इन सूअरों का वर्णन करना।

पूरे दिन का कार्यक्रम

कैलेंडर में पूरे दिन के लिए एक घटना निर्धारित करने की क्षमता होती है (जो कि समय के बिना होती है)। QOrganizer में इवेंट के लिए एक AllDay पैरामीटर भी है। जो हमेशा झूठा होता है । फिर चाहे वह कैलेंडर पर प्रदर्शित ही क्यों न हो। अस्पष्ट अनुमान लगाता है कि विपरीत सच होगा (यानी, QOrganizer के माध्यम से एक AllDay ईवेंट बनाना कैलेंडर पर कुछ गलत भी पैदा करेगा)। फिर भी, यह निर्धारित करने के लिए एक घटना है कि क्या कोई घटना है या नहीं।

 if (!isAllDay && startDateTime.time().hour() == 0 && startDateTime.time().minute() == 0 && endDateTime.time().hour() == 0 && endDateTime.time().minute() == 0 && startDateTime.date().addDays(1) == endDateTime.date()) isAllDay = true; 

ToDo आइटम

QOrganizer जानता है कि ToDo तत्व हैं। वह उनके लिए अंतिम तिथि भी संग्रहीत करता है। यह सिर्फ इतना है कि इसके माध्यम से यह पता लगाना असंभव है कि टूडो पूरा हुआ या नहीं। यह संभव नहीं है। QOrganizer में ऐसा ही एक ध्वज है, लेकिन जब QOrganizer अंतर्निहित स्तर से डेटा प्राप्त करता है, तो इसे कॉक नहीं किया जाता है। पिछली समस्या के विपरीत, मेरे पास Qt गतिशीलता के माध्यम से कोई समाधान नहीं है। और यह मुझे लगता है कि यह QtMobility (कम से कम अगले फर्मवेयर तक) के माध्यम से बिल्कुल भी नहीं है।

समय क्षेत्र

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

कैलेंडर प्रणाली दो स्तरों (उच्च और निम्न) पर बनाई गई है। उच्च QtMobility में QOrganizer मॉड्यूल के साथ बैठता है, जो उपयोग करने के लिए सुविधाजनक है, लेकिन उपरोक्त घटना के अधीन है (यह एक समय क्षेत्र के साथ क्षेत्र के अस्तित्व पर संदेह नहीं करता है)। कम बैठता है mKCal, जो हमेशा सही डेटा देता है, लेकिन उपयोग करने के लिए बहुत सुविधाजनक नहीं है।

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

शायद, पिछले पैराग्राफ को पढ़ने के बाद, सवाल तुरंत दिखाई दिया: “किस लिए? अभी mKCal पर स्विच करना आसान नहीं है? " वास्तव में, मैं एक संक्रमण के बारे में सोच रहा हूं। लेकिन यह बग काफी वजनदार है और मुझे इसे जल्दी ठीक करना था। एक पूरी तरह से नई प्रणाली के लिए संक्रमण जो मुख्य कार्यक्षमता को लागू करता है, ऐसे कीड़े से भरा होता है जो आप दो बार सोचते हैं। इसलिए, दोहरे समाधान के साथ एक तत्काल फिक्स जारी करने का निर्णय लिया गया, और फिर शांति से, सभी पेशेवरों और विपक्षों को तौला, एक नई प्रणाली पर स्विच किया।

वैसे, mKCal (जो तार्किक है) में पहले दो घटनाओं के बारे में सही जानकारी है।

प्रोजेक्ट फाइलें और अन्य सामान्य ज्ञान

इसलिए, हमने कार्यान्वयन तंत्रों का पता लगाया। यह सब एक साथ रखना है। सबसे पहले, .pro फ़ाइल को देखें

 TEMPLATE = lib TARGET = calendarfeed-client VERSION = 0.3.0 DEPENDPATH += . INCLUDEPATH += . \ /usr/include/libsynccommon \ /usr/include/libsyncprofile \ /usr/include/gq \ /usr/include/mkcal \ /usr/include/kcalcoren LIBS += -lsyncpluginmgr -lsyncprofile -lgq-gconf -lmkcal CONFIG += debug plugin meegotouchevents CONFIG += mobility MOBILITY += organizer QT += dbus #input SOURCES += \ calendarfeedplugin.cpp HEADERS +=\ calendarfeedplugin.h QMAKE_CXXFLAGS = -Wall \ -g \ -Wno-cast-align \ -O2 -finline-functions #install target.path = /usr/lib/sync/ system ("cd translations && lrelease -markuntranslated '' -idbased *.ts") client.path = /etc/sync/profiles/client client.files = xml/calendarfeed.xml sync.path = /etc/sync/profiles/sync sync.files = xml/sync/calendarfeed.xml service.path = /etc/sync/profiles/service service.files = xml/service/calendarfeed.xml settingsdesktop.path = /usr/share/duicontrolpanel/desktops settingsdesktop.files = settings/calendarfeed.desktop settingsxml.path = /usr/share/duicontrolpanel/uidescriptions settingsxml.files = settings/calendarfeed.xml translations.path = /usr/share/l10n/meegotouch translations.files += translations/*qm INSTALLS += target client sync service settingsdesktop settingsxml translations OTHER_FILES += \ qtc_packaging/debian_harmattan/rules \ qtc_packaging/debian_harmattan/README \ qtc_packaging/debian_harmattan/manifest.aegis \ qtc_packaging/debian_harmattan/copyright \ qtc_packaging/debian_harmattan/control \ qtc_packaging/debian_harmattan/compat \ qtc_packaging/debian_harmattan/changelog \ qtc_packaging/debian_harmattan/postinst \ qtc_packaging/debian_harmattan/prerm 

हम एक साझा पुस्तकालय का निर्माण कर रहे हैं (जैसा कि हम SyncFW अनुभाग से याद करते हैं, प्लगइन बस यही होना चाहिए), जिसका नाम Calendarfeed-client (सिंकफ्रीड के कारण भी) है।
हम सभी आवश्यक सिस्टम हेडर और लाइब्रेरी कनेक्ट करते हैं।
कनेक्ट meegotuchevents के लिए MEventFeed (हम dbus के माध्यम से जोड़ने के लिए, लेकिन अभी भी हटाने विधि कॉल पर ही छोड़ दिया है)।
जोड़ना qdbus और गतिशीलता बहती-आयोजक , साथ ही बिंदु बाहर क्या हमारे हेडर और स्रोत फ़ाइलें।
अब तक, सब कुछ मानक है।

इंस्टॉल टिप्पणी के बाद सभी सबसे महत्वपूर्ण।
हम अपने सभी xml और डेस्कटॉप को आवश्यक फ़ोल्डर (लेख के संबंधित अनुभागों में इंगित) में रखते हैं और फ़ोल्डर में स्थानीयकरण डालते हैं/ usr / शेयर / l10n / meegotouch । इस मामले में, फ़ाइलों के लिए पूर्ण रूप से उत्तरदायी तरह का हो calendarfeed_ru.qm , जहां calendarfeed कि में डेस्कटॉप फ़ाइल पैरामीटर में कहा गया है एक्स-अनुवाद-सूची ।

स्थापना स्क्रिप्ट

SyncFW प्लगइन्स के साथ एक दिलचस्प विशेषता है। वे खुद नहीं जानते कि सही तरीके से कैसे स्थापित करें और निकालें। उन्हें रिबूट की जरूरत है। प्लस को हटाने के दौरान हमें अपने आइटम को फ़ीड से निकालना होगा। और रिफ्रेश बटन को इंस्टालेशन के दौरान भी काम करने के लिए रिफ्रेश जोड़ने के लिए अच्छा होगा।

इसके लिए दो स्क्रिप्ट हैं जिन्हें डेब्यू पैकेज में जोड़ा जा सकता है:

• पोस्टस्टीन - स्थापना के तुरंत बाद चलता है
• प्रीरम - अनइंस्टॉल करने से पहले तुरंत चलाएं

postinst

 #!/bin/sh /usr/bin/aegis-exec -s -u user dbus-send --dest=com.meego.msyncd --print-reply /synchronizer com.meego.msyncd.installPlugin string:'calendarfeed' /usr/bin/aegis-exec -s -u user dbus-send --dest=com.nokia.home.EventFeed --print-reply /eventfeed com.nokia.home.EventFeed.addRefreshAction string:'com.meego.msyncd /synchronizer com.meego.msyncd startSync AAAACgAAAAAYAGMAYQBsAGUAbgBkAGEAcgBmAGUAZQBk' gconftool -s /apps/ControlPanel/CalendarFeed/EnableFeed -t bool true /usr/bin/aegis-exec -s -u user dbus-send --dest=com.meego.msyncd --print-reply /synchronizer com.meego.msyncd.startSync string:'calendarfeed' exit 0 

यहां हम स्पष्ट रूप से कहते हैं कि हमने प्लगइन स्थापित किया है (यह केवल PR1.1 में काम करता है, PR1.0 में आपको अभी भी डिवाइस को पुनरारंभ करना होगा), रिफ्रेश जोड़ें, हमारे आवेदन को चालू करें और फ़ीड में आइटम को मैन्युअल रूप से अपडेट करें।

prerm

 #!/bin/sh /usr/bin/aegis-exec -s -u user dbus-send --dest=com.meego.msyncd --print-reply /synchronizer com.meego.msyncd.uninstallPlugin string:'calendarfeed' /usr/bin/aegis-exec -s -u user dbus-send --dest=com.nokia.home.EventFeed --print-reply /eventfeed com.nokia.home.EventFeed.removeItemsBySourceName string:'SyncFW-calendarfeed' exit 0 

फ़ीड से प्लगइन और तत्व निकालें।

वैसे, हालांकि प्लगइन को स्थापित करने की निर्दिष्ट विधि पहली स्थापना के साथ मदद करती है, लेकिन साझा पुस्तकालय को अपडेट करते समय, पुराने को अभी भी रिबूट से पहले उपयोग किया जाता है (यह मेमोरी से अनलोड नहीं है)। डिबगिंग के दौरान कुछ असुविधाएँ होती हैं।

निष्कर्ष

हां।लेख अंत में खत्म हो गया है। मैं इसे लिखने से थक गया हूं, और आप, मुझे लगता है, इसे पढ़ने से थोड़ा थक गए हैं। लेकिन इस लेख के लिए धन्यवाद, हमने सीखा:

• ईवेंट फ़ीड में अपने आइटम को कैसे जोड़ें
• दबाए जाने पर इस तत्व में डब विधि को कैसे जोड़ा जाए
• dbus- ( , ) Harmattan'
• SyncFW
• Settings
• Refresh
• Harmattan QOrganizer (, - )
• Calendar Feed :)

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

और अंत में, लिंक का एक गुच्छा:

• OVI स्टोर पर कैलेंडर फ़ीड
• स्रोत कैलेंडर फ़ीड
• क्यूटी राजदूत शोकेस में कैलेंडर फ़ीड
• हरामतन के हिस्से के दस्तावेज
• हरमाटन विकास अवलोकन

मुझे आशा है कि आप रुचि रखते थे। यही सब है, दोस्तों!