การเริ่มต้นใช้งานไลบรารีของไคลเอ็นต์ .NET

Jeff Fisher, ทีม Google Data API
สิงหาคม 2007

บทนำ

โซลูชัน Google Data API
รูปที่ 1: โซลูชันของ Google Data API

สําหรับนักพัฒนาแอปจํานวนมาก ส่วนที่ยากที่สุดของโปรเจ็กต์ใหม่คือการให้ผู้ใช้ติดตั้งแพ็กเกจซอฟต์แวร์ใหม่ กําหนดค่าสภาพแวดล้อมในการพัฒนาซอฟต์แวร์ และเรียนรู้ไลบรารีใหม่ๆ ในบทความนี้ เราได้รวบรวมวิธีการแบบทีละขั้นตอนในการเริ่มต้นใช้งานไลบรารีของไคลเอ็นต์ .NET โดยใช้ Visual Studio 2005 สําหรับ Windows หรือ Mono สําหรับ Linux และระบบปฏิบัติการ Unix อื่นๆ เราหวังว่าข้อมูลนี้จะช่วยคุณประหยัดเวลาในการเริ่มต้นใช้งาน และช่วยให้คุณเริ่มต้นเขียนโค้ดได้อย่างรวดเร็ว

Visual Studio 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. เปิดไฟล์โซลูชันชื่อ "Google Data API SDK" ในโฟลเดอร์ "SDK ของ Google Data API" ในเมนูเริ่มต้น

การรวบรวมและเรียกใช้ตัวอย่าง

  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. สร้างหรือเปิดโปรเจ็กต์นอกโซลูชัน SDK API ของ Google
  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. ดาวน์โหลด NUnit เวอร์ชัน .NET 2.0 MSI จาก 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 API" คุณจะเห็นวิซาร์ด Conversion เนื่องจากเป็นไฟล์โปรเจ็กต์ Visual Studio 2005 คลิกผ่านข้อความแจ้งหรือเพียงคลิกปุ่ม "เสร็จสิ้น" ไฟล์ควรแสดงบันทึก Conversion ซึ่งระบบไม่สนใจได้
  4. ต้องเพิ่ม NUnit เป็นเส้นทางอ้างอิงแล้ว คลิกขวาที่โปรเจ็กต์ "unittests" ในโปรแกรมสํารวจโซลูชันทางด้านขวา แล้วเลือก "Properties" จากนั้น ให้คลิกแท็บ "เส้นทางการอ้างอิง" ภายในหน้าต่างที่เปิดขึ้นมา ป้อนตําแหน่งของไดเรกทอรีย่อย "bin" ของการติดตั้ง NUnit เป็นเส้นทางอ้างอิง แล้วคลิก "Add Folder" เช่น หากติดตั้ง 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 ในขณะที่ปฏิทินกําหนดให้ป้อนชื่อผู้ใช้และรหัสผ่าน เราขอแนะนําให้ใช้บัญชีทดสอบโดยไม่มีข้อมูลที่เผยแพร่อยู่เพื่อหลีกเลี่ยงข้อมูลที่การทดสอบในหน่วยลบ
  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/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/<llversionwork.dunit.dunit.dunit.frameunit/dullwork.frame)

การรวบรวมและเรียกใช้ตัวอย่าง

  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 ของไลบรารีของไคลเอ็นต์ลงในไลบรารี 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 ต้องใช้คีย์ API ในขณะที่ปฏิทินกําหนดให้ป้อนชื่อผู้ใช้และรหัสผ่าน เราขอแนะนําให้ใช้บัญชีทดสอบโดยไม่มีข้อมูลที่เผยแพร่อยู่เพื่อหลีกเลี่ยงข้อมูลที่การทดสอบในหน่วยลบ
  3. หลังจากรวบรวมไลบรารีแล้ว จะมีไฟล์unittests.dll ใน "/scratch/gdata.NET/clients/cs" ใช้ DLL นี้กับตัวจัดการการทดสอบของ NUnit ที่ต้องการ (nunit-console, gnunit ฯลฯ)

บทสรุป

ตอนนี้คุณควรจะรวบรวมไลบรารีและเรียกใช้โค้ดตัวอย่างได้แล้ว แต่นี่เป็นเพียงจุดเริ่มต้น เราขอแนะนําให้คุณอ่านเอกสารที่มีในไดเรกทอรี ".../clients/cs/docs" ของไลบรารีของไคลเอ็นต์ นอกจากนี้ คุณอาจไปที่คู่มือสําหรับนักพัฒนาซอฟต์แวร์เกี่ยวกับไลบรารีของไคลเอ็นต์ .NET หน้าโปรเจ็กต์ และคู่มืออ้างอิง และฟอรัมไลบรารีของไคลเอ็นต์ Google .NET

เครื่องมือที่กล่าวถึงในบทความนี้

ขอให้โชคดีกับการสมัคร .NET ครั้งถัดไป