.NET Core 运行时包存储详解

.NET Core 运行时包存储详解

docs This repository contains .NET Documentation. 项目地址: https://gitcode.com/gh_mirrors/docs2/docs

什么是运行时包存储

运行时包存储(Runtime Package Store)是.NET Core 2.0引入的一项重要功能，它允许开发者在目标环境中预装一组已知的共享包，从而优化应用程序的部署和运行。这项技术主要带来三大优势：

1. 更快的部署速度：无需将依赖包随应用一起发布
2. 更小的磁盘占用：多个应用可以共享同一组依赖包
3. 更好的启动性能：某些情况下可以提升应用启动速度

运行时包存储的工作原理

运行时包存储本质上是一个磁盘目录结构，其中存储了预先安装的NuGet包。其目录布局与NuGet包的磁盘结构相似，按照架构和目标框架组织：

dotnet
└── store
    ├── x64
    │   └── netcoreapp2.0
    │       ├── microsoft.applicationinsights
    │       └── microsoft.aspnetcore
    └── x86
        └── netcoreapp2.0
            ├── microsoft.applicationinsights
            └── microsoft.aspnetcore

如何准备运行时环境

系统管理员可以通过以下步骤为运行时环境配置包存储：

1. 创建包存储清单

首先需要创建一个XML格式的清单文件，列出要包含在运行时包存储中的所有包：

<Project Sdk="Microsoft.NET.Sdk">
  <ItemGroup>
    <PackageReference Include="Newtonsoft.Json" Version="13.0.1" />
    <PackageReference Include="Moq" Version="4.18.4" />
  </ItemGroup>
</Project>

2. 使用dotnet store命令创建存储

使用以下命令将清单中的包安装到运行时存储中：

dotnet store --manifest packages.csproj --runtime win-x64 --framework netcoreapp8.0

命令参数说明：

• --manifest：指定清单文件路径
• --runtime：指定目标运行时标识符(RID)
• --framework：指定目标框架

执行后会生成两个重要内容：

1. 包存储目录（默认在用户profile的.dotnet/store下）
2. artifact.xml清单文件（描述存储中包含的包）

发布针对目标清单的应用

开发者可以针对特定的运行时包存储发布应用：

dotnet publish --manifest manifest.xml

发布时需要注意：

1. 目标环境必须包含manifest中指定的所有包
2. 包版本必须完全匹配
3. 如果应用自带某个程序集（在bin目录中），则优先使用应用自带的版本

在项目文件中指定目标清单

对于目标环境明确的项目，可以在.csproj文件中直接指定目标清单：

<PropertyGroup>
  <TargetManifestFiles>manifest1.xml;manifest2.xml</TargetManifestFiles>
</PropertyGroup>

注意事项

1. 版本兼容性：确保manifest中的包版本与运行时环境中的版本完全一致
2. ASP.NET Core特殊情况：ASP.NET Core 2.0有隐式存储机制，但2.1及以后版本使用共享框架
3. 自包含应用：自包含部署的应用不使用运行时包存储

最佳实践

1. 生产环境应预先配置好运行时包存储
2. 开发环境与生产环境的包存储应保持一致
3. 定期更新包存储中的包版本
4. 对于开源项目，建议使用命令行参数而非项目文件指定manifest

运行时包存储是.NET Core部署体系中的重要优化手段，合理使用可以显著提升部署效率和运行时性能。

docs This repository contains .NET Documentation. 项目地址: https://gitcode.com/gh_mirrors/docs2/docs