Vytváření aplikací pomocí Microsoft.NETFramework.ReferenceAssemblies

Pokud cílíte na konkrétní verzi rozhraní .NET Framework, vaše aplikace je ve výchozím nastavení sestavena pomocí referenčních sestavení, která jsou součástí sady pro vývojáře této verze. Ve scénářích, kdy se na počítači nedá nainstalovat odpovídající sada pro vývojáře, můžete místo toho sestavit referenční sestavení distribuovaná prostřednictvím balíčku NuGet.

Aktualizace souborů projektu

Každý projekt, který by měl být sestaven proti referenčním sestavením balíčku NuGet, musí obsahovat odkaz na Microsoft.NETFramework.ReferenceAssemblies.

Projekty, které používají souborpackages.config , by měly v packages.configobsahovat následující informace.

<packages>
  <package id="Microsoft.NETFramework.ReferenceAssemblies" version="1.0.3" developmentDependency="true" />
</packages>

Projekty, které používají <PackageReference> vlastnost MSBuild, by měly obsahovat následující vlastnost v souboru projektu.

<ItemGroup>
  <PackageReference Include="Microsoft.NETFramework.ReferenceAssemblies" Version="1.0.3" PrivateAssets="All" />
</ItemGroup>

Projekty ve stylu sady SDK ve výchozím nastavení obsahují tento odkaz. Pro typické projekty rozhraní .NET Framework vytvořené pomocí sady Visual Studio můžete přidat odkaz pomocí uživatelského rozhraní Správce balíčků NuGet v sadě Visual Studio. Balíček obsahuje referenční sestavení pro mnoho verzí rozhraní .NET Framework. Verze, která se skutečně používá, je určena vlastností TargetFrameworkVersion nebo TargetFramework, jak je již definováno v souboru projektu.

Obnovení projektu

Projekty, které obsahují odkaz na balíček, musí být před sestavením obnoveny.

Po přidání balíčku NuGet Microsoft.NETFramework.ReferenceAssemblies do projektu musíte explicitně spustit akci obnovení jedním z následujících způsobů:

• Pokud je váš projekt jiný než projekt ve stylu sady SDK a používá packages.config soubor pro odkazy na balíčky NuGet:

  1. Nainstalujte nástroj NuGet CLI a ujistěte se, že se nuget.exe nachází v PATH proměnné prostředí.
  2. Otevřete příkazový řádek.
  3. Přejděte do adresáře, který obsahuje váš soubor projektu.
  4. Spusťte nuget.exe restore.

• Pokud je váš projekt jiný než projekt ve stylu sady SDK a používá <PackageReference> nastavení v souboru projektu pro odkazy na balíčky NuGet:

  1. Otevřete příkazový řádek pro vývojáře pro VS 2022. Název této aplikace se může lišit podle toho, jakou verzi sady Visual Studio jste nainstalovali.
  2. Přejděte do adresáře, který obsahuje váš soubor projektu.
  3. Spusťte msbuild /t:restore.

• Pokud je projekt ve stylu sady SDK, nemusíte nic dělat. Akce obnovení NuGet se spustí automaticky při sestavení projektu.