// [文档SEO优化]
{
    "描述": "了解如何利用必备工具、命令和开发者指南，在ABP框架中设置并贡献Angular UI。"
}

Angular UI 贡献指南

前置要求

.NET Core SDK https://dotnet.microsoft.com/zh-cn/download
Node.js LTS版本 https://nodejs.org/zh-cn/
Docker https://docs.docker.com/engine/install/zh-cn/
Angular CLI https://angular.cn/guide/what-is-angular#angular-cli
Abp CLI https://docs.abp.io/zh/abp/latest/cli
代码编辑器

注意：本文以Windows操作系统为例，您可根据自己的操作系统调整路径格式。

示例：

Windows：templates\app\aspnet-core\src\MyCompanyName.MyProjectName.DbMigrator\appsettings.json
Unix系统：templates/app/aspnet-core/src/MyCompanyName.MyProjectName.DbMigrator/appsettings.json

Docker命令示例

您需要安装SQL Server和Redis。这些程序可以不通过Docker安装，但本示例使用Docker容器。请确保您的计算机已安装Docker引擎，然后打开终端逐一执行以下命令。

SQL Server安装命令：

docker run -v sqlvolume:/var/opt/mssql -e 'ACCEPT_EULA=Y' -e "SA_PASSWORD=yourpassword" -p 1433:1433 -d mcr.microsoft.com/mssql/server:2019-CU3-ubuntu-18.04

Redis安装命令：

docker run -p 6379:6379 -d redis

完成上述步骤后，即可下载并运行代码。

项目结构

该应用包含使用.NET Core（C#）编写的后端和Angular前端应用，两者均需运行。

运行后端应用

后端应用路径为“templates\app\aspnet-core”。若使用Docker版SQL Server，需修改连接字符串以适配Docker环境。连接字符串路径为： templates\app\aspnet-core\src\MyCompanyName.MyProjectName.DbMigrator\appsettings.json。

运行后端前，需先执行数据库迁移项目。DbMigrator用于创建初始表和初始数据，其路径为： templates\app\aspnet-core\src\MyCompanyName.MyProjectName.DbMigrator。在该路径下打开终端，执行命令 dotnet run。

运行后端前的最后一步是安装客户端库。进入 templates\app\aspnet-core 目录，打开终端并执行命令 abp install-libs。

接下来进入后端宿主项目路径：templates\app\aspnet-core\src\MyCompanyName.MyProjectName.HttpApi.HostWithIds，打开终端执行 dotnet run。

至此，后端应成功运行。

运行前端应用

项目中包含一个演示应用，路径为 npm\ng-packs\apps\dev-app。该演示应用通过本地引用连接至各个包。在 npm\ng-packs\apps\dev-app 路径下打开终端，执行 yarn 或 npm i 安装依赖包。安装完成后运行 npm start 或 yarn start。