From 4d6711707ec1984c3e2e68c973cfa647742ce443 Mon Sep 17 00:00:00 2001 From: Maira Wenzel Date: Mon, 8 Aug 2016 16:04:59 -0700 Subject: [PATCH 1/5] adding missing RIDs --- docs/core/rid-catalog.md | 47 +++++++++++++++++++++++++++++----------- 1 file changed, 34 insertions(+), 13 deletions(-) diff --git a/docs/core/rid-catalog.md b/docs/core/rid-catalog.md index c407c0e259977..324826d5ae36e 100644 --- a/docs/core/rid-catalog.md +++ b/docs/core/rid-catalog.md @@ -4,7 +4,7 @@ description: .NET Core Runtime IDentifier (RID) catalog keywords: .NET, .NET Core author: blackdwarf manager: wpickett -ms.date: 06/20/2016 +ms.date: 08/08/2016 ms.topic: article ms.prod: .net-core ms.technology: .net-core-technologies @@ -22,7 +22,7 @@ For the packages with native dependencies, it will designate on which platforms It is important to note that RIDs are really opaque strings. This means that they have to match exactly for operations using them to work. As an example, let us consider the case of [Elementary OS](https://elementary.io/), which is a straightforward clone of Ubuntu 14.04. Although .NET Core and CLI work on top of that version of Ubuntu, if you try to use them on Elementary OS -without any modifications, the restore operation for any package will fail. This is because we currently (May 3rd, 2016) don't +without any modifications, the restore operation for any package will fail. This is because we currently don't have a RID that designates Elementary OS as a platform. RIDs that represent concrete operating systems should be of the form: `[os].[version]-[arch]` where: @@ -33,15 +33,15 @@ accurate enough to reasonably enable assets to target operating system platform system with varying platform API surface area, for example, `win.10-x64` - `[arch]` is the processor architecture, for example, `x86`, `x64`, `arm`, `arm64`, etc. -The RID graph is defined in a package called `Microsoft.NETCore.Platforms` in a file called `runtime.json` which you can +The RID graph is defined in a package called `Microsoft.NETCore.Platforms` in a file called `runtime.json`, which you can see on the [CoreFX repo](https://github.com/dotnet/corefx/blob/master/pkg/Microsoft.NETCore.Platforms/runtime.json). If you use this file, you will notice that some of the RIDs have an `"#import"` statement in them. These statements are -compatibility statements. That means that a RID that has an imported RID in it, can be a target for restoring packages +compatibility statements. That means that a RID that has an imported RID in it can be a target for restoring packages for that RID. Slightly confusing, but let's look at an example. Let's take a look at macOS: ```json "osx.10.11-x64": { - "#import": [ "osx.10.11", "osx.10.10-x64" ] + "#import": [ "osx.10.11", "osx.10.10-x64" ] } ``` The above RID specifies that `osx.10.11-x64` imports `osx.10.10-x64`. This means that when restoring packages, NuGet will @@ -78,12 +78,12 @@ working with them: to determine which RID(s) you need for a given platform ## Using RIDs -In order to use RIDs, you have to know which RIDs there are. This document lists out the currently supported RIDs in -.NET Core. Please be aware that this document is getting updated regularly as new RIDs are added to the platform. If you -wish to check if new ones are added, please check back here. +In order to use RIDs, you have to know which RIDs there are. New RIDs are added regularly to the platform. +For the latest version, please check the [runtime.json](https://github.com/dotnet/corefx/blob/master/pkg/Microsoft.NETCore.Platforms/runtime.json) file on CoreFX repo. -> We are working towards getting this information into a more interactive form. When that happens, this page will be -> updated to point to that tool and/or its usage documentation. +> [!NOTE] +> We are working towards getting this information into a more interactive form. +> When that happens, this page will be updated to point to that tool and/or its usage documentation. ## Windows RIDs @@ -93,9 +93,16 @@ wish to check if new ones are added, please check back here. * Windows 8 * `win8-x64` * `win8-x86` + * `win8-arm` +* Windows 8.1 + * `win81-x64` + * `win81-x86` + * `win81-arm` * Windows 10 * `win10-x64` * `win10-x86` + * `win10-arm` + * `win10-arm64` ## Linux RIDs @@ -107,19 +114,33 @@ wish to check if new ones are added, please check back here. * `ubuntu.14.04-x64` * `ubuntu.14.10-x64` * `ubuntu.15.04-x64` + * `ubuntu.15.10-x64` + * `ubuntu.16.04-x64` + * `ubuntu.16.10-x64` * CentOS * `centos.7-x64` - * `centos.7.1-x64` * Debian * `debian.8-x64` - * `debian.8.2-x64` +* Fedora + * `fedora.23-x64` + * `fedora.24-x64` +* OpenSUSE + * `opensuse.13.2-x64` + * `opensuse.42.1-x64` +* Oracle Linux + * `ol.7-x64` + * `ol.7.0-x64` + * `ol.7.1-x64` + * `ol.7.2-x64` * Currently supported Ubuntu derivatives * `linuxmint.17-x64` * `linuxmint.17.1-x64` * `linuxmint.17.2-x64` * `linuxmint.17.3-x64` + * `linuxmint.18-x64` -## OS X RIDs +## Mac RIDs * `osx.10.10-x64` * `osx.10.11-x64` +* `osx.10.12-x64` \ No newline at end of file From e4657d09673a7be34d5a671027f3c6e961b13a4a Mon Sep 17 00:00:00 2001 From: Maira Wenzel Date: Fri, 19 Aug 2016 16:00:18 -0700 Subject: [PATCH 2/5] updated based on private feedback --- docs/core/rid-catalog.md | 18 +++++++++--------- 1 file changed, 9 insertions(+), 9 deletions(-) diff --git a/docs/core/rid-catalog.md b/docs/core/rid-catalog.md index 324826d5ae36e..b81290064f1ab 100644 --- a/docs/core/rid-catalog.md +++ b/docs/core/rid-catalog.md @@ -25,12 +25,12 @@ Ubuntu 14.04. Although .NET Core and CLI work on top of that version of Ubuntu, without any modifications, the restore operation for any package will fail. This is because we currently don't have a RID that designates Elementary OS as a platform. -RIDs that represent concrete operating systems should be of the form: `[os].[version]-[arch]` where: -- `[os]` is the operating system moniker, for example, `win` -- `[version]` is the operating system version in the form of a dot (`.`) separated version number, for example, `10.1511`, +RIDs that represent concrete operating systems usually follow this pattern: `[os].[version]-[arch]` where: +- `[os]` is the operating system moniker, for example, `ubuntu`. +- `[version]` is the operating system version in the form of a dot (`.`) separated version number, for example, `15.10`, accurate enough to reasonably enable assets to target operating system platform APIs represented by that version. - This **shouldn't** be marketing versions, as they often represent multiple discrete versions of the operating -system with varying platform API surface area, for example, `win.10-x64` +system with varying platform API surface area. - `[arch]` is the processor architecture, for example, `x86`, `x64`, `arm`, `arm64`, etc. The RID graph is defined in a package called `Microsoft.NETCore.Platforms` in a file called `runtime.json`, which you can @@ -87,18 +87,18 @@ For the latest version, please check the [runtime.json](https://github.com/dotne ## Windows RIDs -* Windows 7 +* Windows 7 / Windows Server 2008 R2 * `win7-x64` * `win7-x86` -* Windows 8 +* Windows 8 / Windows Server 2012 * `win8-x64` * `win8-x86` * `win8-arm` -* Windows 8.1 +* Windows 8.1 / Windows Server 2012 R2 * `win81-x64` * `win81-x86` * `win81-arm` -* Windows 10 +* Windows 10 / Windows Server 2016 * `win10-x64` * `win10-x86` * `win10-arm` @@ -143,4 +143,4 @@ For the latest version, please check the [runtime.json](https://github.com/dotne * `osx.10.10-x64` * `osx.10.11-x64` -* `osx.10.12-x64` \ No newline at end of file +* `osx.10.12-x64` From c05764c03d8d253cf99d7c4c04336f22bebbefab Mon Sep 17 00:00:00 2001 From: Maira Wenzel Date: Fri, 19 Aug 2016 16:06:44 -0700 Subject: [PATCH 3/5] undid heading change --- docs/core/rid-catalog.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/core/rid-catalog.md b/docs/core/rid-catalog.md index b81290064f1ab..447e10ceb4e85 100644 --- a/docs/core/rid-catalog.md +++ b/docs/core/rid-catalog.md @@ -139,7 +139,7 @@ For the latest version, please check the [runtime.json](https://github.com/dotne * `linuxmint.17.3-x64` * `linuxmint.18-x64` -## Mac RIDs +## OS X RIDs * `osx.10.10-x64` * `osx.10.11-x64` From 8457226b576a9e62146860662a81be0dd08fb0e3 Mon Sep 17 00:00:00 2001 From: Maira Wenzel Date: Mon, 22 Aug 2016 10:34:30 -0700 Subject: [PATCH 4/5] changed graph Using one from the runtime.json file --- docs/core/rid-catalog.md | 25 +++++++++---------------- 1 file changed, 9 insertions(+), 16 deletions(-) diff --git a/docs/core/rid-catalog.md b/docs/core/rid-catalog.md index 447e10ceb4e85..28b7e5680e6e3 100644 --- a/docs/core/rid-catalog.md +++ b/docs/core/rid-catalog.md @@ -49,22 +49,15 @@ be able to restore packages that specify that they need `osx.10.10-x64` on `osx. A slightly bigger example RID graph: -- `win.10.1511-x64` - - `win.10.1511` - - `win.10-x64` - - `win.10` - - `win.6.3.9200-x64` - - `win.6.3-x64` - - `win.6.3` - - `win.6.3.9200` - - `win.6.2.9200-x64` - - `win.6.2.9200` - - `win.6.1.7600-x64` - - `win.6.1.7600` - - `win.6.1-x64` - - `win.6.1` - - `win` - - `any` +- `win10-arm` + - `win10` + - `win81-arm` + - `win81` + - `win8-arm` + - `win8` + - `win7` + - `win` + - `any` All RIDs eventually map back to the root `any` RID. From 005a2a9484868e04cca9ec26d08de6bddb64048a Mon Sep 17 00:00:00 2001 From: Maira Wenzel Date: Mon, 22 Aug 2016 10:34:56 -0700 Subject: [PATCH 5/5] updated date --- docs/core/rid-catalog.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/core/rid-catalog.md b/docs/core/rid-catalog.md index 28b7e5680e6e3..bc181f0a5837f 100644 --- a/docs/core/rid-catalog.md +++ b/docs/core/rid-catalog.md @@ -4,7 +4,7 @@ description: .NET Core Runtime IDentifier (RID) catalog keywords: .NET, .NET Core author: blackdwarf manager: wpickett -ms.date: 08/08/2016 +ms.date: 08/22/2016 ms.topic: article ms.prod: .net-core ms.technology: .net-core-technologies