创建项目
如果您已经购买了52ABP-PRO,那么它会提高您的开发体验和工作效率。本文档的目标是准备在5分钟内创建和运行一个52ABP-PRO项目。
首先登录52ABP.COM,输入您的账号和密码。在下载页面上,选择企业版,您可以看到如下的表单内容。
选择项目类型为“ASP .NET CORE&Angular”,填写您项目名称(为了演示方便,我们使用YoyoSoft.PhoneBookDemo作为我们的项目名称)以及其他信息。
你的项目将会在一分钟内完成下载。然后打开ZIP压缩包后,您可以看到两个文件夹:
phonebookdemo为您的项目名称,项目结构为前后端分离。
- angular文件夹包含了管理端的界面,是用于配合应用程序后端运行使用的。
- aspnet-core文件夹则包含了服务端的ASP.NET Core解决方案,需要使用Visual Studio启动。
环境配置要求
请先检查自己是否安装了以下环境配置:
- Visual Studio 2017(v15.9.0 )(用于启用ASP.NET Core应用程序)
- 或者 Visual Studio 2019
- Typescript 3.0
- Node.js 10.16.0 with NPM 3.10
- Yarn
- .Net Core SDK VS2017补丁包
- .NET CORE 2.2以上SDK
ASP.NET Core 应用程序
使用Visual Studio 2019,打开项目解决方案(YoyoSoft.PhoneBookDemo.sln),您会看到以下解决方案:
右键单击(*.Web.Host)项目并选择“设置为启动项目“然后生成解决方案。第一次生成解决方案,可能需要更长的时间,因为会从远程恢复Nuget包。
数据库
因为我们采用CodeFirst的模式开发,所以我们不需要sql文件。你如果还不会Codefirst的开发模式,可以系统性的学习一次Asp.net Core ,推荐观看我们的教程:跨平台开发实战掌握ASP.NET Core 与EntityFramework Core
连接字符串
在 *.Web.Host 项目下,打开 appsettings.json 文件,您可以修改这个默认字符串内容:
代码语言:javascript复制"Default": "Server=.; Database=PhoneBookDemo_db; Trusted_Connection=True;"
JSON
迁移数据库
我们有两种方式来创建或者迁移数据库到最新的版本。
使用52ABP-PRO的迁移工具
52ABP-PRO的提供了一个迁移工具,在解决方案中tools文件中(YoyoSoft.PhoneBookDemo.Migrator),您可以在开发和生产环境中,使用这个工具为您的数据库进行迁移。您可以查看迁移数据库控制台文档来了解更多详细。
EntityFramework Core迁移命令
您还可以使用EntityFramework Core内置的工具,进行数据库的迁移。打开程序包管理控制台。然后设置YoyoSoft.PhoneBookDemo.EntityFramework为默认项目,然后输入Update-database
命令来更新数据库。
此命令会创建数据库。数据的初始化则需要您运行 *.Web.Host 项目才会执行。您可以打开SQL Server Management Studio 工具来查看数据库是否创建成功。
我们一般会推荐您使用EF控制台命令进行开发,使用Migror.exe进行生产环境的迁移。请注意Migror.exe支持同时在多个数据库中运行迁移,这在多租户应用程序的开发/生产环境中很有用。
配置多租户
52ABP-PRO支持多租户和单租户应用程序。多租户默认为启用状态。如果你对多租户没有概念,那是否听过SaaS服务呢?如果都没有的话,我推荐您看看这篇文章《有哪些通俗易懂的例子可以解释 IaaS、PaaS、SaaS 的区别》
如果不想创建多租户应用程序,可以在项目的Core层,打开PhoneBookDemoConsts.cs文件,将MultiTenancyEnabled的值设置为False。
可视化的SwaggerUI,查看动态Webapi
完成以上配置后,您可以运行应用程序。服务端只包含API。当项目运行后会默认打开SwaggerUI。
通过SwaggerUI 您可以对项目进行可视化的API接口调试。
Angular UI应用
我们的Angular应用采用的是 Ng Alain Pro 版本,如果您已经购买了我们的企业版,可以放心使用,无须再次购买版权。
还原包
打开angular文件夹,然后使用命令行工具,运行yarn
命令来还原包。
因为NPM还原包的速度比较慢,并且不够稳定,所以我们采用yarn
来进行包的还原。而且yarn和NPM是兼容的。
运行应用程序
在命令行工具中运行以下命令:
npm start
项目就会进行编译,一旦编译成功后。您可以通过浏览器访问 localhost:8080 来查看项目。
当然我们也配套了(HMR)热模块替换的启用。
您可以使用: npm run hmr
来运行。
登录
当运行成功后!您可以登录程序了。
如果您启用了多租户,在这里能够看到有一个租户注册。以及切换租户的功能。我们默认创建了一个default的租户信息。如果您保留为空,则会进入宿主管理员的身份登录。
账号和密码
默认的管理员账号为:admin 默认密码为:bb123456 为了您系统的安全,请及时更改你的密码。
系统UI
当您登录系统后,可以看到系统完整的功能。
52ABP配套代码生成器
52ABP PowerTools 是一个基于实体,就可以从数据库创建一个新页面到UI层。它创建实体、相关权限、应用程序服务、DTO、客户端代码、菜单元素等。最后,您将有一个具有插入、更新、删除、列表和EXCEL导出功能的CRUD页面。要尽量减少创建新页面的工作量,有关代码生成器的更多信息52ABP-PRO代码生成器介绍