.NET क्लाइंट लाइब्रेरी का इस्तेमाल शुरू करना

जेफ़ फ़िशर, Google डेटा एपीआई टीम
अगस्त 2007

सुविधा के बारे में जानकारी

Google Data API समाधान
पहली इमेज: Google Data API समाधान

कई डेवलपर के लिए, नए प्रोजेक्ट का सबसे मुश्किल हिस्सा, बॉल को नए सॉफ़्टवेयर पैकेज इंस्टॉल करना, डेवलपमेंट एनवायरमेंट कॉन्फ़िगर करना, और नई लाइब्रेरी सीखना होता है. इस लेख में, मैंने Windows के लिए विज़ुअल स्टूडियो 2005 या Linux के लिए मोनो और अन्य Unix ऑपरेटिंग सिस्टम का इस्तेमाल करके, .NET क्लाइंट लाइब्रेरी से शुरू करने के तरीके के बारे में सिलसिलेवार निर्देश दिए हैं. मुझे उम्मीद है कि ऐसा करने से आपका समय बचेगा. साथ ही, आप कुछ कोड के साथ तेज़ी से काम करना शुरू कर पाएंगे.

विज़ुअल स्टूडियो 2008

अगर आपने विज़ुअल स्टूडियो 2008 को पहले से इंस्टॉल नहीं किया है, तो हो सकता है कि आप विज़ुअल C# 2008 एक्सप्रेस एडिशन का इस्तेमाल करना चाहें, जो विज़ुअल स्टूडियो का मुफ़्त वर्शन है जो आपको .NET क्लाइंट लाइब्रेरी के साथ काम करने की सुविधा देगा.

अपना एनवायरमेंट सेट अप करना

  1. http://code.google.com/p/google-gdata/download/list से क्लाइंट लाइब्रेरी का नया रिलीज़ वर्शन डाउनलोड करें.
  2. पैकेज इंस्टॉल करने के लिए डाउनलोड की गई MCN फ़ाइल चलाएं. यह डिफ़ॉल्ट रूप से "C:\Program Files\Google\Google Data API SDK\" पर इंस्टॉल होगा. इस लेख के और उदाहरण यह मानेंगे कि आपने क्लाइंट लाइब्रेरी को इस जगह पर इंस्टॉल किया था.
  3. स्टार्ट मेन्यू के "Google Data API SDK" फ़ोल्डर में, "Google Data API SDK" नाम की सॉल्यूशन फ़ाइल खोलें.

सैंपल को कंपाइल करना और चलाना

  1. पुष्टि करें कि "बिल्ड > बिल्ड सलूशन" बिना किसी गड़बड़ी के पूरा हो जाता है.
  2. डीबग बिल्ड बनाने के लिए, "बिल्ड > कॉन्फ़िगरेशन मैनेजर" पर जाएं और सक्रिय समाधान कॉन्फ़िगरेशन के तौर पर "डीबग" चुनें. इसके बाद, "Build > Build Solution" चुनें.
  3. आपने जिन बाइनरी और DLL फ़ाइलों को अभी कंपाइल किया है वे आपको "C:\Program Files\Google\Google Data API SDK\Sources\Samples\" में मिल सकती हैं उदाहरण के लिए, "C:\Program Files\Google\Google Data API SDK\Sources\Samples\calendar\bin\Debug\Calendar.exe" एक्ज़ीक्यूट करके, Calendar के लिए ऐप्लिकेशन का नमूना चलाया जा सकता है. इन सैंपल के लिए, स्टार्ट मेन्यू के कुछ शॉर्टकट भी उपलब्ध हैं.

अपना ऐप्लिकेशन डेवलप करना

अगर आपकोन्सी फ़ाइल में दी गई सॉल्यूशन फ़ाइल के अलावा किसी दूसरे प्रोजेक्ट में डेवलपमेंट करना है, तो आपको रेफ़रंस पाथ के तौर पर क्लाइंट लाइब्रेरी DLL फ़ाइलें जोड़नी होंगी.

  1. Google API SDK समाधान के बाहर प्रोजेक्ट बनाएं या खोलें.
  2. प्रोजेक्ट मेन्यू से "रेफ़रंस जोड़ें" चुनें.
  3. ब्राउज़ टैब पर क्लिक करें.
  4. SDK टूल में Redist डायरेक्ट्री पर जाएं: "C:\Program Files\Google\Google Data API SDK\Redist".
  5. वे DLL फ़ाइलें चुनें जिनका इस्तेमाल आपका कोड करेगा. ज़्यादातर ऐप्लिकेशन के लिए Google.GData.Extensions.dll और Google.GData.Client.dll की ज़रूरत होगी. इसके साथ ही, आपको अपने ऐप्लिकेशन में इस्तेमाल की जाने वाली Google की सेवा(सेवाओं) के लिए DLL फ़ाइल की भी ज़रूरत होगी.

ध्यान दें: मोबाइल डिवाइस पर क्लाइंट लाइब्रेरी के लिए, एक सॉल्यूशन फ़ाइल भी मौजूद है. यह डिफ़ॉल्ट रूप से "C:\Program Files\Google\Google Data API SDK\Sources\Library\VS2005.mobile" में मिलता है. यह समाधान सिर्फ़ क्लाइंट लाइब्रेरी के लिए DLL फ़ाइलों को कंपाइल करेगा.

NUnit के टेस्ट चलाना

अगर क्लाइंट लाइब्रेरी में कोई बदलाव किया जाता है या योगदान देने की योजना बनाई जाती है, तो यह पक्का करना कि NUnit के टेस्ट पास सही हो. अगर आप बिना बदलाव किए क्लाइंट लाइब्रेरी का इस्तेमाल करने वाले हैं, तो आम तौर पर उन्हें चलाने की ज़रूरत नहीं होती.

  1. http://www .nunit.org/index.php?p=download से NUnit की.NET 2.0 MSI फ़ाइल रिलीज़ डाउनलोड करें.
  2. सोर्स फ़ाइल को चलाकर NUnit इंस्टॉल करें. इंस्टॉल करने की डिफ़ॉल्ट जगह, "C:\Program Files\NUnit 2.4.8" जैसी होती है. आप इसे "C:\Program Files\NUnit" में बदल सकते हैं, ताकि आप अपने विज़ुअल स्टूडियो प्रोजेक्ट में पाथ बदले बिना NUnit को अपग्रेड कर सकें.
  3. "C:\Program Files\Google\Google Data API SDK\Sources\Library\VS2005" डायरेक्ट्री में जाएं और "Google Data API" नाम की सॉल्यूशन फ़ाइल खोलें. आपको कन्वर्ज़न विज़र्ड दिखेगा, क्योंकि यह एक विज़ुअल स्टूडियो 2005 प्रोजेक्ट फ़ाइल है. प्रॉम्प्ट पर क्लिक करें या "खत्म करें" बटन पर क्लिक करें. इसमें कन्वर्ज़न लॉग दिखना चाहिए. इसे अनदेखा किया जा सकता है.
  4. अब NUnit को रेफ़रंस पाथ के तौर पर जोड़ना होगा. दाईं ओर सॉल्यूशन एक्सप्लोरर में "यूनिट" प्रोजेक्ट पर दायां क्लिक करें और "प्रॉपर्टी" चुनें. अब खुलने वाली विंडो में "रेफ़रंस पाथ" टैब पर क्लिक करें. संदर्भ इकाई के रूप में NUnit इंस्टॉलेशन की "bin" सबडायरेक्ट्री की जगह डालें और "फ़ोल्डर जोड़ें" पर क्लिक करें. उदाहरण के लिए, अगर NUnit को "C:\Program Files\NUnit\" में इंस्टॉल किया गया है, तो आपको "C:\Program Files\NUnit\bin" डालना होगा. आगे बढ़ने से पहले, यह बदलाव सेव करना न भूलें.
  5. क्लाइंट लाइब्रेरी और इकाई की जांच को फिर से बनाने के लिए, नमूने कंपाइल करना और चलाना में दिए गए निर्देशों का पालन करें.
  6. "C:\Program Files\Google\Google Data API SDK\Sources\Library\unittests\" में "unittests.dll.config" फ़ाइल को डीबग बिल्ड डायरेक्ट्री "C:\Program Files\Google\Google Data API SDK\Source\Library\VS2005\unittests\bin\Debug\" में कॉपी करें. जो टेस्ट चल रहे हैं उनकी सही जानकारी शामिल करने के लिए, फ़ाइल में बदलाव करना न भूलें. उदाहरण के लिए, Base को एक API कुंजी की आवश्यकता है और कैलेंडर के लिए एक उपयोगकर्ता नाम और पासवर्ड की आवश्यकता है. हमारा सुझाव है कि आप बिना टेस्ट डेटा वाले टेस्ट खाते का इस्तेमाल करें, ताकि यूनिट टेस्ट से जानकारी को मिटाया न जा सके.
  7. प्रारंभ मेनू से NUnit खोलें.
  8. "फ़ाइल > प्रोजेक्ट खोलें" पर जाएं और "C:\Program Files\Google\Google Data API SDK\Source\Library\VS2005\unittests\bin\Debug\" से "unittests.dll" फ़ाइल चुनें.
  9. उन यूनिट टेस्ट को चलाएं जिनमें आपकी दिलचस्पी है. याद रखें कि कुछ जांच के लिए, testtests.dll.config में पैरामीटर सेट करना ज़रूरी है. अगर आप कुछ सेवाओं के लिए तनाव वाले टेस्ट करते हैं, तो हो सकता है कि आपके टेस्ट खाते को स्पैम जनरेट करने के लिए फ़्लैग किया गया हो. साथ ही, आपके पास कैप्चा से जुड़ी चुनौतियों का सामना किए बिना, Google सर्वर पर कॉन्टेंट को प्रोग्राम के तौर पर सबमिट करने की सुविधा न हो.

मोनो

Mono एक ओपन सोर्स प्रोजेक्ट है, जिसकी मदद से आप Linux, सोलरिस, Mac OS X, Windows, और Unix पर .NET क्लाइंट और सर्वर ऐप्लिकेशन चला सकते हैं. हम उन डेवलपर के लिए अपनी क्लाइंट लाइब्रेरी की एक अलग ZIP फ़ाइल उपलब्ध कराते हैं जो इनमें से किसी एक प्लैटफ़ॉर्म पर काम करना चाहते हैं.

अपना एनवायरमेंट सेट अप करना

  1. http://code.google.com/p/google-gdata/download/list से क्लाइंट लाइब्रेरी की सबसे नई ZIP फ़ाइल रिलीज़ डाउनलोड करें
  2. लोकल डायरेक्ट्री (जैसे, "/scratch/gdata.NET") में एक्सट्रैक्ट करें
  3. मोनो को इंस्टॉल करने के लिए, अपने डिस्ट्रिब्यूशन के पैकेज मैनेजमेंट का इस्तेमाल करें. आप इसे http://www.mono-project.com से भी डाउनलोड कर सकते हैं.
  4. कुछ बंटवारे में, आपको यह पक्का करना होगा कि nunit.framework.dll फ़ाइल मोनो लाइब्रेरी में ठीक से लिंक है. अगर मोनो को "/usr/lib/mono" पर इंस्टॉल किया गया था, तो पक्का करें कि "/usr/lib/mono/1.0" और "/usr/lib/mono/2.0" में सिंबल लिंक मौजूद हैं. nunit.framework.dll (जिसे "/usr/lib/mono/gac/nunit.frameworkn/<someversionstring> में इंस्टॉल किया जाना चाहिए).

सैंपल को कंपाइल करना और चलाना

  1. मान लें कि आपने क्लाइंट लाइब्रेरी को "/scratch/gdata.NET" पर इंस्टॉल किया, तो "/scratch/gdata.NET/clients/cs" डायरेक्ट्री में बदलें.
  2. आप .NET के किस वर्शन का इस्तेमाल करना चाहते हैं, उसके आधार पर Makefile में बदलाव करें. .NET 1.x के लिए, CSC=mcs और .NET 2.x के लिए CSC=gmcs का इस्तेमाल करें.
  3. लाइब्रेरी और सैंपल ऐप्लिकेशन को कंपाइल करने के लिए, make चलाएं.
  4. अगर आप मोनो लाइब्रेरी में क्लाइंट लाइब्रेरी DLL को इंस्टॉल करना चाहते हैं, तो make install को चालू करें.

अपना ऐप्लिकेशन डेवलप करना

अगर क्लाइंट लाइब्रेरी को कंपाइल करने के बाद make install चलाया जाता है, तो आपके पास मोनो सी# कंपाइलर को -r:Google.GData.Extensions.dll -r:Google.GData.Client.dll पास करने के साथ-साथ, अपने कोड में भी लाइब्रेरी शामिल करने का विकल्प होगा. साथ ही, आपको सेवा के किसी खास एक्सटेंशन की DLL फ़ाइलों के रेफ़रंस भी देने होंगे.

NUnit के टेस्ट चलाना

  1. unittests.dll.config फ़ाइल को "/scratch/gdata.NET/clients/cs/src/unittests" से "/scratch/gdata.NET/clients/cs/" में कॉपी करें.
  2. आप जो टेस्ट कर रहे हैं उनकी सही जानकारी शामिल करने के लिए, "/scratch/gdata.NET/clients/cs/unittests.dll.config" में बदलाव करें. उदाहरण के लिए, Base को एक API कुंजी की आवश्यकता है और कैलेंडर के लिए एक उपयोगकर्ता नाम और पासवर्ड की आवश्यकता है. हमारा सुझाव है कि आप बिना टेस्ट डेटा वाले टेस्ट खाते का इस्तेमाल करें, ताकि यूनिट टेस्ट से जानकारी को मिटाया न जा सके.
  3. लाइब्रेरी को कंपाइल करने के बाद, "/scratch/gdata.NET/clients/cs" में unittests.dll फ़ाइल होगी. अपनी पसंद के NUnit टेस्ट मैनेजर (nunit-console, gnunit वगैरह) के साथ इस DLL का इस्तेमाल करें.

नतीजा

अब आपको लाइब्रेरी को कंपाइल करने और सैंपल कोड को चलाने की सुविधा मिल जाएगी. हालांकि, यह तो सिर्फ़ शुरुआत है. मेरी सलाह है कि आप क्लाइंट लाइब्रेरी की ".../clients/cs/docs" डायरेक्ट्री में मौजूद दस्तावेज़ पढ़ें. हो सकता है कि आप .NET क्लाइंट लाइब्रेरी डेवलपर गाइड, प्रोजेक्ट पेज और रेफ़रंस गाइड, और Google Data .NET क्लाइंट लाइब्रेरी फ़ोरम देखना भी चाहें.

इस लेख में दिए गए टूल:

आपके अगले .NET आवेदन के लिए शुभकामनाएं!