.NET Core RID 目录.NET Core RID Catalog

本文内容

RID 是运行时标识符的缩写。RID 值用于标识应用程序运行所在的目标平台。.NET 包使用它们来表示 NuGet 包中特定于平台的资产。以下值是 RID 的示例:linux-x64ubuntu.14.04-x64win7-x64osx.10.12-x64对于具有本机依赖项的包,RID 将指定在其中可以还原包的平台。

可以在项目文件的 <RuntimeIdentifier> 元素中设置一个 RID。可以将多个 RID 定义为项目文件的 <RuntimeIdentifiers> 元素中的列表(以分号分隔)。也可使用以下 .NET Core CLI 命令 通过 —runtime 选项使用它们:

  • dotnet build
  • dotnet clean
  • dotnet pack
  • dotnet publish
  • dotnet restore
  • dotnet run
  • dotnet store表示具体操作系统的 RID 通常遵循以下模式:[os].[version]-[architecture]-[additional qualifiers],其中:

  • [os] 是操作系统/平台系统名字对象。例如 ubuntu

  • [version] 是操作系统版本,使用的格式是以点 (.) 分隔的版本号。例如 15.10

    • 版本不应为营销版本,因为它们通常代表该操作系统的多个离散版本,且具有不同的平台 API 外围应用。
  • [architecture] 是处理器体系结构。例如:x86x64armarm64

  • [additional qualifiers] 进一步区分了不同的平台。例如:aot

RID 图表RID graph

RID 图表或运行时回退图表是互相兼容的 RID 列表。Microsoft.NETCore.Platforms 包中定义了 RID。可以在 CoreFX 存储库的 runtime.json 文件中查看支持的 RID 列表和 RID 图表。在此文件中,可以看到除基 RID 以外的所有 RID 均包含 "#import" 语句。这些语句指示的是兼容的 RID。

NuGet 还原包时,它将尝试找到指定运行时的完全匹配项。如果未找到完全匹配项,NuGet 将返回此图表,直至它根据 RID 图表找到最相近的兼容系统。

以下示例是 osx.10.12-x64 RID 的实际条目:

  1. "osx.10.12-x64": {
  2. "#import": [ "osx.10.12", "osx.10.11-x64" ]
  3. }

上述 RID 指定 osx.10.12-x64 导入 osx.10.11-x64因此,当 NuGet 还原包时,它将尝试找到包中的 osx.10.12-x64 的完全匹配项。例如,如果 NuGet 无法找到特定的运行时,可以还原指定 osx.10.11-x64 运行时的包。

以下示例演示了 runtime.json 文件中定义的另一个略大的 RID 图表:

  1. win7-x64 win7-x86
  2. | \ / |
  3. | win7 |
  4. | | |
  5. win-x64 | win-x86
  6. \ | /
  7. win
  8. |
  9. any

所有 RID 最终都会映射回根 any RID。

使用 RID 时,必须牢记以下几个注意事项:

  • RID 是不透明字符串,应将其视为黑盒。
  • 请勿以编程方式生成 RID。
  • 使用已为平台定义的 RID。
  • RID 必须具有特定性,因此请勿通过实际的 RID 值假定任何情况。

使用 RIDUsing RIDs

若要使用 RID,必须知道有哪些 RID。新值将定期添加到该平台。若要获取最新的完整版,请参阅 CoreFX 存储库上的 runtime.json 文件。

.NET Core 2.0 SDK 引入了可移植 RID 的概念。它们是添加到 RID 图表的新值,并且未与特定版本或 OS 发行版本关联,是使用 .NET Core 2.0 及更高版本的首选值。它们在处理多个 Linux 发行版时特别有用,因为大多数发行版 RID 都映射到可移植的 RID。

以下列表显示了一小部分用于每个 OS 的最常见 RID。

Windows RIDWindows RIDs

仅列出了公共值。若要获取最新的完整版,请参阅 CoreFX 存储库上的 runtime.json 文件。

  • 可移植(.NET Core 2.0 或更高版本)
    • win-x64
    • win-x86
    • win-arm
    • win-arm64
  • Windows 7 / Windows Server 2008 R2
    • win7-x64
    • win7-x86
  • Windows 8.1 / Windows Server 2012 R2
    • win81-x64
    • win81-x86
    • win81-arm
  • Windows 10 / Windows Server 2016

Linux RIDLinux RIDs

仅列出了公共值。若要获取最新的完整版,请参阅 CoreFX 存储库上的 runtime.json 文件。运行以下未列出的发行版的设备可能适用于其中一个可移植 RID。例如,可以将运行未列出的 Linux 发行版的 Raspberry Pi 设备定向为使用 linux-arm

  • 可移植(.NET Core 2.0 或更高版本)
    • linux-x64(大多数桌面发行版,如 CentOS、Debian、Fedora、Ubuntu 及派生版本)
    • linux-musl-x64(使用 musl 的轻量级发行版,如 Alpine Linux)
    • linux-arm(在 ARM 上运行的 Linux 分发版,如 Raspberry Pi)
  • Red Hat Enterprise Linux
    • rhel-x64(被 linux-x64 取代,适用于 RHEL 6 以上版本)
    • rhel.6-x64(.NET Core 2.0 或更高版本)
  • Tizen(.NET Core 2.0 或更高版本)

macOS RIDmacOS RIDs

macOS RID 使用较早的“OSX”品牌。仅列出了公共值。若要获取最新的完整版,请参阅 CoreFX 存储库上的 runtime.json 文件。

  • 可移植(.NET Core 2.0 或更高版本)
    • osx-x64(最低 OS 版本为 macOS 10.12 Sierra)
  • macOS 10.10 Yosemite
    • osx.10.10-x64
  • macOS 10.11 El Capitan
    • osx.10.11-x64
  • macOS 10.12 Sierra(.NET Core 1.1 或更高版本)
    • osx.10.12-x64
  • macOS 10.13 High Sierra(.NET Core 1.1 或更高版本)
    • osx.10.13-x64
  • macOS 10.14 Mojave(.NET Core 1.1 或更高版本)

请参阅See also