بدء استخدام مكتبة عميل NET.

جيف فيشر، فريق Google Data APIs
آب (أغسطس) 2007

المقدمة

حل Google Data API
الشكل 1: حل Google Data API

بالنسبة إلى العديد من مطوّري البرامج، فإن الجزء الأصعب من المشروع الجديد هو الحصول على حلول تكميلية لتثبيت حزم برامج جديدة، وتهيئة بيئة تطوير، وتعلّم مكتبات جديدة. في هذه المقالة، جمعت بعض التعليمات التفصيلية حول كيفية البدء بمكتبة عميل NET .باستخدام Visual Studio 2005 لنظام التشغيل Windows أو Mono لنظام التشغيل Linux وأنظمة تشغيل Unix الأخرى. وأتمنى أن يوفر لك هذا بعض الوقت للبدء في استخدام الرموز البرمجية بسرعة.

استوديو مرئي 2008

إذا لم يسبق لك تثبيت Visual Studio 2008، ننصحك باستخدام Visual C# 2008 Express Edition، وهو إصدار مجاني من Visual Studio يتيح لك العمل مع مكتبة عميل NET.

إعداد البيئة

  1. نزّل أحدث إصدار من MSI لمكتبة العميل من http://code.google.com/p/google-gdata/downloads/list.
  2. شغّل ملف MSI الذي تم تنزيله لتثبيت الحزمة. سيتم التثبيت تلقائيًا على "C:\Program Files\Google\Google Data API SDK\". ستفترض أمثلة أخرى في هذه المقالة أنك قمت بتثبيت مكتبة العميل على هذا الموقع.
  3. افتح ملف الحل الذي يحمل اسم "حزمة SDK لواجهة برمجة التطبيقات لبيانات Google" في المجلد "حزمة SDK لواجهة برمجة التطبيقات لبيانات Google" في القائمة "ابدأ".

تجميع العيّنات وتشغيلها

  1. تحقَّق من اكتمال تشغيل "الإصدار > حل الإصدار" بدون أي أخطاء.
  2. لإنشاء إصدار تصحيح الأخطاء، انتقِل إلى "الإصدار > مدير الإعداد" واختَر "تصحيح الأخطاء" كإعداد الحل النشط. ثم حدد "إنشاء > إنشاء حل".
  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". وهناك أيضًا بعض اختصارات القائمة "ابدأ" لهذه النماذج.

تطوير تطبيقك الخاص

إذا كنت ترغب في تطوير مشروع خارج ملف الحل الذي يوفره ملف MSI، فستحتاج إلى إضافة ملفات DLL لمكتبة العميل كمسار مرجعي.

  1. إنشاء مشروع أو فتحه خارج حل Google API SDK.
  2. حدد "إضافة مرجع" من قائمة المشروع.
  3. انقر على علامة التبويب تصفح.
  4. انتقِل إلى الدليل Redist في SDK: "C:\Program Files\Google\Google Data API SDK\Redist".
  5. حدد ملفات DLL التي سيتم استخدامها بواسطة الشفرة. وستكون هناك حاجة إلى Google.GData.Extensions.dll وGoogle.GData.Client.dll لمعظم المشاريع، بالإضافة إلى ملف DLL الخاص بخدمة(خدمات) Google التي تستخدمها في تطبيقك.

ملاحظة: هناك أيضًا ملف حل لمكتبات العملاء على أجهزة الجوّال. ويمكنك العثور عليه في "C:\Program Files\Google\Google Data API SDK\Sources\Library\VS2005.mobile" تلقائيًا. سيعمل هذا الحل على تجميع ملفات DLL لمكتبات العميل فقط.

إجراء اختبارات NUnit

ويُعدّ التأكّد من اجتياز اختبارات NUnit المناسبة خطوة مهمة إذا كنت تجري أي تغييرات على مكتبات العملاء أو تخطط للمساهمة فيها. إذا كنت تخطط لاستخدام مكتبات العملاء بدون تعديلات، فليس هناك حاجة عادةً إلى تشغيلها.

  1. نزّل إصدار ملف .NET 2.0 MSI من NUnit من http://www.nunit.org/index.php?p=download.
  2. ثبت NUnit بتشغيل ملف MSI. يشبه موقع التثبيت الافتراضي "C:\Program Files\NUnit 2.4.8". قد ترغب في تغيير هذا إلى شيء مثل "C:\Program Files\NUnit" حتى تتمكن من ترقية NUnit في المستقبل دون الحاجة إلى تغيير المسار في مشروع Visual Studio.
  3. انتقل إلى الدليل "C:\Program Files\Google\Google Data API SDK\Sources\Library\VS2005" وافتح ملف الحل الذي يحمل اسم "Google Data APIs". ستشاهد معالج التحويل بما أن هذا ملف مشروع Visual Studio 2005. انقر على المطالبات أو انقر على الزر "إنهاء". ويجب أن يعرض هذا السجل سجل التحويل، والذي يمكن تجاهله.
  4. يجب إضافة NUnit الآن كمسار مرجعي. انقر بزر الماوس الأيمن على مشروع "unittests" في مستكشف الحلول على اليسار وحدد "خصائص". انقر الآن على علامة التبويب "مسارات الإحالة" في النافذة التي تفتح. أدخل موقع الدليل الفرعي "bin" لتثبيت NUnit كمسار مرجعي وانقر على "إضافة مجلد". على سبيل المثال، إذا تم تثبيت NUnit في "C:\Program Files\NUnit\"، يتم إدخال "C:\Program Files\NUnit\bin". تأكد من حفظ هذا التغيير قبل المتابعة.
  5. اتبع الخطوات الواردة في إنشاء نماذج وتشغيلها لإعادة إنشاء مكتبة العميل واختبارات الوحدة.
  6. انسخ ملف "unittests.dll.config" في "C:\Program Files\Google\Google Data API SDK\Sources\Library\unittests\" إلى دليل إنشاء تصحيح الأخطاء "C:\Program Files\Google\Google Data API SDK\Source\Library\VS2005\unittests\bin\Debug\". تذكر تعديل الملف لتضمين المعلومات المناسبة للاختبارات التي تجريها. على سبيل المثال، يتطلب Base مفتاح واجهة برمجة تطبيقات بينما يتطلب التقويم اسم مستخدم وكلمة مرور. ويُوصى باستخدام حساب تجريبي بدون أي بيانات مباشرة لتجنب حذف المعلومات بواسطة اختبارات الوحدة.
  7. افتح NUnit من قائمة "ابدأ".
  8. انتقِل إلى "الملف > فتح المشروع" واختَر الملف "unittests.dll" من "C:\Program Files\Google\Google Data API SDK\Source\Library\VS2005\unittests\bin\Debug\".
  9. أجرِ اختبارات الوحدة التي تهتم بها. وتذكّر أن بعض الاختبارات تتطلب ضبط المَعلمات في unittests.dll.config حتى تعمل. إذا كنت تجري اختبارات الإجهاد لخدمات معينة، فقد يتم وضع علامة على حسابك التجريبي على أنه يُنشئ رسائل غير مرغوب فيها ولن تتمكن من إرسال المحتوى برمجيًا إلى خوادم Google دون مواجهة تحديات اختبار CAPTCHA.

أحادي

Mono هو مشروع مفتوح المصدر يسمح لك بتشغيل تطبيقات الخادم والخادم NET .على Linux و Solaris وMac OS X وWindows وUnix. نقدم ملف ZIP منفصلاً لمكتبة عملائنا لمطوري البرامج الذين يرغبون في العمل على أحد هذه الأنظمة الأساسية.

إعداد البيئة

  1. نزّل أحدث إصدار من ملف ZIP لمكتبة العميل من http://code.google.com/p/google-gdata/downloads/list
  2. الاستخراج إلى دليل محلي (مثل "/scratch/gdata.NET")
  3. استخدم إدارة حزمة التوزيع لتثبيت Mono. بدلاً من ذلك، يمكنك تنزيله من 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.framework/<someversionstring>).

تجميع العيّنات وتشغيلها

  1. بافتراض أنك قمت بتثبيت مكتبة العميل على "/scratch/gdata.NET"، قم بالتغيير إلى الدليل "/scratch/gdata.NET/clients/cs".
  2. عدّل Makefile حسب إصدار NET .الذي تريد استخدامه. بالنسبة إلى .NET 1.x، يمكنك استخدام CSC=mcs وبالنسبة إلى .NET 2.x، يمكنك استخدام CSC=gmcs.
  3. يمكنك تشغيل make لتجميع المكتبات ونماذج التطبيقات.
  4. نفِّذ make install إذا كنت تريد تثبيت DLLs لمكتبة العميل في مكتبة Mono.

تطوير تطبيقك الخاص

إذا نفّذت make install بعد تجميع مكتبة العميل، من المفترض أن تكون قادرًا على تضمين المكتبات في رمزك الخاص من خلال تمرير -r:Google.GData.Extensions.dll -r:Google.GData.Client.dll إلى مجمّع Mono C# بالإضافة إلى مراجع إلى ملفات 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 مفتاح واجهة برمجة تطبيقات بينما يتطلب التقويم اسم مستخدم وكلمة مرور. أوصي باستخدام حساب تجريبي بدون أي بيانات مباشرة لتجنب حذف المعلومات بواسطة اختبارات الوحدة.
  3. بعد تجميع المكتبة، سيكون هناك ملف unittests.dll في "/scratch/gdata.NET/clients/cs". يمكنك استخدام ملف DLL هذا مع مدير اختبارات NUnit الذي تختاره (nunit-console وgnunit وما إلى ذلك).

الخاتمة

من المفترض أن تتمكن الآن من تجميع المكتبات وتشغيل نموذج الشفرة. ولكن هذه ليست سوى البداية. أنصحك بقراءة الوثائق الموجودة في دليل ".../clients/cs/docs" في مكتبة العميل. ويمكنك أيضًا الاطّلاع على دليل مطوّري مكتبة مكتبة NET. وصفحة المشروع والدليل المرجعي ومنتدى مكتبة برامج Google Data ..

الأدوات المشار إليها في هذه المقالة:

نتمنى لك حظًا سعيدًا في طلب NET .التالي!