欢迎点击“编辑按钮”参与文档的勘误和翻译哦。 编辑

本文贡献者 :

快速启动

本文作者:52ABP开发团队
文章会随着版本进行更新,关注我们获取最新版本
本文出处:https://www.52abp.com/wiki/52abp/latest
源代码: https://www.github.com/52abp

创建项目

如果您已经购买了52ABP-PRO,那么它会提高您的开发体验和工作效率。本文档的目标是准备在5分钟内创建和运行一个52ABP-PRO项目。

首先登录52ABP.COM,输入您的账号和密码。在下载页面上,选择企业版,您可以看到如下的表单内容。 Getting Started Angular 1

选择项目类型为“ASP .NET CORE&Angular”,填写您项目名称(为了演示方便,我们使用YoyoSoft.PhoneBookDemo作为我们的项目名称)以及其他信息。

你的项目将会在一分钟内完成下载。 然后打开ZIP压缩包后,您可以看到两个文件夹:

Getting Started Angular 2

phonebookdemo为您的项目名称,项目结构为前后端分离。

  • angular文件夹包含了管理端的界面,是用于配合应用程序后端运行使用的。
  • aspnet-core文件夹则包含了服务端的ASP.NET Core解决方案,需要使用Visual Studio启动。

环境配置要求

请先检查自己是否安装了以下环境配置:

ASP.NET Core 应用程序

使用Visual Studio 2019,打开项目解决方案(YoyoSoft.PhoneBookDemo.sln),您会看到以下解决方案:

Getting Started Angular 3

右键单击(*.Web.Host)项目并选择“设置为启动项目“然后生成解决方案。 第一次生成解决方案,可能需要更长的时间,因为会从远程恢复Nuget包。

数据库

因为我们采用CodeFirst的模式开发,所以我们不需要sql文件。你如果还不会Codefirst的开发模式,可以系统性的学习一次Asp.net Core ,推荐观看我们的教程:跨平台开发实战掌握ASP.NET Core 与EntityFramework Core

连接字符串

*.Web.Host 项目下,打开 appsettings.json 文件,您可以修改这个默认字符串内容:

"Default": "Server=.; Database=PhoneBookDemo_db; Trusted_Connection=True;"

迁移数据库

我们有两种方式来创建或者迁移数据库到最新的版本。

使用52ABP-PRO的迁移工具

52ABP-PRO的提供了一个迁移工具,在解决方案中tools文件中(YoyoSoft.PhoneBookDemo.Migrator),您可以在开发和生产环境中,使用这个工具为您的数据库进行迁移。您可以查看迁移数据库控制台文档来了解更多详细。

EntityFramework Core迁移命令

您还可以使用EntityFramework Core内置的工具,进行数据库的迁移。打开程序包管理控制台。然后设置YoyoSoft.PhoneBookDemo.EntityFramework为默认项目,然后输入Update-database命令来更新数据库。

Getting Started Angular 4

此命令会创建数据库。数据的初始化则需要您运行 *.Web.Host 项目才会执行。 您可以打开SQL Server Management Studio 工具来查看数据库是否创建成功。

Getting Started Angular 5

我们一般会推荐您使用EF控制台命令进行开发,使用Migror.exe进行生产环境的迁移。 请注意Migror.exe支持同时在多个数据库中运行迁移,这在多租户应用程序开发/生产环境中很有用。

配置多租户

52ABP-PRO支持多租户和单租户应用程序。多租户默认为启用状态。 如果你对多租户没有概念,那是否听过SaaS服务呢?如果都没有的话,我推荐您看看这篇文章《有哪些通俗易懂的例子可以解释 IaaS、PaaS、SaaS 的区别》

如果不想创建多租户应用程序,可以在项目的Core层,打开PhoneBookDemoConsts.cs文件,将MultiTenancyEnabled的值设置为False。

可视化的SwaggerUI,查看动态Webapi

完成以上配置后,您可以运行应用程序。服务端只包含API。当项目运行后会默认打开SwaggerUI。

Getting Started Angular 6

通过SwaggerUI 您可以对项目进行可视化的API接口调试。

Angular UI应用

我们的Angular应用采用的是 Ng Alain Pro 版本,如果您已经购买了我们的企业版,可以放心使用,无须再次购买版权。

还原包

打开angular文件夹,然后使用命令行工具,运行yarn命令来还原包。

因为NPM还原包的速度比较慢,并且不够稳定,所以我们采用yarn来进行包的还原。而且yarn和NPM是兼容的。

运行应用程序

在命令行工具中运行以下命令:

npm start

项目就会进行编译,一旦编译成功后。您可以通过浏览器访问 localhost:8080 来查看项目。

当然我们也配套了(HMR)热模块替换的启用。

您可以使用: npm run hmr 来运行。

登录

当运行成功后!您可以登录程序了。

Getting Started Angular 7

如果您启用了多租户,在这里能够看到有一个租户注册。以及切换租户的功能。我们默认创建了一个default的租户信息。如果您保留为空,则会进入宿主管理员的身份登录。

账号和密码

默认的管理员账号为:admin
默认密码为:bb123456
为了您系统的安全,请及时更改你的密码。

系统UI

当您登录系统后,可以看到系统完整的功能。

Getting Started Angular 8

52ABP配套代码生成器

52ABP PowerTools 是一个基于实体,就可以从数据库创建一个新页面到UI层。它创建实体、相关权限、应用程序服务、DTO、客户端代码、菜单元素等。 最后,您将有一个具有插入、更新、删除、列表和EXCEL导出功能的CRUD页面。要尽量减少创建新页面的工作量,有关代码生成器的更多信息52ABP-PRO代码生成器介绍

下一个

52ABP-PRO解决方案设计概述

来文档中心了解更多:https://www.52abp.com/wiki/

微信关注我们不走丢

公众号:角落的白板报

本文导航