สิงหาคม 2007
- บทนำ
- Visual Studio 2008
- การตั้งค่าสภาพแวดล้อม
- การรวบรวมและการเรียกใช้ตัวอย่าง
- การพัฒนาแอปพลิเคชันของคุณเอง
- การเรียกใช้การทดสอบ NUnit
- โมโน
- การตั้งค่าสภาพแวดล้อม
- การรวบรวมและการเรียกใช้ตัวอย่าง
- การพัฒนาแอปพลิเคชันของคุณเอง
- การเรียกใช้การทดสอบ NUnit
- สรุป
บทนำ
![โซลูชัน Google Data API](https://google-developers.gonglchuangl.net/static/gdata/articles/support/gs.net/dotnetsolution.png?authuser=0&hl=th)
รูปที่ 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 ได้
กําลังตั้งค่าสภาพแวดล้อม
- ดาวน์โหลด MSI ไลบรารีไลบรารีล่าสุดที่ http://code.google.com/p/google-gdata/downloads/list
- เรียกใช้ไฟล์ MSI ที่ดาวน์โหลดมาเพื่อติดตั้งแพ็กเกจ ซึ่งจะติดตั้งลงใน "C:\Program Files\Google\Google Data API SDK\" โดยค่าเริ่มต้น ตัวอย่างเพิ่มเติมในบทความนี้จะถือว่าคุณติดตั้งไลบรารีของไคลเอ็นต์ไปยังตําแหน่งนี้
- เปิดไฟล์โซลูชันชื่อ "Google Data API SDK" ในโฟลเดอร์ "SDK ของ Google Data API" ในเมนูเริ่มต้น
การรวบรวมและเรียกใช้ตัวอย่าง
- ยืนยันว่าการเรียกใช้ "สร้าง > สร้างโซลูชัน" เสร็จสมบูรณ์โดยไม่มีข้อผิดพลาด
- หากต้องการสร้างบิลด์การแก้ไขข้อบกพร่อง ให้ไปที่ "บิลด์ > เครื่องมือจัดการการกําหนดค่า" แล้วเลือก "แก้ไขข้อบกพร่อง" เป็นการกําหนดค่าโซลูชันที่ใช้งานอยู่ แล้วเลือก "สร้าง > สร้างโซลูชัน"
- ไฟล์ไบนารีและไฟล์ 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 ของไลบรารีของไคลเอ็นต์เป็นเส้นทางอ้างอิง
- สร้างหรือเปิดโปรเจ็กต์นอกโซลูชัน SDK API ของ Google
- เลือก "เพิ่มข้อมูลอ้างอิง" จากเมนูโปรเจ็กต์
- คลิกแท็บ "เรียกดู"
- ไปที่ไดเรกทอรี Redist ใน SDK: "C:\Program Files\Google\Google Data API SDK\Redist"
- เลือกไฟล์ 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 ที่เกี่ยวข้องเป็นขั้นตอนสําคัญหากคุณทําการเปลี่ยนแปลงไลบรารีของไคลเอ็นต์หรือวางแผนที่จะมีส่วนร่วม หากคุณวางแผนที่จะใช้ไลบรารีของไคลเอ็นต์โดยไม่มีการแก้ไข โดยปกติไม่จําเป็นต้องเรียกใช้ไลบรารีเหล่านั้น
- ดาวน์โหลด NUnit เวอร์ชัน .NET 2.0 MSI จาก http://www.nunit.org/index.php?p=download
- ติดตั้ง NUnit โดยใช้ไฟล์ MSI ตําแหน่งการติดตั้งเริ่มต้นจะคล้ายกับ "C:\Program Files\NUnit 2.4.8" คุณอาจต้องการเปลี่ยนแปลงสิ่งนี้ เช่น "C:\Program Files\NUnit" เพื่อให้สามารถอัปเกรด NUnit ในอนาคตได้โดยไม่ต้องเปลี่ยนเส้นทางในโปรเจ็กต์ Visual Studio
- ไปที่ไดเรกทอรี "C:\Program Files\Google\Google Data API SDK\Sources\Library\VS2005" แล้วเปิดไฟล์โซลูชันชื่อ "Google Data API" คุณจะเห็นวิซาร์ด Conversion เนื่องจากเป็นไฟล์โปรเจ็กต์ Visual Studio 2005 คลิกผ่านข้อความแจ้งหรือเพียงคลิกปุ่ม "เสร็จสิ้น" ไฟล์ควรแสดงบันทึก Conversion ซึ่งระบบไม่สนใจได้
- ต้องเพิ่ม NUnit เป็นเส้นทางอ้างอิงแล้ว คลิกขวาที่โปรเจ็กต์ "unittests" ในโปรแกรมสํารวจโซลูชันทางด้านขวา แล้วเลือก "Properties" จากนั้น ให้คลิกแท็บ "เส้นทางการอ้างอิง" ภายในหน้าต่างที่เปิดขึ้นมา ป้อนตําแหน่งของไดเรกทอรีย่อย "bin" ของการติดตั้ง NUnit เป็นเส้นทางอ้างอิง แล้วคลิก "Add Folder" เช่น หากติดตั้ง NUnit ลงใน "C:\Program Files\NUnit\" รายการหนึ่งจะป้อน "C:\Program Files\NUnit\bin" โปรดบันทึกการเปลี่ยนแปลงนี้ก่อนดําเนินการต่อ
- ทําตามขั้นตอนที่ระบุไว้ในการรวบรวมและการเรียกใช้ตัวอย่างเพื่อสร้างไลบรารีของไคลเอ็นต์และการทดสอบหน่วยอีกครั้ง
- คัดลอกไฟล์ "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 ในขณะที่ปฏิทินกําหนดให้ป้อนชื่อผู้ใช้และรหัสผ่าน เราขอแนะนําให้ใช้บัญชีทดสอบโดยไม่มีข้อมูลที่เผยแพร่อยู่เพื่อหลีกเลี่ยงข้อมูลที่การทดสอบในหน่วยลบ
- เปิด NUnit จากเมนูเริ่มต้น
- ไปที่ "ไฟล์ > เปิดโปรเจ็กต์" และเลือกไฟล์ "unittests.dll" จาก "C:\Program Files\Google\Google Data API SDK\Source\Library\VS2005\unittests\bin\Debug\"
- ทําการทดสอบหน่วยที่สนใจ อย่าลืมว่าการทดสอบบางอย่างต้องมีการตั้งค่าพารามิเตอร์ในunittests.dll.config จึงจะทํางานได้ หากคุณทําการทดสอบความเครียดสําหรับบางบริการ ระบบอาจทําเครื่องหมายบัญชีทดสอบของคุณว่าเป็นการสร้างสแปมและส่งเนื้อหาไปยังเซิร์ฟเวอร์ของ Google แบบเป็นโปรแกรมไม่ได้หากไม่พบปัญหา CAPTCHA
โมโน
โมโนเป็นโปรเจ็กต์โอเพนซอร์สที่ให้คุณเรียกใช้แอปพลิเคชันไคลเอ็นต์และเซิร์ฟเวอร์ .NET ใน Linux, Solaris, Mac OS X, Windows และ Unix ได้ เรามีไฟล์ ZIP แยกต่างหากสําหรับไลบรารีของไคลเอ็นต์สําหรับนักพัฒนาซอฟต์แวร์ที่ต้องการทํางานบนแพลตฟอร์มใดแพลตฟอร์มหนึ่งเหล่านี้
กําลังตั้งค่าสภาพแวดล้อม
- ดาวน์โหลดไฟล์ ZIP ล่าสุดของไลบรารีของไคลเอ็นต์จาก http://code.google.com/p/google-gdata/downloads/list
- แตกข้อมูลไปยังไดเรกทอรีภายใน (เช่น "/scratch/gdata.NET")
- ใช้การจัดการแพ็กเกจของผู้จัดจําหน่ายเพื่อติดตั้ง Mono หรือจะดาวน์โหลดจาก http://www.mono-project.com ก็ได้
- ในบางการเผยแพร่ คุณต้องตรวจสอบว่าไฟล์ 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)
การรวบรวมและเรียกใช้ตัวอย่าง
- สมมติว่าคุณติดตั้งไลบรารีของไคลเอ็นต์เป็น "/scratch/gdata.NET" โปรดเปลี่ยนเป็นไดเรกทอรี "/scratch/gdata.NET/clients/cs"
- ให้แก้ไข Makefile โดยขึ้นอยู่กับเวอร์ชัน .NET ที่ต้องการใช้ สําหรับ .NET 1.x ให้ใช้
CSC=mcs
และสําหรับ .NET 2.x ให้ใช้CSC=gmcs
- เรียกใช้
make
เพื่อรวบรวมไลบรารีและแอปพลิเคชันตัวอย่าง - เรียกใช้
make install
หากคุณต้องการติดตั้ง DLL ของไลบรารีของไคลเอ็นต์ลงในไลบรารี Mono
การพัฒนาแอปพลิเคชันของคุณเอง
หากคุณเรียกใช้ make install
หลังจากรวบรวมไลบรารีของไคลเอ็นต์ คุณควรจะรวมไลบรารีในโค้ดของคุณเองได้โดยการส่ง -r:Google.GData.Extensions.dll -r:Google.GData.Client.dll
ไปยังคอมไพเลอร์ Mono C# พร้อมกับการอ้างอิงไปยังไฟล์ DLL ของส่วนขยายบริการใดๆ ที่คุณต้องการใช้
การทดสอบ NUnit
- คัดลอกไฟล์ Unittests.dll.config จาก "/scratch/gdata.NET/clients/cs/src/unittests" ไปยัง "/scratch/gdata.NET/clients/cs/"
- แก้ไข "/scratch/gdata.NET/clients/cs/unittests.dll.config" เพื่อรวมข้อมูลที่เหมาะสมสําหรับการทดสอบที่คุณดําเนินการ เช่น Base ต้องใช้คีย์ API ในขณะที่ปฏิทินกําหนดให้ป้อนชื่อผู้ใช้และรหัสผ่าน เราขอแนะนําให้ใช้บัญชีทดสอบโดยไม่มีข้อมูลที่เผยแพร่อยู่เพื่อหลีกเลี่ยงข้อมูลที่การทดสอบในหน่วยลบ
- หลังจากรวบรวมไลบรารีแล้ว จะมีไฟล์unittests.dll ใน "/scratch/gdata.NET/clients/cs" ใช้ DLL นี้กับตัวจัดการการทดสอบของ NUnit ที่ต้องการ (nunit-console, gnunit ฯลฯ)
บทสรุป
ตอนนี้คุณควรจะรวบรวมไลบรารีและเรียกใช้โค้ดตัวอย่างได้แล้ว แต่นี่เป็นเพียงจุดเริ่มต้น เราขอแนะนําให้คุณอ่านเอกสารที่มีในไดเรกทอรี ".../clients/cs/docs" ของไลบรารีของไคลเอ็นต์ นอกจากนี้ คุณอาจไปที่คู่มือสําหรับนักพัฒนาซอฟต์แวร์เกี่ยวกับไลบรารีของไคลเอ็นต์ .NET หน้าโปรเจ็กต์ และคู่มืออ้างอิง และฟอรัมไลบรารีของไคลเอ็นต์ Google .NET
เครื่องมือที่กล่าวถึงในบทความนี้
ขอให้โชคดีกับการสมัคร .NET ครั้งถัดไป