From 18080dd83e2062403fc0b725eb014b3b1029fcbf Mon Sep 17 00:00:00 2001 From: Jan Kotas Date: Tue, 13 Nov 2018 06:29:02 -0800 Subject: [PATCH 1/3] Update rid-catalog.md - Add RID for Alpine Linux and linux-musl - Delete references to corert RIDs (they never shipped) - Trim the list of the most common RIDs to just mention the common RIDs. It does not make sense this list to duplicate the whole support matrix. It would be very long and always outdated. --- docs/core/rid-catalog.md | 86 +++++++++------------------------------- 1 file changed, 19 insertions(+), 67 deletions(-) diff --git a/docs/core/rid-catalog.md b/docs/core/rid-catalog.md index 898285319eaf0..d8a96531b76c6 100644 --- a/docs/core/rid-catalog.md +++ b/docs/core/rid-catalog.md @@ -8,7 +8,7 @@ ms.date: 07/19/2018 # .NET Core RID Catalog RID is short for *Runtime IDentifier*. RID values are used to identify target platforms where the application runs. -They're used by .NET packages to represent platform-specific assets in NuGet packages. The following values are examples of RIDs: `linux-x64`, `ubuntu.14.04-x64`, `win7-x64`, or `osx.10.12-x64`. +They're used by .NET packages to represent platform-specific assets in NuGet packages. The following values are examples of RIDs: `linux-x64`, `ubuntu.18.04-arm64`, `win7-x86`, or `osx.10.12-x64`. For the packages with native dependencies, the RID designates on which platforms the package can be restored. A single RID can be set in the `` element of your project file. Multiple RIDs can be defined as a semicolon-delimited list in the project file's `` element. They're also used via the `--runtime` option with the following [.NET Core CLI commands](./tools/index.md): @@ -31,7 +31,7 @@ RIDs that represent concrete operating systems usually follow this pattern: `[os - `[architecture]` is the processor architecture. For example: `x86`, `x64`, `arm`, or `arm64`. -- `[additional qualifiers]` further differentiate different platforms. For example: `aot` or `corert`. +- `[additional qualifiers]` further differentiate different platforms. For example: `aot`. ## RID graph @@ -80,24 +80,15 @@ For the latest and complete version, see the [runtime.json](https://github.com/d .NET Core 2.0 SDK introduces the concept of portable RIDs. They are new values added to the RID graph that aren't tied to a specific version or OS distribution. They're particularly useful when dealing with multiple Linux distros. -The following list shows the most common RIDs used for each OS. It doesn't cover `arm` or `corert` values. +The following list shows the most common RIDs used for each OS. ## Windows RIDs - Portable - `win-x86` - `win-x64` -- Windows 7 / Windows Server 2008 R2 - - `win7-x64` - - `win7-x86` -- Windows 8 / Windows Server 2012 - - `win8-x64` - - `win8-x86` - - `win8-arm` -- Windows 8.1 / Windows Server 2012 R2 - - `win81-x64` - - `win81-x86` - - `win81-arm` + - `win-arm` + - `win-arm64` - Windows 10 / Windows Server 2016 - `win10-x64` - `win10-x86` @@ -110,85 +101,46 @@ See [Prerequisites for .NET Core on Windows](windows-prerequisites.md) for more - Portable - `linux-x64` + - `linux-arm` + - `linux-arm64` +- Portable (musl-libc based distros) + - `linux-musl-x64` + - `linux-musl-arm` + - `linux-musl-arm64` +- Alpine + - `alpine-x64` - CentOS - `centos-x64` - - `centos.7-x64` - Debian - `debian-x64` - - `debian.8-x64` - - `debian.9-x64` (.NET Core 1.1 or later versions) - Fedora - `fedora-x64` - - `fedora.27-x64` - - `fedora.28-x64` (.NET Core 1.1 or later versions) -- Gentoo (.NET Core 2.0 or later versions) - - `gentoo-x64` - openSUSE - `opensuse-x64` - - `opensuse.42.3-x64` - Oracle Linux - `ol-x64` - - `ol.7-x64` - - `ol.7.0-x64` - - `ol.7.1-x64` - - `ol.7.2-x64` - - `ol.7.3-x64` - - `ol.7.4-x64` - Red Hat Enterprise Linux - `rhel-x64` - - `rhel.6-x64` (.NET Core 2.0 or later versions) - - `rhel.7-x64` - - `rhel.7.1-x64` - - `rhel.7.2-x64` - - `rhel.7.3-x64` (.NET Core 2.0 or later versions) - - `rhel.7.4-x64` (.NET Core 2.0 or later versions) -- Tizen (.NET Core 2.0 or later versions) - - `tizen` - - `tizen.4.0.0` - - `tizen.5.0.0` + - `rhel.6-x64` - Ubuntu - `ubuntu-x64` - `ubuntu.14.04-x64` - `ubuntu.16.04-x64` - `ubuntu.17.10-x64` - `ubuntu.18.04-x64` -- Ubuntu derivatives - - `linuxmint.17-x64` - - `linuxmint.17.1-x64` - - `linuxmint.17.2-x64` - - `linuxmint.17.3-x64` - - `linuxmint.18-x64` (.NET Core 2.0 or later versions) - - `linuxmint.18.1-x64` (.NET Core 2.0 or later versions) - - `linuxmint.18.2-x64` (.NET Core 2.0 or later versions) - - `linuxmint.18.3-x64` (.NET Core 2.0 or later versions) -- SUSE Enterprise Linux (SLES) (.NET Core 2.0 or later versions) +- SUSE Enterprise Linux (SLES) - `sles-x64` - - `sles.12-x64` - - `sles.12.1-x64` - - `sles.12.2-x64` - - `sles.12.3-x64` -- Alpine Linux (.NET Core 2.1 or later versions) - - `alpine-x64` - - `alpine.3.7-x64` -See [Prerequisites for .NET Core on Linux](linux-prerequisites.md) for more information. +See [Prerequisites for .NET Core on Linux](linux-prerequisites.md) for more information about supported Linux versions. ## macOS RIDs macOS RIDs use the older "OSX" branding. -- `osx-x64` (.NET Core 2.0 or later versions, minimum version is `osx.10.12-x64`) -- `osx.10.10-x64` -- `osx.10.11-x64` -- `osx.10.12-x64` (.NET Core 1.1 or later versions) -- `osx.10.13-x64` - -See [Prerequisites for .NET Core on macOS](macos-prerequisites.md) for more information. - -## Android RIDs (.NET Core 2.0 or later versions) +- `osx-x64` +- `osx.10.12-x64` -- `android` -- `android.21` +See [Prerequisites for .NET Core on macOS](macos-prerequisites.md) for more information about supported macOS versions. ## See also From 863a7179b740ea1eddc2627263b9e8ca7168f270 Mon Sep 17 00:00:00 2001 From: Jan Kotas Date: Tue, 13 Nov 2018 06:33:04 -0800 Subject: [PATCH 2/3] Update rid-catalog.md Keep Windows 7 in the list of the most common RIDs --- docs/core/rid-catalog.md | 3 +++ 1 file changed, 3 insertions(+) diff --git a/docs/core/rid-catalog.md b/docs/core/rid-catalog.md index d8a96531b76c6..c20804ffaf1ef 100644 --- a/docs/core/rid-catalog.md +++ b/docs/core/rid-catalog.md @@ -89,6 +89,9 @@ The following list shows the most common RIDs used for each OS. - `win-x64` - `win-arm` - `win-arm64` +- Windows 7 / Windows Server 2008 R2 + - `win7-x64` + - `win7-x86` - Windows 10 / Windows Server 2016 - `win10-x64` - `win10-x86` From 90c134f8901f9d16eeb6396b08d71c29d03739ef Mon Sep 17 00:00:00 2001 From: Jan Kotas Date: Tue, 13 Nov 2018 07:16:07 -0800 Subject: [PATCH 3/3] Update rid-catalog.md Keep Linux mint --- docs/core/rid-catalog.md | 3 +++ 1 file changed, 3 insertions(+) diff --git a/docs/core/rid-catalog.md b/docs/core/rid-catalog.md index c20804ffaf1ef..e54d81b397382 100644 --- a/docs/core/rid-catalog.md +++ b/docs/core/rid-catalog.md @@ -118,6 +118,9 @@ See [Prerequisites for .NET Core on Windows](windows-prerequisites.md) for more - `debian-x64` - Fedora - `fedora-x64` +- Linux Mint + - `linuxmint.17-x64` + - `linuxmint.18-x64` - openSUSE - `opensuse-x64` - Oracle Linux