ABP 入门指南：创建分层 Web 应用程序

在本快速入门指南中，您将学习如何使用 ABP Studio 创建和运行一个分层（且可能是模块化）的 Web 应用程序。

设置您的开发环境

首先，最重要的事情！在创建第一个项目之前，我们先来设置您的开发环境。您的开发机器上应安装以下工具：

支持 .NET 9.0+ 开发的 Visual Studio 2022 或其他 IDE。
.NET 9.0+
Node v22.11+
Docker Desktop

有关这些工具的更多详细信息，请查看先决条件文档。

创建新解决方案

ABP 启动解决方案模板针对您的特定需求提供了许多选项。如果您不理解某个选项，这可能意味着您不需要它。我们为您选择了通用默认值，因此您可以保留这些选项不变。

假设您已安装并登录应用程序，打开 ABP Studio 时应该会看到以下屏幕：

在主菜单中选择文件 -> 新建解决方案，或单击欢迎屏幕上的 新建解决方案 按钮以打开 创建新解决方案 向导：

在本教程中，我们将使用 应用程序（分层） 解决方案模板，因此请选择它并单击 下一步 按钮：

在该屏幕上，您可以为解决方案选择一个名称。您可以使用不同级别的命名空间；例如 BookStore、Acme.BookStore 或 Acme.Retail.BookStore。

然后选择一个输出文件夹来创建您的解决方案。创建解决方案文件夹 选项将在给定的输出文件夹中创建一个与解决方案同名的文件夹。

配置完成后，单击 下一步 按钮导航到 UI 框架 选择：

在这里，您可以看到该启动解决方案模板支持的所有可能的 UI 选项。选择 Blazor WebApp。

请注意：一旦您选择了 UI 类型，UI 框架列表下将出现一些附加选项。您可以进一步配置这些选项或保留默认值，然后单击下一步按钮进入数据库提供程序选择屏幕：

在该屏幕上，您可以通过选择提供的选项之一来决定您的数据库提供程序。每个数据库提供程序都有一些附加选项。保留默认值或根据您的偏好更改它们，然后单击 下一步 按钮进入附加的数据库配置：

在这里，您可以选择数据库管理系统（DBMS）和连接字符串。然后，单击 下一步 按钮进入附加的多租户选择：

在这里，您可以为解决方案启用或禁用多租户。您可以进一步配置选项或保留默认值，然后单击 下一步 按钮进入 UI 主题 选择屏幕：

LeptonX 是建议用于生产环境的 UI 主题。选择一个主题，配置附加选项，然后单击 下一步 按钮进入 移动框架 选择：

在这里，您可以看到该启动解决方案模板中可用的所有移动应用程序。这些移动应用程序与您的解决方案良好集成，可以与您的 Web 应用程序使用相同的后端。它们简单（没有像 Web 应用程序那样多的预构建功能），但是构建移动应用程序的一个非常好的起点。

选择最适合您的一个，或者如果您不希望在解决方案中包含移动应用程序，请选择无，然后单击下一步导航到 公共网站 屏幕：

该启动解决方案模板还提供了一个在解决方案内创建第二个 Web 应用程序的选项。第二个应用程序称为公共网站，是一个 ASP.NET Core MVC / Razor Page 应用程序。它可用于为您的产品创建公共落地页/推广页。它很好地集成到解决方案中（例如，可以共享相同的服务、实体、数据库和相同的身份验证逻辑）。如果您愿意，还可以将 CMS Kit 模块添加到您的解决方案中，以为您的 Web 应用程序添加动态内容功能。

因此，选择 公共网站 或跳过它，然后单击下一步按钮进入 可选模块 选择：

该列表中的每一项都是一个预构建的应用程序模块。您可以单击模块名称附近的蓝色图标以获取有关该模块的更多信息。您可以保持列表原样（因此，它会为您安装最常见和使用的模块）或根据您的偏好进行自定义。

创建解决方案后安装模块可能需要手动步骤。因此，最好在开始时决定模块。您可以在实际解决方案之前创建一个示例解决方案来探索解决方案和模块。

选择所需模块后，单击 下一步 按钮进入 解决方案结构 屏幕：

它会创建一个仅提供 HTTP (REST) API 的独立主机应用程序。然后，Web 应用程序对每个操作都向该应用程序执行远程 HTTP 调用。如果未选择分层选项，则 Web 和 HTTP API 托管在单个应用程序中，并且从 UI 层到 API 层的调用在进程内执行。

分层架构允许您在无法访问数据库服务器的服务器上托管 Web (UI) 应用程序。然而，这会带来轻微的性能损失（因为 UI 和 HTTP API 应用程序之间的 HTTP 调用）并使您的架构、开发和部署更加复杂。如果您不理解分层结构，请直接跳过它。

完成分层选择后，您可以单击 下一步 按钮进入 语言选择 页面：

在此步骤中，您可以选择您的应用程序将支持的语言。

默认语言：选择您应用的主要语言。
可本地化的用户界面：打开此选项以支持多种语言。
可用语言：勾选您想要包含的语言。
如果要添加未列出的语言，请单击“添加自定义语言”。

如果需要，您以后可以更改这些设置。然后点击 下一步 按钮进入 附加选项 页面：

如果您取消选中 Kubernetes 配置 选项，解决方案将不包含 Kubernetes 配置文件，例如 Helm 图表和其他与 Kubernetes 相关的文件。您还可以指定 社交登录；如果您取消选中此选项，解决方案将不会配置为社交登录。最后，您可以指定 包含测试 选项以在解决方案中包含或排除测试项目。

在下一个屏幕上，您可以配置解决方案的模块化选项：

如果选择 设置为模块化解决方案 选项，则解决方案更易于进行模块化单体开发，并允许您在解决方案创建阶段添加子模块。

现在，我们准备允许 ABP Studio 创建我们的解决方案。只需单击创建按钮，让 ABP Studio 为您完成其余工作。单击创建按钮后，对话框关闭，您的解决方案将加载到 ABP Studio 中：

您可以探索解决方案，但在运行解决方案中的任何应用程序之前，您需要等待后台任务完成。

解决方案结构可能因您选择的选项而异。

运行应用程序

创建解决方案后，您可以在您喜欢的 IDE（例如 Visual Studio、Visual Studio Code 或 Rider）中打开它并开始开发。但是，ABP Studio 提供了一个 解决方案运行器 系统。您可以使用它轻松运行和浏览解决方案中的应用程序，而无需外部工具。

在 ABP Studio 左侧打开解决方案运行器部分，如下图所示：

解决方案运行器结构可能因您选择的选项而异。

一旦您单击左侧的播放图标，该部分将在与解决方案资源管理器部分相同的位置打开。ABP Studio 还会在主内容区域打开 应用程序监视器 视图。应用程序监视器 实时显示您应用程序的有用洞察（例如 HTTP 请求、事件和异常）。您可以使用它来查看应用程序中发生的事情，从而轻松跟踪错误和许多有用的详细信息。

在解决方案运行器部分（左侧），您可以看到当前解决方案中所有可运行的应用程序。对于包含公共网站和 MAUI 移动端的 MVC 示例，我们有四个应用程序：