100 lines
2.9 KiB
Markdown
100 lines
2.9 KiB
Markdown
|
# How to patch dotnet CLI with latest CoreFX
|
||
|
|
|
||
|
|
This document provides the steps necessary to consume a nightly build of CoreFX
|
||
|
|
and CoreCLR.
|
||
|
|
|
||
|
|
Please note that these steps aren't necessary for official builds -- these steps
|
||
|
|
are specific to consuming nightlies and thus unsupported builds. Also note that
|
||
|
|
these steps are likely to change as we're simplifying this experience. Make
|
||
|
|
sure to consult this document often.
|
||
|
|
|
||
|
|
## Install prerequisites
|
||
|
|
|
||
|
|
1. Install CLI 2.0.0-alpha SDK
|
||
|
|
- [Win 64-bit Latest](https://dotnetcli.blob.core.windows.net/dotnet/Sdk/master/dotnet-dev-win-x64.latest.exe)
|
||
|
|
- [macOS 64-bit Latest](https://dotnetcli.blob.core.windows.net/dotnet/Sdk/master/dotnet-dev-osx-x64.latest.pkg)
|
||
|
|
- [Others](https://github.com/dotnet/cli/blob/master/README.md)
|
||
|
|
|
||
|
|
## Setup the project
|
||
|
|
|
||
|
|
1. Create a new project
|
||
|
|
- Creat a new folder for your app
|
||
|
|
- Create project file by running `dotnet new`
|
||
|
|
|
||
|
|
2. Add the CoreFX MyGet feed to your NuGet configuration.
|
||
|
|
- You can do this globally but we recommend not doing this as this might
|
||
|
|
affect other projects on your machine and you probably don't want that.
|
||
|
|
- Instead, add a `nuget.config` that is local to your project. You can
|
||
|
|
just put it next to the `.csproj` file.
|
||
|
|
See the [NuGet docs](https://docs.nuget.org/ndocs/consume-packages/configuring-nuget-behavior)
|
||
|
|
for details.
|
||
|
|
|
||
|
|
```xml
|
||
|
|
<configuration>
|
||
|
|
<packageSources>
|
||
|
|
<add key="CoreFX" value="https://dotnet.myget.org/F/dotnet-core/api/v3/index.json" />
|
||
|
|
</packageSources>
|
||
|
|
</configuration>
|
||
|
|
```
|
||
|
|
|
||
|
|
3. Select the nightly build from our feed
|
||
|
|
- <https://dotnet.myget.org/feed/dotnet-core/package/nuget/Microsoft.NETCore.App>
|
||
|
|
- Presumably you want the latest version.
|
||
|
|
|
||
|
|
In order to consume the latest build, you'll need to update your `.csproj`
|
||
|
|
as follows:
|
||
|
|
|
||
|
|
1. Update `TargetFramework`, add `RuntimeIdentifier` as below (ideally
|
||
|
|
`dotnet.exe` would infer your current architecture but it currently doesn't)
|
||
|
|
2. Update package reference to match version selected above, as below
|
||
|
|
|
||
|
|
```xml
|
||
|
|
<Project Sdk="Microsoft.NET.Sdk" ToolsVersion="15.0">
|
||
|
|
|
||
|
|
<PropertyGroup>
|
||
|
|
<OutputType>Exe</OutputType>
|
||
|
|
<TargetFramework>netcoreapp2.0</TargetFramework>
|
||
|
|
<RuntimeIdentifier>win10-x64</RuntimeIdentifier>
|
||
|
|
</PropertyGroup>
|
||
|
|
|
||
|
|
<!-- Make sure to use Update, not Include! -->
|
||
|
|
<ItemGroup>
|
||
|
|
<PackageReference Update="Microsoft.NETCore.App" Version="2.0.0-beta-001386-00" />
|
||
|
|
</ItemGroup>
|
||
|
|
|
||
|
|
</Project>
|
||
|
|
```
|
||
|
|
|
||
|
|
Restore packages so that you're ready to play:
|
||
|
|
|
||
|
|
```
|
||
|
|
$ dotnet restore
|
||
|
|
```
|
||
|
|
|
||
|
|
## Consume the new build
|
||
|
|
|
||
|
|
Edit your `Program.cs` to consume the new APIs, for example:
|
||
|
|
|
||
|
|
```CSharp
|
||
|
|
using System;
|
||
|
|
using System.Net;
|
||
|
|
|
||
|
|
class Program
|
||
|
|
{
|
||
|
|
static void Main(string[] args)
|
||
|
|
{
|
||
|
|
WebUtility.HtmlDecode("&", Console.Out);
|
||
|
|
Console.WriteLine();
|
||
|
|
Console.WriteLine("Hello World!");
|
||
|
|
}
|
||
|
|
}
|
||
|
|
```
|
||
|
|
|
||
|
|
Run the bits:
|
||
|
|
|
||
|
|
```
|
||
|
|
$ dotnet run
|
||
|
|
```
|
||
|
|
|
||
|
|
Rinse and repeat!
|