ABP 版本 8.2 迁移指南

本文档是用于将 ABP v8.x 解决方案升级到 ABP v8.2 的指南。此版本中的一些更改可能会影响您的应用程序，请仔细阅读并为您的应用程序应用必要的更改。

模板项目更新目标框架至 net8.0

以下模板项目的 TargetFrameworks 已升级至 net8.0：

• *.Application.Contracts
• *.Domain.Shared
• *.Domain
• *.MongoDB
• *.HttpApi.Client
• *.Host.Shared (用于模块模板)

在此版本之前，上述所有项目都面向多个框架（netstandard2.0、netstandard2.1 和 net8.0）。从本版本开始，我们开始仅让这些模板项目面向 net8.0。请注意，所有其他共享库仍然面向多个框架。

此更改不应影响您现有的解决方案，您无需在应用程序中进行任何更改。更多信息请参见 PR：https://github.com/abpframework/abp/pull/19565

为 Basic 主题的 .tab-content 类添加了默认内边距

在此版本中，为 Basic 主题的 tab-content 添加了默认内边距（padding-top: 1.5rem 和 padding-bottom: 1.5rem）。更多信息请参见 #19475。

移动了 Blogging 模块的成员页面目录

从本版本开始，ABP 框架允许您使用单博客模式，而无需定义博客和前缀。随着此更改，完成了以下命名空间变更：

• Volo.Blogging.Pages.Blog -> Volo.Blogging.Pages.Blogs
• Volo.Blogging.Pages.Members -> Volo.Blogging.Pages.Blogs.Members (members 文件夹)

如果您没有重写上述页面，则无需进行任何额外更改。更多信息请参见 #19418。

从 ILanguageInfo 中移除了 FlagIcon 属性

由于我们在早期版本中已从所有主题中移除了旗帜图标库，并且现在没有任何主题使用它，因此已从 ILanguageInfo 接口中移除了 FlagIcon 属性。

如果在定义本地化语言时指定了旗帜图标，则应将其移除：

        Configure<AbpLocalizationOptions>(options =>
        {
-           options.Languages.Add(new LanguageInfo("hi", "hi", "Hindi", "in"));
+          options.Languages.Add(new LanguageInfo("hi", "hi", "Hindi"));
             //...
        }

Blazor 全栈 Web UI

在此版本中，ABP 框架提供了一个新的 UI 选项，称为 Blazor 全栈 Web 应用程序。我们已经为您创建了一个介绍/迁移指南供您查看：迁移到 Blazor Web 应用程序

如果您考虑将现有的 Blazor 项目迁移到 Blazor Web 应用程序，请仔细阅读文档。

Angular UI

在此版本中，Angular UI 已更新为使用 Angular 版本 17.3.0 和 Nx 版本 19.0.0。更多信息请参见 PR：#19915

会话管理基础设施

会话管理功能允许您防止并发登录并管理用户会话。

在此版本中，向框架添加了一个名为 IdentitySession 的新实体，如果您的 DbContext 类实现了 IIdentityDbContext 接口，则需要向其添加新的 DbSet<IdentitySession>。

public class YourDbContext : AbpDbContext<YourDbContext>, IIdentityDbContext
{
    public DbSet<IdentitySession> Sessions { get; set; }
}

您还应创建一个新的数据库迁移并将其应用到您的数据库。

升级的 NuGet 依赖项

您可以查看以下随此版本升级的 NuGet 库列表，如果您明确使用了以下任一包，您可能需要考虑在您的解决方案中升级它们，尤其是 Microsoft.IdentityModel.* 包：