Update docs about .NET Core version 2.0 to be about version 2.x (#7467)

This commit is contained in:
Christoph Bergmeister [MVP]
2018-08-30 16:51:52 -07:00
committed by Dongbo Wang
parent 944d716e82
commit b3c961f882
6 changed files with 17 additions and 14 deletions
+2 -2
View File
@@ -3,7 +3,7 @@
This guide supplements the [Linux instructions](./linux.md), as
building on macOS is almost identical.
.NET Core 2.0 (and by transitivity, us) only supports macOS 10.12+.
.NET Core 2.x (and by transitivity, us) only supports macOS 10.12+.
## Environment
@@ -16,7 +16,7 @@ The `Start-PSBootstrap` function does the following:
- Uses `brew` to install CMake, OpenSSL, and GNU WGet
- Uninstalls any prior versions of .NET CLI
- Downloads and installs a preview version of .NET Core SDK 2.0 to `~/.dotnet`
- Downloads and installs .NET Core SDK to `~/.dotnet`
If you want to use `dotnet` outside of `Start-PSBuild`,
add `~/.dotnet` to your `PATH` environment variable.
@@ -23,9 +23,9 @@ different implementations of PowerShell.
to install PowerShell Core for the distribution and version of Linux you're running.
You can get that version info by running the command `lsb_release -a` from the WSL console.
* .NET Core 2.0 SDK
* .NET Core 2.x SDK
Download and install the [.NET Core 2.0 SDK][net-core-sdk] for your operating system.
Download and install the [.NET Core 2.x SDK][net-core-sdk] for your operating system.
It is recommended that you use a package manager to install the SDK on Linux.
See these [instructions][linux-install] on how to install the SDK on Linux.
Be sure to pick your distribution of Linux e.g. RHEL, Debian, etc to get the
@@ -40,7 +40,7 @@ different implementations of PowerShell.
```
This should output `2.0.0` or higher. If it returns a major version of 1, make sure you have
installed the .NET Core 2.0 SDK and have restarted your shell to get the newer version of
installed the .NET Core 2.x SDK and have restarted your shell to get the newer version of
the SDK tools.
1. Use the `dotnet` CLI to create a starter `classlib` project based on .NET Standard 2.0
@@ -114,7 +114,7 @@ different implementations of PowerShell.
## Using a .NET Standard 2.0 based binary module in Windows PowerShell
You may have heard that a .NET assembly compiled as a .NET Standard 2.0 class library
will load into both .NET Core 2.0 applications such as PowerShell Core and
will load into both .NET Core 2.x applications such as PowerShell Core and
.NET Framework 4.6.1 (or higher) applications such as Windows PowerShell.
This allows you to build a single, cross-platform binary module.
@@ -171,14 +171,15 @@ can't find the `netstandard.dll` "implementation" assembly for the version of th
### The fix for missing netstandard.dll
If you install (or already have) the .NET Core 2.0 SDK for Windows, you can
If you install (or already have) the .NET Core SDK for Windows, you can
find the `netstandard.dll` implementation assembly for .NET 4.6.1 in the following directory:
`C:\Program Files\dotnet\sdk\2.0.0\Microsoft\Microsoft.NET.Build.Extensions\net461\lib`.
`C:\Program Files\dotnet\sdk\<version-number>\Microsoft\Microsoft.NET.Build.Extensions\net461\lib`.
Note that, the version number in the path may vary depending on the installed SDK.
If you copy `netstandard.dll` from this directory to the directory containing
`MyModule.dll`, the `Write-TimestampedMessage` command will work. Let's try that.
1. Install the [.NET Core SDK 2.0 for Windows][net-core-sdk], if it isn't already installed.
1. Install [.NET Core SDK for Windows][net-core-sdk], if it isn't already installed.
1. Start a new Windows PowerShell console. Remember that once a binary assembly is
loaded into PowerShell it can't be unloaded. Restarting PowerShell is necessary to
@@ -187,7 +188,7 @@ If you copy `netstandard.dll` from this directory to the directory containing
1. Copy the `netstandard.dll` implementation assembly for .NET 4.6.1 to the module's directory.
```powershell
cd 'path-to-where-you-copied-module.dll'
Copy-Item 'C:\Program Files\dotnet\sdk\2.0.0\Microsoft\Microsoft.NET.Build.Extensions\net461\lib\netstandard.dll' .
Copy-Item 'C:\Program Files\dotnet\sdk\<version-number>\Microsoft\Microsoft.NET.Build.Extensions\net461\lib\netstandard.dll' .
```
1. Import the module and execute the command:
@@ -211,7 +212,7 @@ class library that will run in PowerShell Core on multiple operating systems.
It will also run in Windows PowerShell on Windows systems that have been updated to
.NET Framework 4.7.1 as well as the Windows 10 Fall Creators Update which comes with that
version pre-installed. Furthermore, this binary module can be built on Linux
and macOS as well as Windows using the .NET Core 2.0 SDK command-line tools.
and macOS as well as Windows using the .NET Core 2.x SDK command-line tools.
For more information on .NET Standard, check out the [documentation][net-std-docs]
and the [.NET Standard YouTube channel][net-std-chan].