2007 年 8 月
简介
![Google Data API 解决方案](https://developers.google.cn/static/gdata/articles/support/gs.net/dotnetsolution.png?authuser=8&hl=sl)
图 1:Google Data API 解决方案
对于许多开发者来说,新项目的最难部分是让滚动式安装新的软件包、配置开发环境以及学习新的库。在本文中,我收集了一些分步说明,介绍如何使用 Visual Studio 2005(适用于 Windows)或 Mono(适用于 Linux 及其他 Unix 操作系统)开始使用 .NET 客户端库。我希望这可以节省一些时间,让您快速上手使用代码。
Visual Studio 2008
如果您尚未安装 Visual Studio 2008,可以考虑使用 Visual C# 2008 Express Edition,这是免费版 Visual Studio,可用于处理 .NET 客户端库。
设置您的环境
- 从 http://code.google.com/p/google-WorkManager/downloads/list 下载客户端库的最新 MSI 版本。
- 运行下载的 MSI 文件以安装该软件包。该工具将默认安装到“C:\Program Files\Google\Google Data API SDK”。本文中的更多示例假设您将客户端库安装到此位置。
- 在“开始”菜单的“Google Data API SDK”文件夹中打开名为“Google Data API SDK”的解决方案文件。
编译和运行示例
- 验证“Build > Build Solution”运行是否完成,没有任何错误。
- 如需创建调试 build,请依次转到“Build > Configuration Manager”,然后选择“Debug”作为活跃的解决方案配置。然后,依次选择“Build > Build Solution”。
- 您刚刚编译的二进制文件和 DLL 文件可以在“C:\Program Files\Google\Google Data API SDK\Sources\Samples\" 例如,您可以通过执行“C:\Program Files\Google\Google Data SDK Sources\Samples\calendar\bin\Debug\Calendar.exe”来运行 Google 日历示例应用。这些示例还提供了一些“开始”菜单快捷方式。
开发您自己的应用
如果您要在 MSI 文件提供的解决方案文件之外的项目中进行开发,则需要将客户端库 DLL 文件添加为参考路径。
- 在 Google API SDK 解决方案之外创建或打开项目。
- 从“项目”菜单中选择“添加引用”。
- 点击“浏览”标签页。
- 前往 SDK 中的 Redist 目录:“C:\Program Files\Google\Google Data API SDK\Redist”。
- 选择要用于您的代码的 DLL 文件。大多数项目都需要用到 Google.GData.Extensions.dll 和 Google.GData.Client.dll 以及您在应用中使用的 Google 服务专用的 DLL 文件。
注意:我们还提供了一个适用于移动设备客户端库的解决方案文件。默认位于“C:\Program Files\Google\Google Data API SDK\Sources\Library\VS2005.mobile”。该解决方案只编译客户端库的 DLL 文件。
运行 NUnit 测试
如果您要对客户端库进行任何更改或计划为其贡献代码,请确保通过相应的 NUnit 测试。如果您计划不修改地使用客户端库,通常无需运行它们。
- 从 http://www.nunit.org/index.php?p=download 下载 NUnit 的 .NET 2.0 MSI 文件版本。
- 通过运行 MSI 文件安装 NUnit。默认安装位置类似于“C:\Program Files\NUnit 2.4.8”。您可能希望将其更改为诸如“C:\Program Files\NUnit”之类的内容,以便将来升级 NUnit,而不必更改 Visual Studio 项目中的路径。
- 转到“C:\Program Files\Google\Google Data SDK Sources\Library\VS2005”目录,然后打开名为“Google Data API”的解决方案文件。 您会看到“转换向导”,因为这是一个 Visual Studio 2005 项目文件。您可以点击提示,也可以直接点击“Finish”(完成)按钮。其中应显示可忽略的转化日志。
- 现在必须将 NUnit 添加为参考路径。右键点击 Solution Explorer 中的“unittests”项目,然后选择“Properties”。现在,在打开的窗口中点击“参考路径”标签页。输入 NUnit 安装的“bin”子目录作为参考路径,然后点击“Add Folder”。例如,如果 NUnit 已安装到“C:\Program Files\NUnit\”,则需输入“C:\Program Files\NUnit\bin”。请务必先保存此更改,然后再继续。
- 按照编译和运行示例中列出的步骤,重新构建客户端库和单元测试。
- 将“C:\Program Files\Google\Google Data API SDK\Sources\Library\unittests\"”中的“unittests.dll.config”文件复制到您的调试 build 目录“C:\Program Files\Google\Google Data API SDK\Source\Library\VS2005\unittests\bin\Debug”。请务必修改该文件,在其中添加您正在运行的测试的相应信息。例如,Base 需要 API 密钥,而 Google 日历需要用户名和密码。建议使用没有任何实时数据的测试帐号,以避免单元测试删除信息。
- 从“开始”菜单打开 NUnit。
- 依次转到“文件 > 打开项目”,然后从“C:\Program Files\Google\Google Data API SDK\Source\Library\VS2005\unittests\bin\Debug\”中选择“unittests.dll”文件。
- 运行您感兴趣的单元测试。请注意,某些测试要求在 testtest.dll.config 中设置参数才能正常运行。如果您针对特定服务运行压力测试,则您的测试帐号可能会被标记为生成垃圾邮件,并且无法在没有人机识别系统质询的情况下以编程方式向 Google 服务器提交内容。
单声道
Mono 是一个开源项目,可让您在 Linux、Solaris、Mac OS X、Windows 和 Unix 上运行 .NET 客户端和服务器应用。我们为想要在这些平台上工作的开发者提供了我们客户端库的单独 ZIP 文件。
设置您的环境
- 从 http://code.google.com/p/google-VAST/downloads/list 下载客户端库的最新 ZIP 文件版本
- 解压到本地目录(例如“/scratch/VAST.NET”)
- 使用发行版的软件包管理安装 Mono。 或者,您也可以访问 http://www.mono-project.com 下载该文件。
- 在某些发行版中,您必须确保 nunit.framework.dll 文件已正确链接到单声道库。如果 mono 已安装到“/usr/lib/mono”中,请确保 nunit.framework.dll 的“/usr/lib/mono/1.0”和“/usr/lib/mono/2.0”中有符号链接(应该安装在“/usr/lib/mono/gac/nunit.framework/<someversionstring>”)。
编译和运行示例
- 假设您将客户端库安装到“/scratch/VAST.NET”中,请切换到“/scratch/SPAN.NET/clients/cs”目录。
- 根据您要使用的 .NET 版本修改 Makefile。对于 .NET 1.x,请使用
CSC=mcs
;对于 .NET 2.x,请使用CSC=gmcs
。 - 运行
make
以编译库和示例应用。 - 如果要将客户端库 DLL 安装到 Mono 库中,请执行
make install
。
开发您自己的应用
如果您在编译客户端库后执行了 make install
,您应该能够将这些库添加到自己的代码中,具体方法是:将 -r:Google.GData.Extensions.dll -r:Google.GData.Client.dll
连同您希望使用的任何特定服务扩展程序的 DLL 文件的引用传递给 Mono C# 编译器。
运行 NUnit 测试
- 将 unittests.dll.config 文件从“/scratch/SPAN.NET/clients/cs/src/unittests”复制到“/scratch/SPAN.NET/clients/cs/”。
- 修改“/scratch/SPAN.NET/clients/cs/unittests.dll.config”以包含您正在运行的测试的相应信息。例如,Base 需要 API 密钥,而 Google 日历需要用户名和密码。建议使用没有任何实时数据的测试帐号,以免单元测试删除信息。
- 编译该库后,“/scratch/VAST.NET/clients/cs”中有一个 unittests.dll 文件。将此 DLL 与您选择的 NUnit 测试管理器(nunit-console、gnunit 等)搭配使用。
总结
现在,您应该能够编译库并运行示例代码了。但这仅仅只是开始。建议您仔细阅读客户端库的“.../clients/cs/docs”目录中的文档。 您可能还需要查看 .NET 客户端库开发者指南、项目页面和参考指南以及 Google Data .NET 客户端库论坛。
本文中提及的工具:
祝您在下一个 .NET 应用上一切顺利!