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框架对测试驱动开发和持续集成,以及对各种现有流行框架的支持。
相关文章
- Python爬虫之简单爬虫框架实现
- C# 游戏服务器框架
- ASP.NET Core微服务框架Ocelot+Consul+IdentityServer4实战演练
- .NET开源分布式日志框架ExceptionLess实战演练(公开版)
- 【全景图】框架全景图
- UIKit 框架之UIView一
- 110、Android 下拉刷新框架实现(转载)
- vue框架-基础2-vue生命周期
- python-django框架-电商项目-用户模块开发_20191117
- Google官方网络框架Volley实战——QQ吉凶测试,南无阿弥陀佛!
- go gin框架:PostFormArray接收数组类请求参数
- Apache Shiro权限控制框架简介
- 【GUI视频教程】GUI综合实战视频教程第2期:RTOS框架设计,优先级分配以ThreadX GUIX和emWin6.x上手操作(2022-10-16)
- SAP OData 框架处理 Metadata 元数据请求的实现细节,前后端组件部署在同一台物理服务器试读版
- 【项目实战】过滤器(Filter)入门介绍以及基于SpringBoot框架实现自定义Filter (过滤器)
- 【项目实战】并发编程之Java集合框架中的一个线程安全的队列实现 ——BlockingQueue入门介绍
- 【项目实战】限流框架介绍 - Sentinel
- 〖Python WEB 自动化测试实战篇⑫〗- 实战 - PageObject框架设计(亦叫做 “页面对象” 模式)
- 耗时1年的前端技术框架切换之旅
- 【项目实战】Python基于Django框架实现校园网上一站式购物系统
- Flutter实战之网络请求框架Dio入门使用
- RabbitMQ与Spring的框架整合之Spring AMQP实战
- 003-读书笔记-企业IT架构转型之道-阿里巴巴中台战略思想与架构实战-分布式服务框架的选择
- 接口自动化测试框架实战:邮件、断言、Excel类的封装
- 赶快收藏,Pytest框架环境切换实战教程
- MyBatis是一个支持普通SQL查询,存储过程和高级映射的优秀持久层框架
- TensorFlow:实战Google深度学习框架(二)实现简单神经网络
- 全干工程师神器 - Jmeter 10 - Jmeter持续集成介绍及轻量级接口自动化测试框架(思维导图)