147 lines
13 KiB
Markdown
147 lines
13 KiB
Markdown
# .NET Core 2.1.616
|
|
|
|
This .NET Core SDK release includes the following released .NET Core and ASP.NET Core Runtimes.
|
|
|
|
* .NET Core SDK 2.1.616
|
|
* .NET Core Runtime 2.1.23
|
|
* ASP.NET Core 2.1.23
|
|
|
|
See the [Release Notes](https://github.com/dotnet/core/blob/master/release-notes/2.1/2.1.23/2.1.23.md) for details about what is included in this update.
|
|
|
|
## Downloads
|
|
|
|
| | SDK Installer<sup>1</sup> | SDK Binaries<sup>1</sup> | Runtime Installer | Runtime Binaries | ASP.NET Core Runtime |
|
|
| --------- | :------------------------------------------: | :----------------------: | :---------------------------: | :-------------------------: | :-----------------: |
|
|
| Windows | [x86][dotnet-sdk-win-x86.exe] \| [x64][dotnet-sdk-win-x64.exe] | [x86][dotnet-sdk-win-x86.zip] \| [x64][dotnet-sdk-win-x64.zip] | [x86][dotnet-runtime-win-x86.exe] \| [x64][dotnet-runtime-win-x64.exe] | [x86][dotnet-runtime-win-x86.zip] \| [x64][dotnet-runtime-win-x64.zip] \| [ARM][dotnet-runtime-win-arm.zip] | [x86][aspnetcore-runtime-win-x86.exe] \| [x64][aspnetcore-runtime-win-x64.exe] \| <br> [Hosting Bundle][dotnet-hosting-win.exe]<sup>2</sup> |
|
|
| macOS | [x64][dotnet-sdk-osx-x64.pkg] | [x64][dotnet-sdk-osx-x64.tar.gz] | [x64][dotnet-runtime-osx-x64.pkg] | [x64][dotnet-runtime-osx-x64.tar.gz] | [x64][aspnetcore-runtime-osx-x64.tar.gz]<sup>1</sup>
|
|
| Linux | [See installation steps][linux-setup] | [x64][dotnet-sdk-linux-x64.tar.gz] \| [ARM][dotnet-sdk-linux-arm.tar.gz] \| [ARM64][dotnet-sdk-linux-arm64.tar.gz] \| [x64 Alpine][dotnet-sdk-linux-musl-x64.tar.gz] | - | [x64][dotnet-runtime-linux-x64.tar.gz] \| [ARM][dotnet-runtime-linux-arm.tar.gz] \| [ARM64][dotnet-runtime-linux-arm64.tar.gz] \| [x64 Alpine][dotnet-runtime-linux-musl-x64.tar.gz] | [x64][aspnetcore-runtime-linux-x64.tar.gz]<sup>1</sup> \| [ARM][aspnetcore-runtime-linux-arm.tar.gz]<sup>1</sup> \| [x64 Alpine][aspnetcore-runtime-linux-musl-x64.tar.gz]<sup>1</sup> |
|
|
| RHEL6 | - | [x64][dotnet-sdk-rhel.6-x64.tar.gz] | - | [x64][dotnet-runtime-rhel.6-x64.tar.gz] | - |
|
|
| Checksums | [SDK][checksums-sdk] | - | [Runtime][checksums-runtime] | - | - |
|
|
|
|
1. Includes the .NET Core and ASP.NET Core Runtimes
|
|
2. For hosting standalone apps on Windows Servers. Includes the ASP.NET Core Module for IIS and can be installed separately on servers without installing .NET Core runtime.
|
|
|
|
## Visual Studio Compatibility
|
|
|
|
This update for .NET Core 2.1 includes multiple SDK builds. If you are a Visual Studio 2019, Visual Studio 2017 or Visual Studio for Mac user, there are MSBuild version requirements that are satisfied by specific, matching .NET Core SDK versions. See the table below to select the correct download.
|
|
|
|
| OS | Development Environment | .NET Core SDK |
|
|
| :-- | :-- | :--: |
|
|
| Windows | Visual Studio 2019 version 16.0 | [2.1.616](#downloads) |
|
|
| Windows | Visual Studio 2017 | [2.1.519](2.1.23.md) |
|
|
| macOS | Visual Studio for Mac | [Visual Studio for Mac .NET Core Support](https://docs.microsoft.com/visualstudio/mac/net-core-support) |
|
|
|
|
|
|
## Docker
|
|
|
|
The [.NET Core Docker images](https://hub.docker.com/_/microsoft-dotnet) have been updated for this release. The [.NET Docker samples](https://github.com/dotnet/dotnet-docker/blob/master/samples/README.md) show various ways to use .NET and Docker together.
|
|
|
|
## Installing .NET Core on Linux
|
|
|
|
### Install using a Package Manager
|
|
|
|
Before installing .NET, you need to register the Microsoft key, register the product repository, and install required dependencies. This only needs to be done once per machine. Refer to [Setting up Linux for .NET Core][linux-setup] for the requirements.
|
|
|
|
The following commands don't specifically include package managers to help with readability. Here are the package managers typically used by the distros on which .NET Core is supported.
|
|
|
|
| Distro | Package Manager |
|
|
| --- | :----: |
|
|
| CentOS, Oracle | yum |
|
|
| Debian, Ubuntu | apt-get |
|
|
| Fedora | dnf |
|
|
| OpenSUSE, SLES | zypper |
|
|
|
|
## Develop applications
|
|
|
|
To develop applications using the .NET Core SDK, run the following command. The .NET Core and ASP.NET Core runtimes are included.
|
|
|
|
```bash
|
|
sudo [package manager] update or refresh
|
|
sudo [package manager] install dotnet-sdk-2.1
|
|
```
|
|
|
|
## Run applications
|
|
|
|
If you only need to run existing applications, run the following command. The .NET Core and ASP.NET Core runtimes are included.
|
|
|
|
```bash
|
|
sudo [package manager] update or refresh
|
|
sudo [package manager] install aspnetcore-runtime-2.1
|
|
```
|
|
|
|
### Installation from a binary archive
|
|
|
|
Installing from the packages detailed above is recommended or you can install from binary archive, if that better suits your needs. When using binary archives to install, the contents must be extracted to a user location such as `$HOME/dotnet`, a symbolic link created for `dotnet` and a few dependencies installed. Dependency requirements can be seen in the [Linux System Prerequisites](https://github.com/dotnet/core/blob/master/Documentation/linux-prereqs.md) document.
|
|
|
|
```bash
|
|
mkdir -p $HOME/dotnet && tar zxf dotnet.tar.gz -C $HOME/dotnet
|
|
export PATH=$PATH:$HOME/dotnet
|
|
```
|
|
|
|
## .NET Core Runtime-only installation
|
|
|
|
If only the .NET Core Runtime is needed, install `dotnet-runtime-2.1` using your package manager. If you also need ASP.NET Core functionality, installing `aspnetcore-runtime-2.1` will install both the ASP.NET Core Runtime and .NET Core Runtime.
|
|
|
|
## Windows Server Hosting
|
|
|
|
If you're looking to host standalone apps on servers, the following installer can be used on Windows systems.
|
|
|
|
### Windows
|
|
|
|
You can download the Windows Server Hosting installer and run the following command from an Administrator command prompt:
|
|
|
|
* [dotnet-hosting-2.1.23-win.exe][dotnet-hosting-win.exe]
|
|
|
|
This will install the ASP.NET Core Module for IIS.
|
|
|
|
[blob-runtime]: https://dotnetcli.blob.core.windows.net/dotnet/Runtime/
|
|
[blob-sdk]: https://dotnetcli.blob.core.windows.net/dotnet/Sdk/
|
|
[release-notes]: https://github.com/dotnet/core/blob/master/release-notes/2.1/2.1.23/2.1.23.md
|
|
|
|
[checksums-runtime]: https://dotnetcli.blob.core.windows.net/dotnet/checksums/2.1.23-sha.txt
|
|
[checksums-sdk]: https://dotnetcli.blob.core.windows.net/dotnet/checksums/2.1.23-sha.txt
|
|
|
|
[linux-install]: https://www.microsoft.com/net/download/linux
|
|
[linux-setup]: https://docs.microsoft.com/dotnet/core/install/
|
|
|
|
|
|
|
|
|
|
[//]: # ( Runtime 2.1.23)
|
|
[dotnet-runtime-linux-arm.tar.gz]: https://download.visualstudio.microsoft.com/download/pr/e0d4bf96-e481-4c16-a2dc-69f002f2f892/ee8457bcbfae80bb4e76efe04f5bd3e2/dotnet-runtime-2.1.23-linux-arm.tar.gz
|
|
[dotnet-runtime-linux-arm64.tar.gz]: https://download.visualstudio.microsoft.com/download/pr/832a703f-ca7e-4fa5-8b8d-bc87d6cbf4f0/15d78d838a2173d470c2e9a97b0c7b63/dotnet-runtime-2.1.23-linux-arm64.tar.gz
|
|
[dotnet-runtime-linux-musl-x64.tar.gz]: https://download.visualstudio.microsoft.com/download/pr/1693393c-e916-497d-ab55-304be84f75d6/aca7f9d2befdec0b26373510eddf51bb/dotnet-runtime-2.1.23-linux-musl-x64.tar.gz
|
|
[dotnet-runtime-linux-x64.tar.gz]: https://download.visualstudio.microsoft.com/download/pr/e52a08ae-0a98-4dbf-b371-bf50815ae05a/48e4eb969aee8df978fa2f32b743ae76/dotnet-runtime-2.1.23-linux-x64.tar.gz
|
|
[dotnet-runtime-osx-x64.pkg]: https://download.visualstudio.microsoft.com/download/pr/8cd129d5-207f-4cfd-a5fb-5f2c56ee81c0/824ed5222546398bc90b586b402c0324/dotnet-runtime-2.1.23-osx-x64.pkg
|
|
[dotnet-runtime-osx-x64.tar.gz]: https://download.visualstudio.microsoft.com/download/pr/2d6c0e87-ed74-4a83-939a-3bc752a442b3/f989f900d202e949b0fba3a2afc442f5/dotnet-runtime-2.1.23-osx-x64.tar.gz
|
|
[dotnet-runtime-rhel.6-x64.tar.gz]: https://download.visualstudio.microsoft.com/download/pr/5e391c65-0174-4ce6-8fbc-254fb4cbc567/2cfabd8d9a8f46ab32084ceb0d2ebf37/dotnet-runtime-2.1.23-rhel.6-x64.tar.gz
|
|
[dotnet-runtime-win-arm.zip]: https://download.visualstudio.microsoft.com/download/pr/35d8cc1b-4cd0-49b9-bd9f-9d4183842d3e/a91ceb48d8716bd600619dd8eb5a784e/dotnet-runtime-2.1.23-win-arm.zip
|
|
[dotnet-runtime-win-x64.exe]: https://download.visualstudio.microsoft.com/download/pr/b6dd738b-bb15-448a-86cd-e8cf96138a06/0b0ad58041510ca8ed00957764b37c13/dotnet-runtime-2.1.23-win-x64.exe
|
|
[dotnet-runtime-win-x64.zip]: https://download.visualstudio.microsoft.com/download/pr/75a5ff0b-f69f-4364-b922-60e2dbe562e2/823dfb5bab4dadf9ca9b698e191d0a81/dotnet-runtime-2.1.23-win-x64.zip
|
|
[dotnet-runtime-win-x86.exe]: https://download.visualstudio.microsoft.com/download/pr/d5f6d9c8-7634-4b44-80e1-6e07670c08df/53aae9018e45a5c3e2a0ff503ec8c4af/dotnet-runtime-2.1.23-win-x86.exe
|
|
[dotnet-runtime-win-x86.zip]: https://download.visualstudio.microsoft.com/download/pr/c4fa76ed-1afe-4902-8ef9-2b4768e84202/1e239ee5c1de03a712ae57ab3184f2e9/dotnet-runtime-2.1.23-win-x86.zip
|
|
|
|
[//]: # ( ASP 2.1.23)
|
|
[aspnetcore-runtime-linux-arm.tar.gz]: https://download.visualstudio.microsoft.com/download/pr/73592379-5553-461d-9472-f54688488955/74bc7c5a34487da9447b9544679566c1/aspnetcore-runtime-2.1.23-linux-arm.tar.gz
|
|
[aspnetcore-runtime-linux-musl-x64.tar.gz]: https://download.visualstudio.microsoft.com/download/pr/3c881d8d-bae5-4f70-adf9-278d7c0d3ea1/c5d707365e2b84d3cf97d68211592300/aspnetcore-runtime-2.1.23-linux-musl-x64.tar.gz
|
|
[aspnetcore-runtime-linux-x64.tar.gz]: https://download.visualstudio.microsoft.com/download/pr/3422a123-3f37-4544-b0ed-e3922b50e1b0/c34c607ba18a67763bacded434607c56/aspnetcore-runtime-2.1.23-linux-x64.tar.gz
|
|
[aspnetcore-runtime-osx-x64.tar.gz]: https://download.visualstudio.microsoft.com/download/pr/6469b602-063e-4296-a446-57a00845d542/45e3896844149e1109661d89f2ee12ab/aspnetcore-runtime-2.1.23-osx-x64.tar.gz
|
|
[aspnetcore-runtime-win-x64.exe]: https://download.visualstudio.microsoft.com/download/pr/7464f6c4-0d39-470b-824d-50ffb3825b33/2d6b1e085f5429413d9fb7e42632f5b1/aspnetcore-runtime-2.1.23-win-x64.exe
|
|
[aspnetcore-runtime-win-x64.zip]: https://download.visualstudio.microsoft.com/download/pr/c1907d59-03d9-4f47-a3e6-640720010103/fcb027da4bc9ba076fbe7c7cb1a2690b/aspnetcore-runtime-2.1.23-win-x64.zip
|
|
[aspnetcore-runtime-win-x86.exe]: https://download.visualstudio.microsoft.com/download/pr/175fcf7f-3cc3-413f-afa2-2c7f1b6357a8/55e778aa29242f4b8cee9e40eeb43605/aspnetcore-runtime-2.1.23-win-x86.exe
|
|
[aspnetcore-runtime-win-x86.zip]: https://download.visualstudio.microsoft.com/download/pr/9b97a12c-818c-485c-8ebd-cc7d132ce5b0/6fe7f407e019364da2d3458e88d9c5fc/aspnetcore-runtime-2.1.23-win-x86.zip
|
|
[dotnet-hosting-win.exe]: https://download.visualstudio.microsoft.com/download/pr/3e3c37fb-4d77-4558-a78c-17434e1cc804/60116643f610fb43f858af4e0dc1b223/dotnet-hosting-2.1.23-win.exe
|
|
|
|
[//]: # ( SDK 2.1.616 )
|
|
[dotnet-sdk-linux-arm.tar.gz]: https://download.visualstudio.microsoft.com/download/pr/e8878e38-dc3b-4c11-824d-724df90ca7d9/82e0b5e99e8649cd01117bb73ebfa4b0/dotnet-sdk-2.1.616-linux-arm.tar.gz
|
|
[dotnet-sdk-linux-arm64.tar.gz]: https://download.visualstudio.microsoft.com/download/pr/53655ad3-2ff0-4511-bf53-1765dee4abd7/b48541a1f44f120fe7c4d4a6a2952940/dotnet-sdk-2.1.616-linux-arm64.tar.gz
|
|
[dotnet-sdk-linux-musl-x64.tar.gz]: https://download.visualstudio.microsoft.com/download/pr/005b9d2b-c1fd-4ea0-b3f0-571f1a0a3aaa/524a97c0acfab53a667ea6ddbf246dcb/dotnet-sdk-2.1.616-linux-musl-x64.tar.gz
|
|
[dotnet-sdk-linux-x64.tar.gz]: https://download.visualstudio.microsoft.com/download/pr/b30af3d2-2123-40fa-a4da-133d2d5c46a2/dd8276dd5a05678cbc2a9742a1495887/dotnet-sdk-2.1.616-linux-x64.tar.gz
|
|
[dotnet-sdk-osx-x64.pkg]: https://download.visualstudio.microsoft.com/download/pr/a2272bb1-1dbc-4349-a4ac-bc0de031a9cf/f8f848ae7479b6dda97efff4a65392ad/dotnet-sdk-2.1.616-osx-x64.pkg
|
|
[dotnet-sdk-osx-x64.tar.gz]: https://download.visualstudio.microsoft.com/download/pr/e235fc4e-9618-49c6-93d9-b5f24c8ee8c5/c9e21fc5d6eff93e49642793e8494c76/dotnet-sdk-2.1.616-osx-x64.tar.gz
|
|
[dotnet-sdk-rhel.6-x64.tar.gz]: https://download.visualstudio.microsoft.com/download/pr/793a6c09-f490-45ff-8241-e8f1ca1088cc/b9b79ed61687404b0acfcab794bb1d3d/dotnet-sdk-2.1.616-rhel.6-x64.tar.gz
|
|
[dotnet-sdk-win-x64.exe]: https://download.visualstudio.microsoft.com/download/pr/4c566a24-cd33-46b6-8069-de2914c99a61/2d1acdf57d455bab980bb4accf9e13c2/dotnet-sdk-2.1.616-win-x64.exe
|
|
[dotnet-sdk-win-x64.zip]: https://download.visualstudio.microsoft.com/download/pr/d8d4b648-2e34-49ff-967d-5832d9c7a7c9/dbc991d0cc3cd824656400d63fa75e79/dotnet-sdk-2.1.616-win-x64.zip
|
|
[dotnet-sdk-win-x86.exe]: https://download.visualstudio.microsoft.com/download/pr/d0d7cb42-401c-4f7e-b53c-002f274ee67c/07932da76e6013dca00a1da2446ff0fc/dotnet-sdk-2.1.616-win-x86.exe
|
|
[dotnet-sdk-win-x86.zip]: https://download.visualstudio.microsoft.com/download/pr/bf0d3e3f-4bee-452c-bb8c-a677460b249b/804a2ae250bd26f9d417bd8d5da64705/dotnet-sdk-2.1.616-win-x86.zip
|