हम एकता पैनल के साथ एकीकरण के लिए फ़ायरफ़ॉक्स एक्सटेंशन लिख रहे हैं

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

यह लेख लिनक्स के लिए सॉफ्टवेयर के डेवलपर्स के साथ-साथ उन लोगों के लिए लक्षित है जो फ़ायरफ़ॉक्स के लिए एक्सटेंशन विकसित करना शुरू करना चाहते हैं। उपयोगकर्ताओं को समाप्त एक्सटेंशन के लिए लिंक का पालन करने के लिए आमंत्रित किया जाता है ।

तो हमें क्या चाहिए:

1. एक्सटेंशन रीस्टार्टलेस रिस्टार्ट । विकास प्रक्रिया के दौरान, आपको एक्सटेंशन का परीक्षण करने के लिए बार-बार ब्राउज़र को पुनरारंभ करना होगा
2. आर्काइव जो आपको मैन्युअल रिपैकिंग के बिना, सीधे संग्रह में फ़ाइलों को संपादित करने की अनुमति देता है। यह उबंटू फाइल-रोलर में मानक अभिलेखागार द्वारा नियंत्रित किया जाता है
3. पाठ संपादक

वास्तव में, इस तरह के एक साधारण विस्तार के लिए पर्याप्त है। आपको एक्सटेंशन डेवलपर एक्सटेंशन उपयोगी भी लग सकता है।

अब हमें अपने विस्तार की संरचना बनाने की आवश्यकता है:

 unityfox
 - क्रोम  
 ---- सामग्री
 ------ main.xul
 - chrome.manifest 
 - install.rdf

हमारा विस्तार स्थानीयकरण या सेटिंग्स का उपयोग नहीं करता है, इसलिए मानक स्थान और प्राथमिकताएं निर्देशिका हमारे लिए उपयोगी नहीं होंगी।

यह सब install.rdf फ़ाइल से शुरू होता है। यह विस्तार के बारे में संक्षिप्त जानकारी का वर्णन करने के लिए प्रथागत है: नाम, विवरण, संस्करण, लेखक, एक अद्वितीय एक्सटेंशन पहचानकर्ता और समर्थित अनुप्रयोगों का एक सेट (समान एक्सटेंशन काम कर सकता है, उदाहरण के लिए, सेमोनकी और फ़ायरफ़ॉक्स में):

<? xml संस्करण = "1.0" ?>

<RDF xmlns = "http://www.w3.org/1999/02/22-rdf-syntax-ns#"
xmlns: em = "http://www.mozilla.org/2004/em-rdf#" >

<विवरण के बारे में = "कलश: मोज़िला: स्थापित-प्रकट" >
<em: id > unityfox@mozilla.org </ em: id >
<em: संस्करण > 0.1.3 </ em: संस्करण >
<em: टाइप > 2 </ em: टाइप >

<em: targetApplication >
<विवरण >
<em: id > {ec8030f7-c20a-464f-9b0e-13a3a9e97384} </ em: id >
<em: minVersion > 4.0 </ em: minVersion >
<em: maxVersion > 6.0a1 </ em: maxVersion >
</ विवरण >
</ em: targetApplication >

<em: नाम > unityfox </ em: नाम >
<em: विवरण > उबंटू एकता पैनल के साथ एकीकरण </ em: विवरण >
<em: निर्माता > लॉकल </ em: निर्माता >
</ विवरण >
</ RDF >

स्पष्टीकरण के बिना फ़ाइल संरचना स्पष्ट होनी चाहिए। एक छोटा स्पष्टीकरण: <em: टाइप> 2 </ em: टाइप> दिखाता है कि यह फ़ाइल एक एक्सटेंशन है, उदाहरण के लिए डिज़ाइन थीम नहीं। {ec8030f7-c20a-464f-9b0e-13a3a9e97384} - फ़ायरफ़ॉक्स ब्राउज़र कोड। संस्करण 4.0 की निचली सीमा इस तथ्य के कारण है कि हम एकता पुस्तकालय के साथ संदेशों का आदान - प्रदान करने के लिए js-ctypes फ़ंक्शन का उपयोग करेंगे।

आपके द्वारा install.rdf लिखने के बाद, आप सीधे कार्य कोड के निर्माण के लिए आगे बढ़ सकते हैं। खिड़की बनाते समय निष्पादित की जाने वाली मुख्य.क्सुल फ़ाइल से हमारे जावास्क्रिप्ट कोड के लिए, आपको chrome.manifest फ़ाइल में ओवरले प्रक्रिया का वर्णन करने की आवश्यकता है:

 सामग्री unityfox क्रोम / सामग्री /
 ओवरले क्रोम: //browser/content/browser.xul क्रोम: //unityfox/content/main.xul

यह ब्राउज़र को हमारी main.xul फ़ाइल को browser.xul ब्राउज़र इंटरफ़ेस के साथ लोड करने के लिए कहता है।

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

• UnityLauncherEntry * unity_launcher_entry_get_for_desktop_id (char * id);
• void unity_launcher_entry_set_count (UnityLauncherEntry * self, gint64 count);
• void unity_launcher_entry_set_count_v अदृश्य (UnityLauncherEntry * self, gboolean दृश्यमान);
• void unity_launcher_entry_set_progress (UnityLauncherEntry * self, gdouble प्रगति);
• void unity_launcher_entry_set_progress_v अदृश्य (UnityLauncherEntry * self, gboolean दृश्यमान);

gint64 si में लंबे समय का एक एनालॉग है, और gboolean int का एक एनालॉग है। UnityLauncherEntry के लिए एक सूचक को एक अनाम संरचना के लिए एक संकेतक माना जा सकता है और साहसपूर्वक एक सूचक को शून्य में डाला जा सकता है। आगे की टिप्पणियाँ सीधे main.xul कोड पर जाएँगी ।

<? xml संस्करण = "1.0"?>
<ओवरले आईडी = "यूनिटीफ़ॉक्स"
xmlns = "http://www.mozilla.org/keymaster/gatekeeper/there.is.only.xul">

<script type = "text / javascript" >

// फ़ायरफ़ॉक्स एक्सटेंशन में, यह xul में वैश्विक गुंजाइश के बारे में सावधान रहने के लिए प्रथागत है
अगर ( "अपरिभाषित" == टाइपोफ़ ( unityProgress ) ) {

var unityProgress = {

सेटअप : फ़ंक्शन ( ) {
// सिस्टम लाइब्रेरी तक पहुंचने के लिए ctypes मॉड्यूल लोड करें
अवयव। बर्तन । आयात ( "संसाधन: //gre/modules/ctypes.jsm" ) ;

// पुस्तकालय libunity.so.4 लोड करें
// हमें कामेच्छा के अभाव में त्रुटियों को उत्पन्न करने के लिए विस्तार की आवश्यकता नहीं है
कोशिश करो {
यह । libunity = ctypes। खुला ( "libunity.so.4" ) ;
} पकड़ ( गलती ) { वापसी ; }

// आवश्यक कामेच्छा कार्यों का वर्णन करें
यह । getEntry = यह । कामवासना । घोषित करें ( "unity_launcher_entry_get_for_desktop_id" ,
ctypes। default_abi ,
ctypes। voidptr_t ,
ctypes। चार । पीटीआर ) ;


यह । setProgress = यह । कामवासना । घोषित करें ( "unity_launcher_entry_set_progress"
ctypes। default_abi ,
ctypes। void_t,
ctypes। voidptr_t ,
ctypes। डबल ) ;

यह । setVisibilityP = यह । कामवासना । घोषित करें ( "एकता_लांचर_सेन्ट्री_सेट_प्रवेशन_विभिन्न" , "
ctypes। default_abi ,
ctypes। void_t,
ctypes। voidptr_t ,
ctypes। int ) ;

यह । setVisibilityN = यह । कामवासना । डिक्लेयर ( "unity_launcher_entry_set_count_v अदृश्य" ,
ctypes। default_abi ,
ctypes। void_t,
ctypes। voidptr_t ,
ctypes। int ) ;

यह । setCount = यह । कामवासना । घोषित करें ( "unity_launcher_entry_set_count" ,
ctypes। default_abi ,
ctypes। void_t,
ctypes। voidptr_t ,
ctypes। लंबी ) ;

// यूनिटीलॉन्चरएन्ट्री के साथ लिबुनिटी लाइब्रेरी के सभी मुख्य कार्य *
यह । प्रविष्टि = यह । getEntry ( "firefox.desktop" ) ;

यह । Cc = अवयव। कक्षाएं ;
यह । सिय = अवयव। इंटरफेस ;
यह । IDLM = यह । सी.आई. nsIDownloadManager ;

// पैनल को डाउनलोड-मैनेजर सेवा का उपयोग करके अपडेट किया जाएगा
// सभी अंतर्निहित सेवाओं के इंटरफेस को https://developer.mozilla.org पर वर्णित किया गया है
यह । dlMgr = यह । Cc [ "@ mozilla.org / download-manager; 1" ] । getService ( यह । IDLM ) ;
यह । dlMgr । addListener ( यह ) ;
} ,

// अपडेट फ़ंक्शन को डाउनलोड-मैनेजर से प्रत्येक ईवेंट पर बुलाया जाता है
अद्यतन : फ़ंक्शन ( ) {
var कुल = 0 , cur = 0 , count = 0 ;
var dls = यह । dlMgr । activeDownloads ;
जबकि ( dls। हैमोरियल ( ) ) {
var dl = dls। getNext ( ) । QueryInterface ( यह । Ci । एनएसआईडी डाउनलोड ) ;
// निष्क्रिय डाउनलोड और डाउनलोड को छोड़ दें जिनका अंत समय अज्ञात है
अगर ( dl। राज्य ! = यह ! IDLM । DOWNLOAD_DOWNLOADING || dl। प्रतिशत । पूरा == - 1 )
जारी रखें ;

// कुल आकार, लोड किए गए आकार और डाउनलोड की संख्या की गणना करें
कुल + = डीएल। आकार;
cur + = डीएल। राशि
गिनती ++;
}

अगर ( कुल == 0 ) {
// यदि कोई डाउनलोड नहीं है, तो पैनल में काउंटर और बार छिपाएं
यह । setVisibilityP ( यह प्रविष्टि ; 0 ) ;
यह । setVisibilityN ( यह प्रविष्टि ; 0 ) ;
} {
// डाउनलोड प्रगति (0 से 1 तक) और डाउनलोड की संख्या दिखाएं
यह । सेटप्रोग्रेस ( यह प्रविष्टि ; क्यूर / टोटल ) ;
यह । सेटकाउंट ( यह प्रविष्टि ; गिनती ) ;
यह । setVisibilityP ( यह प्रविष्टि ; 1 ) ;
यह । setVisibilityN ( यह प्रविष्टि ; 1 ) ;
}
} ,

// यह ऑब्जेक्ट समवर्ती रूप से nsIDownloadProgressListener है।
// nsIDownloadManager नीचे वर्णित कार्यों के लिए संदेश भेजेगा
onDownloadStateChange : फ़ंक्शन ( ) { यह । अद्यतन ( ) } ,
onStateChange : फ़ंक्शन ( ) { यह । अद्यतन ( ) } ,
onProgressChange : फ़ंक्शन ( ) { यह । अद्यतन ( ) } ,
onSecurityChange : फ़ंक्शन ( ) { यह । अद्यतन ( ) }
} ;
}

// अंत में, तथाकथित के माध्यम से एकताप्रणाली को इनिशियलाइज़ करें अनाम नाम स्थान
( फ़ंक्शन ( ) { यह । सेटअप ( ) ; } ) । लागू ( unityProgress ) ;
</ Script>
</ ओवरले>

एक्सटेंशन तैयार है। अब यूनिटीफॉक्स डाइरेक्टरी की फाइलों को ज़िप आर्काइव में पैक किया जा सकता है, फाइल एक्सटेंशन को .xpi में बदलें और ब्राउजर विंडो पर ड्रैग और ड्रॉप करके सेट करें।

एक समाप्त विस्तार और सामग्री की सूची addons.mozilla.org/en/firefox/addon/unityfox पर देखी जा सकती है। बोन एपेटिट!

_{इस लेख का पाठ CC BY-SA 3.0 के तहत लाइसेंस प्राप्त है}