我的书签
添加书签
移除书签设置你的开发环境
创建第一个项目之前,需要正确的设置你的开发环境.
你需要安装以下工具:
for Windows / Visual Studio for Mac.
2 或 npm v6+ (与Node一起安装)
1 只要支持.NET Core和ASP.NET Core,就可以使用其他编辑器代替Visual Studio.
2 Yarn v2 的工作方式不同,不受支持. ↩
安装ABP CLI
ABP CLI是一个命令行页面,用于自动执行一些基于ABP的应用程序的常见任务.
你需要使用以下命令安排ABP CLI:
如果你已经安装,你可以使用以下命令更新到最新版本:
本文假设你使用 MVC / Razor Pages 做为UI框架 Entity Framework Core 做为数据库提供程序,对于其它选项,你可以更改文档顶部的首选项.
使用ABP CLI的 命令创建新项目:
- 此命令还会在解决方案文件夹内创建一个React Native移动应用程序. 如果你不想要它,可以安全地删除它或从
abp new命令中删除--mobile react-native选项, 以使其完全不包含在解决方案中.
你可以使用不同级别的命令空间; 例如. BookStore, Acme.BookStore or Acme.Retail.BookStore.
ABP CLI 命令 & 选项
解决方案结构
创建项目后你会有以下解决方案目录和文件:
在Visual Studio中打开 .sln 文件时,将看到以下解决方案结构:
关于解决方案中的项目
根据你的UI,数据库和其他选项,你的解决方案的结构可能略有不同.
该解决方案具有分层结构(基于Domain Driven Design), 并包含配置好的的单元&集成测试项目.
集成测试项目已配置为可与 EF Core & SQLite 内存 database同时使用.
请参阅详细了解解决方案结构.
连接字符串
检查 .Web 项目下 appsettings.json 文件中的 链接字符串:
该解决方案配置为Entity Framework Core与MS SQL Server一起使用. EF Core支持数据库提供程序,因此你可以使用任何受支持的DBMS. 请参阅Entity Framework集成文档了解如何切换到另一个DBMS.
查看.Web项目下appsettings.json文件中的 连接字符串:
解决方案使用 Entity Framework Core 和 MS SQL Server. EF Core支持数据库提供程序,因此你可以根据实际需要使用其他DBMS. 如果需要,请更改连接字符串.
应用迁移
该解决方案使用. 你需要应用迁移来创建数据库,有两种方法迁移数据库.
使用DbMigrator应用程序应用迁移
该解决方案包含一个控制台应用程序(在此示例中名为),可以创建数据库,应用迁移和初始化数据. 它对开发和生产环境都很有用.
按F5(或Ctrl + F5)运行应用程序. 它将具有如下所示的输出:
使用EF Core Update-Database命令
Ef Core具有Update-Database命令, 可根据需要创建数据库并应用挂起的迁移. 右键单击.Web项目并选择设置为启动项目:
右键单击.Web项目并选择设置为启动项目:
打开包管理器控制台(Package Manager Console), 选择.EntityFrameworkCore.DbMigrations项目作为默认项目并运行命令:
这将基于配置的连接字符串创建新数据库.
使用
.DbMigrator工具是建议的方法, 因为它能初始化初始数据能够正确运行Web应用程序.如果你只是使用
Update-Database命令,你会得到一个空数据库,所以你无法登录到应用程序因为数据库中没有初始管理用户. 不需要种子数据库时,可以在开发期间使用Update-Database命令. 但是使用.DbMigrator应用程序会更简单,你始终可以使用它来迁移模式并为数据库添加种子.
最后确保 .Web 是启动项目,运行应用程序后会在你的浏览器打开一个 login 页面.
在Visual Studio中使用Ctrl+F5(而不是F5)运行应用,如果你不用于调试,这会减少启动时间.
输入用户名 admin,密码 1q2w3E* 登录到应用程序,应用程序已经启动并执行,你可以基于此启动模板开始开发应用程序.
移动开发
当你创建一个新的应用程序时. 可以添加-m react-native选项以在解决方案中包含 react-native项目. 这是一个基础的React Native启动模板,用于开发与基于ABP的后端集成的移动应用程序.
