Apworks框架实战（二）：开始使用

要使用Apworks进行应用程序开发，您需要安装Visual Studio 2012以上的版本（以下简称Visual Studio 2012+），从Apworks 2.5开始，需要Micrsoft.NET Framework 4.5的支持，因此强烈建议使用Visual Studio 2012+进行开发。

获取源代码

要获得最新版本的代码，请使用下面的命令获取：

git clone https://github.com/daxnet/Apworks

您也可以直接打开Apworks的首页以在线浏览源代码，或者获取Apworks的最新信息。Apworks的首页地址为：http://www.github.com/daxnet/Apworks。

注意：对于2.5.4563.21309之前的版本，可以到http://apworks.codeplex.com下载对应版本的源代码，但这部分代码已经过时，因此不建议使用。

从源代码编译

开发人员可以在下载完最新版本的代码后，直接使用Visual Studio 2012+打开解决方案文件Apworks.sln，然后使用Visual Studio进行编译，也可以使用代码库中自带的编译命令，从命令行进行编译。

使用Visual Studio 2012+编译源代码

在使用Visual Studio编译Apworks的源代码之前，请先确保Visual Studio已经安装了NuGet Package Manager，并在选项窗口中打开了Package Restore的选项。这是因为，为了减小代码库的大小，在提交Apworks代码的时候，并没有将其所需的第三方程序集全部签入到代码库中，而是借用了NuGet Package Manager的Package Restore功能。使用NuGet来管理Apworks的程序集引用的另一个好处是，使得今后Apworks类库包的发布变得非常简单。

因此，请确保下图所示的选项已经打开：

使用Visual Studio打开Apworks.sln解决方案文件后，可立即编译，此时IDE会分析各个项目与程序集之间的依赖关系，并根据这些分析结果从NuGet Package站点上下载丢失的第三方程序集，然后对项目进行编译。

由于整个Apworks框架并没有牵涉到32位/64位的PInvoke问题，因此不存在不同CPU架构之分，所有的编译都是基于Any CPU的架构。

从配置管理器中我们可以看到，目前整个Apworks框架的编译支持以下几种配置：

• CoreDebug：以Debug方式仅编译Apworks框架的核心库，不编译单体测试项目，编译结果将输出到bin\Debug文件夹下。通常用这种方式产生可供调试的Apworks程序集
• CoreRelease：以Release方式仅编译Apworks框架的核心库，不编译单体测试项目，编译结果将输出到bin\Release文件夹下。通常用这种方式产生Apworks程序集的最终版本
• Debug：以Debug方式编译所有项目，需要进行单体测试时，就应该以此配置进行编译。编译结果将输出到每个项目各自的bin\Debug文件夹下
• MonoDebug：供Mono开发环境使用的Debug编译配置，可以在MonoDevelop或者xbuild中使用，编译结果将输出到bin\Debug文件夹下
• MonoRelease：供Mono开发环境使用的Release编译配置，可以在MonoDevelop或者xbuild中使用，编译结果将输出到bin\Release文件夹下
• Release：以Release方式编译所有项目。编译结果将输出到每个项目各自的bin\Release文件夹下

注意：仅有Release的相关配置才会产生XML文档文件，Debug相关的配置不会产生XML文档文件。

从命令行编译源代码

在Windows系统中，打开Visual Studio的命令行工具。对于Visual Studio 2013，需要在“开始”菜单中找到Visual Studio 2013下Visual Studio Tools文件夹，然后在打开的文件夹中执行Developer Command Prompt for VS2013快捷方式：

在命令提示符中，进入Apworks代码库的主目录，然后执行build.bat来编译源代码：

• 要以Debug配置对源代码编译，请执行以下命令，编译结果会输出到bin\Debug文件夹：build.bat Debug
• 要以Release配置对源代码编译，请执行以下命令，编译结果会输出到bin\Release文件夹：build.bat Release

注意：由于Linux下NuGet Package Manager使用比较困难，因此这些第三方程序集都被打包成tar或者gz包并保存在文件服务器上。在Linux下使用build.sh来编译源代码时，build.sh会首先到文件服务器上下载并解压缩这些第三方程序集，然后对源代码进行编译。但由于近期文件服务器不可用，因此暂时还无法直接在Linux下对源代码进行直接编译。

在Visual Studio中使用Apworks程序集

Apworks通过NuGet Package Manager发布，因此，要在Visual Studio 2012+中使用Apworks，首先应当确保Visual Studio中已经安装了NuGet扩展。在需要使用Apworks程序集的项目上，单击鼠标右键，选择Manage NuGet Packages选项：

此时会弹出Manage NuGet Packages对话框：

在对话框的“搜索”文本框中，输入“Apworks”，此时，对话框中将列出所有与Apworks相关的Packages：

选中需要安装的Apworks组件，然后单击Install按钮将组件及其依赖组件安装到项目中。

Apworks框架通过NuGet Package Repository向开发人员提供以下组件：

• Apworks：Apworks框架的核心组件。所有Apworks相关的其它组件都依赖于该组件
• Apworks Entity Framework Repository：基于Microsoft ADO.NET Entity Framework实现的仓储组件
• Apworks MongoDB Repository：基于MongoDB的仓储组件
• Apworks NHibernate Repository：基于NHibernate实现的仓储组件
• Apworks Unity Object Container：基于Microsoft Patterns & Practices Unity实现的IoC容器组件
• Apworks General Storage：基于SQL Server或者OleDB实现的数据访问组件
• Apworks MySQL Storage：基于MySQL实现的数据访问组件
• Apworks MSMQ Bus：基于MSMQ实现的消息总线组件
• Apworks Event Aggregator Bus：基于事件聚合器的消息总线组件
• Apworks Direct Bus Implementation：一个简单的消息总线的实现，发送到总线上的消息会立刻派发给已注册的消息处理器，仅供实验和学习使用。该组件将在后续版本中淘汰
• Apworks General Event Storage：基于SQL Server或者OleDB实现的事件存储（Event Store）组件（将用于CQRS架构）
• Apworks MySQL Event Storage：基于MySQL的事件存储组件（将用于CQRS架构）

在向项目添加了所需的Apworks组件后，会在解决方案目录下的packages目录中产生如下目录结构，Apworks相关的程序集会被下载到这些目录中：

在下一篇文章中，我将介绍Apworks框架对测试驱动开发和持续集成，以及对各种现有流行框架的支持。