抠丁客 抠丁客
项目
编辑 (2025/12/24)

ABP应用程序开发环境准备

本文档将指导您为基于ABP的应用程序开发准备开发环境。

注意事项

本文档提到的先决条件并非所有项目类型都必须安装：

  • 如果应用程序使用MongoDB而非EF Core，则无需安装EF Core CLI
  • 如果开发的是非微服务应用程序，则无需安装Helm、NGINX Ingress或mkcert

新解决方案中的README.MD文件包含针对您解决方案的具体要求。请参考您解决方案的README.MD文件。

开发工具

您需要使用支持.NET开发的IDE。以下是.NET开发最流行的IDE：

Visual Studio

Visual Studio是微软的IDE，是开发.NET项目的事实标准工具。您可以从Visual Studio官网下载。它还有免费的社区版，对于ABP项目来说完全够用。

Visual Studio Code

Visual Studio Code是免费且跨平台的轻量级代码编辑器，支持.NET开发。您可以从此处下载。

JetBrains Rider

JetBrains Rider是JetBrains开发的跨平台IDE，支持.NET开发。它**对非商业用途免费**。

.NET SDK

ABP基于.NET构建，因此您需要安装.NET SDK。您可以从.NET官网下载.NET SDK。

安装Visual Studio或JetBrains Rider可能会自动安装.NET SDK。

EF Core CLI

如果使用Entity Framework Core作为数据库访问提供程序，您需要安装EF Core CLI。可通过以下命令安装：

dotnet tool install --global dotnet-ef

如果已安装EF Core CLI，可通过以下命令更新：

dotnet tool update --global dotnet-ef

Node.js

ABP项目包含一些前端资源包，因此需要安装Node.js/NPM来管理这些资源包。您可以从Node.js官网下载。建议安装v20.11+版本。

Yarn（仅Angular项目需要）

ABP Angular项目使用Yarn作为包管理器来管理前端依赖项并运行构建任务。您可以从Yarn官网下载Yarn。建议安装Yarn v1.22+（请确保安装Classic版本，而非v2+版本）。

使用npm安装Yarn的命令：

npm install --global yarn

Docker Engine或Docker Desktop

ABP的分层解决方案和微服务解决方案使用Docker运行应用程序所需的基础设施服务（如SQL Server、Redis、RabbitMQ）。您可以在Windows、macOS和Linux上安装Docker Engine或Docker Desktop（推荐）。

Docker Engine或Docker Desktop是否免费？

Docker Engine是开源免费的容器化技术，用于构建和容器化应用程序。Docker Engine遵循Apache 2.0许可证。

Docker Desktop对小型企业（少于250名员工且年收入低于1000万美元）、个人使用、教育和非商业开源项目免费。

PowerShell

ABP启动解决方案模板和工具使用一些PowerShell脚本（*.ps1）来执行特定任务。您可参考PowerShell文档获取在Windows、macOS和Linux上安装PowerShell的指导。

微服务解决方案

以下工具仅开发ABP微服务解决方案时需要

Helm

Helm是Kubernetes的包管理器。您可按照Helm安装指南安装Helm。

详细信息请参阅本地Kubernetes集群上的Helm部署。

NGINX Ingress或使用Helm安装NGINX Ingress

NGINX Ingress是Kubernetes的Ingress控制器。您可按照NGINX Ingress安装指南安装。

如果使用Helm，可通过以下命令安装NGINX Ingress：

helm repo add ingress-nginx https://kubernetes.github.io/ingress-nginx
helm repo update
helm upgrade --install --version=4.0.19 ingress-nginx ingress-nginx/ingress-nginx --set controller.config.enable-underscores-in-headers="true"

enable-underscores-in-headers是必需的，允许HTTP请求使用__tenant将租户信息传递给后端服务。

mkcert

使用mkcert为本地开发生成可信证书。您可按照官方mkcert安装指南安装mkcert。

在本文档中