dotnet/releases/reference-assemblies

.NET Framework Targeting Pack Nuget Packages (Preview)

These packages enable building .NET Framework projects on any machine with at least MSBuild or the .NET Core SDK installed.

The following scenarios and benefits are enabled for .NET Framework projects:

• Build without requiring admin operations to install pre-requisites such as Visual Studio or .NET Framework targeting packs.
• Build libraries on any operating system supported by the .NET Core SDK.
• Build Mono-based projects.

Status

Early preview.

Usage

At the moment, packages are located on a non-default package feed. Until packages are moved to the default package feed, a change in your project's NuGet.Config file is needed. Add the following line to <packageSources> section:

<add key="roslyn-tools" value="https://dotnet.myget.org/f/roslyn-tools/api/v3/index.json" />

Sample NuGet.Config file:

<?xml version="1.0" encoding="utf-8"?>
<configuration>
<packageSources>
    <add key="roslyn-tools" value="https://dotnet.myget.org/f/roslyn-tools/api/v3/index.json" />
</packageSources>
</configuration>

Make the following changes based on the type of project you are using.

.NET Core project

This sample uses a multi-targeting ClassLibrary project, that can be created using dotnet new classlib. Add or modify NuGet.config file as described above.

Change TargetFramework property to TargetFrameworks and add a new .NET Framework target, like in the following example:

<TargetFrameworks>netstandard2.0;net472</TargetFrameworks>

Add Package reference:

<ItemGroup Condition=" '$(TargetFramework)' == 'net472' ">
  <PackageReference Include="Microsoft.NETFramework.ReferenceAssemblies" Version="1.0.0-alpha-5" />
</ItemGroup>

Build as usual:

dotnet build

SDK-style project

Add the TargetFramework property and a PackageReference like in the following example csproj file:

<Project Sdk="Microsoft.NET.Sdk">

  <PropertyGroup>
    <OutputType>Exe</OutputType>
    <TargetFramework>net472</TargetFramework>
  </PropertyGroup>
  <ItemGroup>
    <PackageReference Include="Microsoft.NETFramework.ReferenceAssemblies" Version="1.0.0-alpha-5" />
  </ItemGroup>

</Project>

Classic-style project

1. Add PackageReference to your csproj file, the same way as in the SDK-style sample above.

2. Add or modify the TargetFrameworkVersion property in your csproj file:

<TargetFrameworkVersion>v4.7.2</TargetFrameworkVersion>

Building your .NET Framework (SDK and Classic) project

1. Restore NuGet packages:

msbuild /t:restore

2. Build the project:

msbuild

Package location

https://dotnet.myget.org/feed/roslyn-tools/package/nuget/Microsoft.NETFramework.ReferenceAssemblies

Latest release

Version: 1.0.0-alpha-5

Date: Tue, 04 Dec 2018 00:13:27 GMT