eShopOnWeb 开源项目教程

1. 项目介绍

eShopOnWeb 是一个由 Microsoft 提供的示例 ASP.NET Core 8.0 参考应用程序，展示了分层应用程序架构与单体部署模型。该项目旨在支持《使用 ASP.NET Core 和 Azure 构建现代 Web 应用程序》一书的免费 PDF 下载，并提供了一个实际的 Web 应用程序示例，帮助开发者理解和实践现代 Web 应用程序的架构设计。

eShopOnWeb 与 eShopOnContainers 示例应用程序相关，后者专注于微服务/容器化的应用架构。相比之下，eShopOnWeb 更简单，专注于传统的 Web 应用程序开发，具有单一部署模型。

2. 项目快速启动

2.1 克隆项目

首先，克隆 eShopOnWeb 项目到本地：

git clone https://github.com/dotnet-architecture/eShopOnWeb.git

2.2 配置数据库

默认情况下，项目使用真实的数据库。如果你想使用内存数据库，可以在 appsettings.json 文件中添加以下配置：

{
  "UseOnlyInMemoryDatabase": true
}

确保你的连接字符串指向本地 SQL Server 实例。

2.3 运行数据库迁移

在 Web 文件夹中打开命令提示符，并执行以下命令来创建数据库：

dotnet restore
dotnet tool restore
dotnet ef database update -c catalogcontext -p ../Infrastructure/Infrastructure.csproj -s Web.csproj
dotnet ef database update -c appidentitydbcontext -p ../Infrastructure/Infrastructure.csproj -s Web.csproj

2.4 启动应用程序

在 Web 文件夹中运行以下命令启动应用程序：

dotnet run --launch-profile Web

现在，你应该可以通过 https://localhost:5001/ 访问应用程序。

3. 应用案例和最佳实践

3.1 单体应用架构

eShopOnWeb 展示了如何构建一个单体应用架构，适用于中小型项目。通过分层设计，项目将业务逻辑、数据访问和用户界面分离，提高了代码的可维护性和可扩展性。

3.2 使用 Blazor WebAssembly

项目中的 Admin 页面使用了 Blazor WebAssembly，展示了如何在 ASP.NET Core 中集成 Blazor，实现客户端和服务器端的无缝交互。

3.3 数据库迁移

通过 Entity Framework Core 的迁移功能，项目展示了如何管理数据库的版本控制，确保开发和生产环境的数据库结构一致。

4. 典型生态项目

4.1 eShopOnContainers

eShopOnContainers 是 eShopOnWeb 的姊妹项目，专注于微服务和容器化的应用架构。通过对比这两个项目，开发者可以更好地理解单体应用和微服务架构的优缺点。

4.2 Azure Developer CLI

Azure Developer CLI (azd) 是一个开发者友好的命令行工具，用于创建和管理 Azure 应用程序。eShopOnWeb 提供了使用 azd 进行快速部署的示例，展示了如何将本地开发的应用程序快速部署到 Azure 云平台。

4.3 ASP.NET Core 8.0

eShopOnWeb 基于最新的 ASP.NET Core 8.0 框架，展示了如何利用最新的 .NET 技术构建现代 Web 应用程序。通过学习该项目，开发者可以掌握 ASP.NET Core 8.0 的新特性和最佳实践。

---

通过以上教程，你应该能够快速启动并理解 eShopOnWeb 项目的基本架构和使用方法。希望这个教程对你有所帮助！