From 5ee341c5e44fb06efaedc3c54b4638f90e77b843 Mon Sep 17 00:00:00 2001 From: FreddyD-GH <12990709+FreddyD-GH@users.noreply.github.com> Date: Sat, 28 Mar 2020 10:50:01 -0400 Subject: [PATCH 1/4] Update README.md --- README.md | 1 + 1 file changed, 1 insertion(+) diff --git a/README.md b/README.md index 5d7523c0e54222..43f578f8a54e98 100644 --- a/README.md +++ b/README.md @@ -24,6 +24,7 @@ We welcome contributions! Many people all over the world have helped make this p * [Contributing](CONTRIBUTING.md) explains what kinds of changes we welcome - [Workflow Instructions](docs/workflow/README.md) explains how to build and test +* Try the latest versions of libraries from the [nightly build package feed](https://dnceng.pkgs.visualstudio.com/public/_packaging/dotnet5/nuget/v3/index.json) and test them in your projects. ## Reporting security issues and security bugs From 16988b0ea79f28dc9a1314d6943f7d26a5cee3cf Mon Sep 17 00:00:00 2001 From: FreddyD-GH <12990709+FreddyD-GH@users.noreply.github.com> Date: Sat, 28 Mar 2020 14:37:27 -0400 Subject: [PATCH 2/4] Update homepage and add section to dogfooding * Link homepage to existing dogfooding.md page * Add section for Obtaining nightly builds of NuGet packages --- README.md | 2 +- docs/project/dogfooding.md | 21 ++++++++++++++++++++- 2 files changed, 21 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index 43f578f8a54e98..3c4b5583853e06 100644 --- a/README.md +++ b/README.md @@ -24,7 +24,7 @@ We welcome contributions! Many people all over the world have helped make this p * [Contributing](CONTRIBUTING.md) explains what kinds of changes we welcome - [Workflow Instructions](docs/workflow/README.md) explains how to build and test -* Try the latest versions of libraries from the [nightly build package feed](https://dnceng.pkgs.visualstudio.com/public/_packaging/dotnet5/nuget/v3/index.json) and test them in your projects. +* [Get Up and Running on .NET Core](docs/project/dogfooding.md) explains how to get nightly builds of the runtime and its libraries to test them in your own projects. ## Reporting security issues and security bugs diff --git a/docs/project/dogfooding.md b/docs/project/dogfooding.md index a603dc0bbe1fed..c705a5f1aea0dd 100644 --- a/docs/project/dogfooding.md +++ b/docs/project/dogfooding.md @@ -6,6 +6,23 @@ This document provides the steps necessary to consume a nightly build of Please note that these steps are likely to change as we're simplifying this experience. Make sure to consult this document often. +## Obtaining nightly builds of NuGet packages + +If you are only looking to get fixes for an individual NuGet package, and don't need a preview version of the entire runtime, you can add the following package feed to `NuGet.config`: + +**MSFT TODO:** Someone at Microsoft should confirm if any other feeds might be needed here + +```xml + + + ... + +``` + +(Documentation for configuring feeds is [here](https://docs.microsoft.com/en-us/nuget/consume-packages/configuring-nuget-behavior).) + +To use nightly builds of the entire runtime, follow the steps given in the rest of this document instead. + ## Install prerequisites 1. Acquire the latest nightly .NET Core SDK by downloading the zip or tarball listed in https://github.com/dotnet/core-sdk#installers-and-binaries (for example, https://dotnetcli.blob.core.windows.net/dotnet/Sdk/master/dotnet-sdk-latest-win-x64.zip ) into a new folder, for instance `C:\dotnet`. @@ -44,7 +61,9 @@ To install additional .NET Core runtimes or SDKs: https://aka.ms/dotnet-download ``` -4. Our nightly builds are uploaded to dotnet-blob feeds, not NuGet - so ensure the .NET Core blob feed is in your nuget configuration in case you need other packages from .NET Core that aren't included in the download. For example, on Windows you could edit `%userprofile%\appdata\roaming\nuget\nuget.config` or on Linux edit `~/.nuget/NuGet/NuGet.Config` to add these line: +4. Our nightly builds are uploaded to dotnet-blob feeds, not NuGet - so ensure the .NET Core blob feed is in your nuget configuration in case you need other packages from .NET Core that aren't included in the download. For example, on Windows you could edit `%userprofile%\appdata\roaming\nuget\nuget.config` or on Linux edit `~/.nuget/NuGet/NuGet.Config` to add these lines: + +**MSFT TODO:** Someone at Microsoft should update these to make sure they are not outdated ```xml From e9a56aafb90399b4def9d406fbe7dd22de0236af Mon Sep 17 00:00:00 2001 From: FreddyD-GH <12990709+FreddyD-GH@users.noreply.github.com> Date: Sat, 28 Mar 2020 16:51:38 -0400 Subject: [PATCH 3/4] Incorporate dotnet CLI commands --- docs/project/dogfooding.md | 31 +++++++++++++++---------------- 1 file changed, 15 insertions(+), 16 deletions(-) diff --git a/docs/project/dogfooding.md b/docs/project/dogfooding.md index c705a5f1aea0dd..9582ca4719d400 100644 --- a/docs/project/dogfooding.md +++ b/docs/project/dogfooding.md @@ -8,18 +8,24 @@ this experience. Make sure to consult this document often. ## Obtaining nightly builds of NuGet packages -If you are only looking to get fixes for an individual NuGet package, and don't need a preview version of the entire runtime, you can add the following package feed to `NuGet.config`: +If you are only looking to get fixes for an individual NuGet package, and don't need a preview version of the entire runtime, you can add the nightly build package feed to your `NuGet.config` file. The easiest way to do this is by using the dotnet CLI: -**MSFT TODO:** Someone at Microsoft should confirm if any other feeds might be needed here +**(Recommended)** Create a local NuGet.Config file for your solution, if don't already have one. Using a local NuGet.Config file will enable the nightly feed as a package source for projects in the current directory only. +``` +dotnet new nugetconfig +``` -```xml - - - ... - +Next, add the package source to NuGet.Config with the [dotnet nuget add source](https://docs.microsoft.com/en-us/dotnet/core/tools/dotnet-nuget-add-source) command: +``` +dotnet nuget add source -n dotnet5 https://dnceng.pkgs.visualstudio.com/public/_packaging/dotnet5/nuget/v3/index.json ``` -(Documentation for configuring feeds is [here](https://docs.microsoft.com/en-us/nuget/consume-packages/configuring-nuget-behavior).) +Then, you will be able to add the latest prerelease version of the desired package to your project. + +**Example:** To add version 5.0.0-preview.1.20120.5 of the System.Data.OleDb package, use the [dotnet add package](https://docs.microsoft.com/en-us/dotnet/core/tools/dotnet-add-package) command: +``` +dotnet add package System.Data.OleDb -v 5.0.0-preview.1.20120.5 +``` To use nightly builds of the entire runtime, follow the steps given in the rest of this document instead. @@ -63,15 +69,9 @@ To install additional .NET Core runtimes or SDKs: 4. Our nightly builds are uploaded to dotnet-blob feeds, not NuGet - so ensure the .NET Core blob feed is in your nuget configuration in case you need other packages from .NET Core that aren't included in the download. For example, on Windows you could edit `%userprofile%\appdata\roaming\nuget\nuget.config` or on Linux edit `~/.nuget/NuGet/NuGet.Config` to add these lines: -**MSFT TODO:** Someone at Microsoft should update these to make sure they are not outdated ```xml - - - - - - + ... @@ -246,4 +246,3 @@ windows (on Linux substitute ~/ for %HOMEPATH%) you could delete %HOMEPATH%\.nuget\packages\runtime.win-x64.microsoft.private.corefx.netcoreapp\4.6.0-dev.18626.1 ``` which should make `dotnet restore` now pick up the new copy. - From 2c2fec402a2367fac0f331a6ada2094fd351a7e2 Mon Sep 17 00:00:00 2001 From: FreddyD-GH <12990709+FreddyD-GH@users.noreply.github.com> Date: Sat, 28 Mar 2020 16:52:45 -0400 Subject: [PATCH 4/4] Remove extra line break --- docs/project/dogfooding.md | 1 - 1 file changed, 1 deletion(-) diff --git a/docs/project/dogfooding.md b/docs/project/dogfooding.md index 9582ca4719d400..971bb0cc6c1c7b 100644 --- a/docs/project/dogfooding.md +++ b/docs/project/dogfooding.md @@ -68,7 +68,6 @@ To install additional .NET Core runtimes or SDKs: ``` 4. Our nightly builds are uploaded to dotnet-blob feeds, not NuGet - so ensure the .NET Core blob feed is in your nuget configuration in case you need other packages from .NET Core that aren't included in the download. For example, on Windows you could edit `%userprofile%\appdata\roaming\nuget\nuget.config` or on Linux edit `~/.nuget/NuGet/NuGet.Config` to add these lines: - ```xml