Bắt đầu sử dụng Thư viện ứng dụng .NET

Jeff Fisher, nhóm Google Data API
Tháng 8 năm 2007

Giới thiệu

Giải pháp Google Data API
Hình 1: Giải pháp Google Data API

Đối với nhiều nhà phát triển, phần khó khăn nhất của dự án mới là họ bắt đầu cài đặt gói phần mềm mới, định cấu hình môi trường phát triển và tìm hiểu các thư viện mới. Trong bài viết này, tôi đã tập hợp một số hướng dẫn từng bước về cách bắt đầu với thư viện ứng dụng .NET bằng cách sử dụng Visual Studio 2005 cho Windows hoặc Mono cho Linux và các hệ điều hành Unix khác. Tôi hy vọng việc này sẽ giúp bạn tiết kiệm thời gian để bắt đầu và cho phép bạn nhanh chóng bắt đầu làm việc với một số mã.

Visual Studio 2008

Nếu chưa cài đặt Visual Studio 2008, bạn có thể cân nhắc sử dụng Visual C# 2008 Express Edition, phiên bản miễn phí của Visual Studio cho phép bạn làm việc với thư viện ứng dụng .NET.

Thiết lập môi trường

  1. Tải xuống bản phát hành MSI mới nhất của thư viện ứng dụng từ http://code.google.com/p/google-gdata/downloads/list.
  2. Chạy tệp MSI đã tải xuống để cài đặt gói. Ứng dụng sẽ cài đặt vào "C:\Program Files\Google\Google Data API SDK\" theo mặc định. Các ví dụ khác trong bài viết này giả định rằng bạn đã cài đặt thư viện ứng dụng vào vị trí này.
  3. Mở tệp giải pháp có tên "Google Data API SDK" trong thư mục "Google Data API SDK" trong trình đơn Start (Bắt đầu).

Biên dịch và chạy mẫu

  1. Xác minh rằng việc chạy "Build (Xây dựng) > Build Solution (Giải pháp xây dựng)" đã hoàn tất mà không có lỗi nào.
  2. Để tạo một bản gỡ lỗi, hãy chuyển đến "Build (Xây dựng) > Configuration Manager (Trình quản lý cấu hình)" rồi chọn "Debug" (Gỡ lỗi) làm cấu hình giải pháp đang hoạt động. Sau đó, chọn "Build (Xây dựng) > Build Solution (Giải pháp xây dựng)".
  3. Bạn có thể tìm thấy các tệp nhị phân và tệp DLL bạn vừa biên dịch trong mục "C:\Program Files\Google\Google Data API\Sources\Samples\" Ví dụ: bạn có thể chạy ứng dụng mẫu cho Lịch bằng cách thực thi "C:\Program Files\Google\Google Data API SDK\Sources\Samples\calendar\bin\Debug\Calendar.exe". Ngoài ra, còn có một số phím tắt của Trình đơn khởi động cho các mẫu này.

Phát triển ứng dụng của riêng bạn

Nếu muốn phát triển một dự án bên ngoài tệp giải pháp do tệp MSI cung cấp, bạn cần thêm các tệp DLL của thư viện ứng dụng làm đường dẫn tham chiếu.

  1. Tạo hoặc mở một dự án bên ngoài giải pháp SDK của Google API.
  2. Chọn "Add Tham khảo" từ trình đơn Project (Dự án).
  3. Nhấp vào thẻ Duyệt qua.
  4. Chuyển đến thư mục Redist trong SDK: "C:\Program Files\Google\Google Data API SDK\Redist".
  5. Chọn các tệp DLL mà mã của bạn sẽ sử dụng. Google.GData.Extensions.dll và Google.GData.Client.dll sẽ cần thiết cho hầu hết các dự án, cùng với tệp DLL cụ thể cho(các) dịch vụ của Google mà bạn đang sử dụng trong đơn đăng ký.

Lưu ý: Ngoài ra, còn có tệp giải pháp cho các thư viện ứng dụng trên thiết bị di động. Theo mặc định, chương trình này nằm trong phần "C:\Program Files\Google\Google Data API SDK\Sources\Library\VS2005.mobile". Giải pháp này sẽ chỉ biên dịch tệp DLL cho các thư viện ứng dụng.

Chạy kiểm thử NUnit

Đảm bảo các bài kiểm thử NUnit phù hợp là một bước quan trọng nếu bạn thay đổi thư viện ứng dụng hoặc dự định đóng góp cho thư viện ứng dụng. Nếu bạn có kế hoạch sử dụng các thư viện ứng dụng mà không cần sửa đổi, thì thông thường bạn không cần phải chạy các thư viện đó.

  1. Tải bản phát hành tệp MSI .NET 2.0 của NUnit từ http://www.nunit.org/index.php?p=download.
  2. Cài đặt NUnit bằng cách chạy tệp MSI. Vị trí cài đặt mặc định tương tự như "C:\Program Files\NUnit 2.4.8". Bạn nên thay đổi mã này thành tên như "C:\Program Files\NUnit" để có thể nâng cấp NUnit trong tương lai mà không phải thay đổi đường dẫn trong dự án Visual Studio.
  3. Chuyển đến thư mục "C:\Program Files\Google\Google Data API SDK\Sources\Library\VS2005" và mở tệp giải pháp có tên "Google Data API". Bạn sẽ thấy Trình hướng dẫn chuyển đổi vì đây là tệp dự án Visual Studio 2005. Nhấp vào lời nhắc hoặc chỉ cần nhấp vào nút "Hoàn tất". Nó sẽ hiển thị nhật ký chuyển đổi, có thể bỏ qua.
  4. Bây giờ, NUnit phải được thêm làm đường dẫn tham chiếu. Nhấp chuột phải vào dự án "unittests" trong Trình khám phá giải pháp ở bên phải rồi chọn "Properties" (Thuộc tính). Bây giờ, hãy nhấp vào thẻ "Reference path" (Đường dẫn tham chiếu) trong cửa sổ mở ra. Nhập vị trí của thư mục con "bin" của quá trình cài đặt NUnit làm đường dẫn tham chiếu và nhấp vào "Thêm thư mục". Ví dụ: nếu NUnit được cài đặt vào "C:\Program Files\NUnit\", thì hệ thống sẽ nhập "C:\Program Files\NUnit\bin". Hãy nhớ lưu thay đổi này trước khi tiếp tục.
  5. Làm theo các bước được liệt kê trong phần Biên dịch và chạy mẫu để xây dựng lại thư viện ứng dụng và các kiểm thử đơn vị.
  6. Sao chép tệp "unittests.dll.config" trong "C:\Program Files\Google\Google Data API\SDK\Sources\Library\unittests\" vào thư mục bản dựng gỡ lỗi "C:\Program Files\Google\Google Data API SDK\Source\Library\VS2005\unittests\bin\Debug\". Hãy nhớ chỉnh sửa tệp để đưa vào thông tin thích hợp cho chương trình kiểm thử mà bạn đang chạy. Ví dụ: Base yêu cầu khoá API và Lịch yêu cầu tên người dùng và mật khẩu. Bạn nên sử dụng tài khoản thử nghiệm không có bất kỳ dữ liệu trực tiếp nào để tránh bị xoá bằng các kiểm thử đơn vị.
  7. Mở NUnit từ trình đơn Start (Bắt đầu).
  8. Chuyển đến "File > Open Project" (Tệp > Mở dự án) rồi chọn tệp "unittests.dll" trong phần "C:\Program Files\Google\Google Data API SDK\Source\Library\VS2005\unittests\bin\Debug\".
  9. Chạy kiểm thử đơn vị mà bạn quan tâm. Hãy nhớ rằng một số thử nghiệm yêu cầu các tham số phải được đặt trong unittests.dll.config để hoạt động. Nếu bạn chạy kiểm tra căng thẳng cho một số dịch vụ nhất định, tài khoản thử nghiệm của bạn có thể bị gắn cờ là tạo spam và không thể gửi nội dung theo cách lập trình đến máy chủ của Google mà không gặp CAPTCHA.

Mono

Mono là dự án nguồn mở cho phép bạn chạy các ứng dụng và máy chủ .NET trên Linux, Solaris, Mac OS X, Windows và Unix. Chúng tôi cung cấp một tệp ZIP riêng của thư viện ứng dụng dành cho các nhà phát triển muốn làm việc trên một trong những nền tảng này.

Thiết lập môi trường

  1. Tải xuống bản phát hành tệp ZIP mới nhất của thư viện ứng dụng từ http://code.google.com/p/google-gdata/downloads/list
  2. Trích xuất vào một thư mục cục bộ (ví dụ: "/scratch/gdata.NET")
  3. Sử dụng tính năng quản lý gói phân phối của bạn để cài đặt Mono. Ngoài ra, bạn có thể tải xuống từ http://www.mono-project.com.
  4. Trong một số bản phân phối, bạn phải đảm bảo rằng tệp nunit.framework.dll được liên kết đúng cách vào thư viện đơn âm. Nếu đơn âm được cài đặt thành "/usr/lib/mono", hãy đảm bảo rằng có các đường liên kết tượng trưng trong "/usr/lib/mono/1.0" và "/usr/lib/mono/2.0" đối với nunit.framework.dll (phải được cài đặt trong "/usr/lib/mono/gac/nunit.framework/<someversionstring>/nunit.framework.dll").

Biên dịch và chạy mẫu

  1. Giả sử bạn đã cài đặt thư viện ứng dụng vào "/scratch/gdata.NET", hãy đổi sang thư mục "/scratch/gdata.NET/clients/cs".
  2. Chỉnh sửa Makefile tuỳ thuộc vào phiên bản .NET mà bạn muốn sử dụng. Đối với .NET 1.x, hãy sử dụng CSC=mcs, còn đối với .NET 2.x, hãy dùng CSC=gmcs.
  3. Chạy make để biên dịch các thư viện và ứng dụng mẫu.
  4. Thực thi make install nếu bạn muốn cài đặt các DLL của thư viện ứng dụng vào thư viện Mono.

Phát triển ứng dụng của riêng bạn

Nếu đã thực thi một make install sau khi biên dịch thư viện ứng dụng, bạn có thể đưa các thư viện vào mã của riêng mình bằng cách truyền -r:Google.GData.Extensions.dll -r:Google.GData.Client.dll đến trình biên dịch C# đơn lẻ cùng với thông tin tham chiếu đến các tệp DLL của bất kỳ tiện ích dịch vụ cụ thể nào mà bạn muốn sử dụng.

Chạy kiểm thử NUnit

  1. Sao chép tệp unittests.dll.config từ "/scratch/gdata.NET/clients/cs/src/unittests" vào "/scratch/gdata.NET/clients/cs/".
  2. Chỉnh sửa "/scratch/gdata.NET/clients/cs/unittests.dll.config" để bao gồm thông tin thích hợp cho các chương trình kiểm thử mà bạn đang chạy. Ví dụ: Base yêu cầu khoá API và Lịch yêu cầu tên người dùng và mật khẩu. Tôi khuyên bạn nên sử dụng tài khoản thử nghiệm không có dữ liệu trực tiếp để tránh bị xóa bởi các thử nghiệm đơn vị.
  3. Sau khi biên dịch thư viện, sẽ có tệp unittests.dll trong "/scratch/gdata.NET/clients/cs". Sử dụng DLL này với người quản lý kiểm thử NUnit bạn đã chọn (nunit-console, gnunit, v.v.).

Kết luận

Giờ thì bạn đã có thể biên dịch các thư viện và chạy mã mẫu. Tuy nhiên, đây mới chỉ là bước khởi đầu. Bạn nên đọc tài liệu trong thư mục ".../clients/cs/docs" của thư viện ứng dụng. Ngoài ra, bạn cũng nên tham khảo Hướng dẫn dành cho nhà phát triển Thư viện .NET, trang dự án và hướng dẫn tham khảo cũng như diễn đàn thư viện ứng dụng .NET của Google.

Các công cụ được tham chiếu trong bài viết này:

Chúc bạn may mắn với ứng dụng .NET tiếp theo!