תחילת העבודה עם ספריית הלקוח עם הסיומת .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/download/list.
  2. מריצים את קובץ ה-MSI שהורדתם כדי להתקין את החבילה. היא תותקן כברירת מחדל ב-"C:\Program Files\Google\Google Data API SDK\". דוגמאות נוספות במאמר זה יניחו שהתקנת את ספריית הלקוח במיקום זה.
  3. פותחים את קובץ הפתרון שנקרא "Google Data API SDK" בתיקייה "Google Data API SDK" בתפריט ההתחלה.

הידור והפעלה של דוגמאות

  1. צריך לוודא שהרצה של "Build > Build Solution" מסתיימת ללא שגיאות.
  2. כדי ליצור גרסת build לניפוי באגים, עוברים אל 'יצירה > ניהול הגדרות' ובוחרים באפשרות 'ניפוי באגים' בתור הגדרת הפתרון הפעילה. לאחר מכן בוחרים באפשרות 'Build > Build Solution'.
  3. הקבצים הבינאריים וקובצי DLL שאספת זה עתה נמצאים ב-"C:\Program Files\Google\Google Data API SDK\Sources\Samples\" לדוגמה, ניתן להפעיל את היישום לדוגמה ביומן על ידי ביצוע הפקודה "C:\Program Files\Google\Google Data SDK Source\Sources\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 עבור ספריות הלקוח.

הרצת בדיקות של היחידה הארגונית

אם תבצעו שינויים בספריות הלקוח או אם אתם מתכננים לתרום להן, חשוב לוודא שהכרטיס המיועד לבדיקות של היחידה הארגונית הוא שלב חשוב. אם אתם מתכננים להשתמש בספריות הלקוח ללא שינויים, בדרך כלל אין צורך להריץ אותן.

  1. מורידים את גרסת ה-MSI של NNET 2.0 MSI מ-http://www.nunit.org/index.php?p=download.
  2. מתקינים את היחידה הארגונית על ידי הפעלת קובץ ה-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. עכשיו יש להוסיף את יחידת המודעות כנתיב עזר. לוחצים לחיצה ימנית על הפרויקט "unittests" ב-Solution Resource Explorer בצד שמאל ובוחרים "מאפיינים". עכשיו פשוט לוחצים על הכרטיסייה 'נתיבי עזר' בחלון שנפתח. יש להזין את המיקום של ספריית המשנה "bin" של התקנת ה-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 מחייב מפתח API, וליומן Google נדרשים שם משתמש וסיסמה. מומלץ להשתמש בחשבון בדיקה ללא נתונים בזמן אמת, כדי שבדיקות היחידה לא ימחקו מידע.
  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.

מונו

מונו הוא פרויקט קוד פתוח שמאפשר לך להפעיל יישומי לקוח ושרת .NET ב-Linux , Solaris , Mac OS X , Windows ו-Unix. אנחנו מציעים קובץ ZIP נפרד בספריית הלקוחות שלנו, עבור מפתחים שרוצים לעבוד באחת מהפלטפורמות האלה.

הגדרת הסביבה שלך

  1. מורידים את הגרסה העדכנית ביותר של קובץ ה-ZIP של ספריית הלקוחות מהכתובת http://code.google.com/p/google-gdata/download/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/<someversion.

הידור והפעלה של דוגמאות

  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 אם רוצים להתקין את קובצי ה-DLL של ספריית הלקוח בספריית המונו.

פיתוח אפליקציות משלכם

אם הפעלת make install לאחר הידור של ספריית הלקוח, אתה אמור להיות מסוגל לכלול את הספריות בקוד שלך על ידי העברת ה--r:Google.GData.Extensions.dll -r:Google.GData.Client.dll למהדר C# Mono יחד עם קובצי ה-DLL של תוספי השירות הספציפיים שבהם ברצונך להשתמש.

הרצת בדיקות של היחידה הארגונית

  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, וליומן Google נדרשים שם משתמש וסיסמה. מומלץ להשתמש בחשבון בדיקה ללא נתונים חיים, כדי למנוע מצב שבו מידע יימחק מבדיקות היחידה.
  3. לאחר הידור הספרייה, יהיה קובץunittests.dll ב-"/scratch/gdata.NET/clients/cs". אפשר להשתמש ב-DLL הזה עם מנהל הבדיקה הרצוי של Nunit (מסוף-יחידה, יחידה וכו').

סיכום

עכשיו תוכלו להדר את הספריות ולהריץ את הקוד לדוגמה. עם זאת, זוהי רק ההתחלה. מומלץ לקרוא את התיעוד שנמצא בספריית ".../clients/cs/docs" בספריית הלקוח. ייתכן שתרצה גם לעיין ב.מדריך לספריית ספריית הלקוח של NET, בדף הפרויקט ובמדריך העזר, וב<br class="ph-0">מדריך <br class="ph-0-"><br class="ph-0">

הכלים המוזכרים במאמר זה:

בהצלחה בבקשת ה- .NET הבאה!