Skip to content

Commit cb2e83b

Browse files
authored
updated netstandard version (#1169)
1 parent 9276eab commit cb2e83b

File tree

2 files changed

+13
-11
lines changed

2 files changed

+13
-11
lines changed

docs/core/migrating-from-dnx.md

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3,6 +3,7 @@ title: Migrating from DNX to .NET Core CLI
33
description: Migrating from DNX to .NET Core CLI
44
keywords: .NET, .NET Core
55
author: blackdwarf
6+
ms.author: mairaw
67
manager: wpickett
78
ms.date: 06/20/2016
89
ms.topic: article
@@ -160,7 +161,7 @@ and the changes that the new [.NET Standard Library](https://github.com/dotnet/c
160161
brought, the framework needs to be one of the following:
161162

162163
1. `netcoreapp1.0` - if you are writing applications on .NET Core (including ASP.NET Core applications)
163-
2. `netstandard1.5` - if you are writing class libraries for .NET Core
164+
2. `netstandard1.6` - if you are writing class libraries for .NET Core
164165

165166
If you are using other `dnx` targets, like `dnx451` you will need to change those as well. `dnx451` should be changed to `net451`.
166167
Please refer to the [.NET Standard Library document](https://github.com/dotnet/corefx/blob/master/Documentation/architecture/net-platform-standard.md)

docs/core/packages.md

Lines changed: 11 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -3,6 +3,7 @@ title: Packages, Metapackages and Frameworks
33
description: Packages, Metapackages and Frameworks
44
keywords: .NET, .NET Core
55
author: richlander
6+
ms.author: mairaw
67
manager: wpickett
78
ms.date: 06/20/2016
89
ms.topic: article
@@ -49,7 +50,7 @@ Packages are referenced in project.json. In the example below, the [System.Runti
4950
"System.Runtime": "4.1.0"
5051
},
5152
"frameworks": {
52-
"netstandard1.5": {}
53+
"netstandard1.6": {}
5354
}
5455
}
5556
```
@@ -87,10 +88,10 @@ In the following example, the `NETStandard.Library` meta package is referenced,
8788
```json
8889
{
8990
"dependencies": {
90-
"NETStandard.Library": "1.5.0"
91+
"NETStandard.Library": "1.6.0"
9192
},
9293
"frameworks": {
93-
"netstandard1.5": {}
94+
"netstandard1.6": {}
9495
}
9596
}
9697
```
@@ -147,15 +148,15 @@ The .NET Standard (TFM: `netstandard`) framework represents the APIs defined by
147148

148149
The `NETStandard.Library` metapackage targets the `netstandard` framework. The most common way to target `netstandard` is by referencing this metapackage. It describes and provides access to the ~40 .NET libraries and associated APIs that define the .NET Standard Library. You can reference additional packages that target `netstandard` to get access to additional APIs.
149150

150-
A given [NETStandard.Library version](versions/index.md) matches the highest `netstandard` version it exposed (via its closure). The framework reference in project.json is used to select the correct assets from the underlying packages. In this case, `netstandard1.5` assets are required, as opposed to `netstandard1.4` or `net46`, for example.
151+
A given [NETStandard.Library version](versions/index.md) matches the highest `netstandard` version it exposed (via its closure). The framework reference in project.json is used to select the correct assets from the underlying packages. In this case, `netstandard1.6` assets are required, as opposed to `netstandard1.4` or `net46`, for example.
151152

152153
```json
153154
{
154155
"dependencies": {
155-
"NETStandard.Library": "1.5.0"
156+
"NETStandard.Library": "1.6.0"
156157
},
157158
"frameworks": {
158-
"netstandard1.5": {}
159+
"netstandard1.6": {}
159160
}
160161
}
161162
```
@@ -165,22 +166,22 @@ The framework and metapackage references in project.json do not need to match. F
165166
```json
166167
{
167168
"dependencies": {
168-
"NETStandard.Library": "1.5.0"
169+
"NETStandard.Library": "1.6.0"
169170
},
170171
"frameworks": {
171172
"netstandard1.3": {}
172173
}
173174
}
174175
```
175176

176-
It may seem strange to target `netstandard1.3` but use the 1.5.0 version of `NETStandard.Library`. It is a valid use-case, since the metapackage maintains support for older `netstandard` versions. It could be the case you've standardized on the 1.5.0 version of the metapackage and use it for all your libraries, which target a variety of `netstandard` versions. With this approach, you only need to restore `NETStandard.Library` 1.5.0 and not earlier versions.
177+
It may seem strange to target `netstandard1.3` but use the 1.6.0 version of `NETStandard.Library`. It is a valid use-case, since the metapackage maintains support for older `netstandard` versions. It could be the case you've standardized on the 1.6.0 version of the metapackage and use it for all your libraries, which target a variety of `netstandard` versions. With this approach, you only need to restore `NETStandard.Library` 1.6.0 and not earlier versions.
177178

178-
The reverse would not be valid: targeting `netstandard1.5` with the 1.3.0 version of `NETStandard.Library`. You cannot target a higher framework with a lower metapackage, since the lower version metapackage will not expose any assets for that higher framework. The [versioning scheme] for metapackages asserts that metapackages match the highest version of the framework they describe. By virtue of the versioning scheme, the first version of `NETStandard.Library` is v1.5.0 given that it contains `netstandard1.5` assets. v1.3.0 is used in the example above, for symmetry with the example above, but does not actually exist.
179+
The reverse would not be valid: targeting `netstandard1.6` with the 1.3.0 version of `NETStandard.Library`. You cannot target a higher framework with a lower metapackage, since the lower version metapackage will not expose any assets for that higher framework. The [versioning scheme] for metapackages asserts that metapackages match the highest version of the framework they describe. By virtue of the versioning scheme, the first version of `NETStandard.Library` is v1.6.0 given that it contains `netstandard1.6` assets. v1.3.0 is used in the example above, for symmetry with the example above, but does not actually exist.
179180

180181
### .NET Core Application
181182

182183
The .NET Core Application (TFM: `netcoreapp`) framework represents the packages and associated APIs that come with the .NET Core distribution and the console application model that it provides. .NET Core apps must use this framework, due to targeting the console application model, as should libraries that intended to run only on .NET Core. Using this framework restricts apps and libraries to running only on .NET Core.
183184

184185
The `Microsoft.NETCore.App` metapackage targets the `netcoreapp` framework. It provides access to ~60 libraries, ~40 provided by the `NETStandard.Library` package and ~20 more in addition. You can reference additional libraries that target `netcoreapp` or compatible frameworks, such as `netstandard`, to get access to additional APIs.
185186

186-
Most of the additional libraries provided by `Microsoft.NETCore.App` also target `netstandard` given that their dependencies are satisfied by other `netstandard` libraries. That means that `netstandard` libraries can also reference those packages as dependencies.
187+
Most of the additional libraries provided by `Microsoft.NETCore.App` also target `netstandard` given that their dependencies are satisfied by other `netstandard` libraries. That means that `netstandard` libraries can also reference those packages as dependencies.

0 commit comments

Comments
 (0)