Настройка проектов для целевых платформ

Целевые платформы, конфигурируемые с помощью Configuration Manager

Configuration Manager предоставляет способ быстрого добавления новой платформы в целевой объект проекта. При выборе одной из платформ, включенных в Visual Studio, настройка настраивается для создания проекта для выбранной платформы.

Целевые платформы в пользовательском интерфейсе конструктора проектов или свойств проекта

Пользовательский интерфейс конструктора проектов или свойств проекта также предоставляет способ нацеливать различные платформы в проекте. Если выбор одной из платформ, включенных в список в диалоговом окне "Новая платформа решения ", не работает для решения, можно создать пользовательское имя конфигурации и изменить параметры в свойствах проекта , чтобы нацелиться на правильную платформу.

Выполнение этой задачи зависит от используемого языка программирования. Дополнительные сведения см. по следующим ссылкам:

• Сведения о проектах Visual Basic см. в разделе /platform (Visual Basic).

• Сведения о проектах C# см. на странице сборки в конструкторе проектов (C#).

Предпочитать 32-разрядный параметр

Параметр "Предпочитать 32-разрядную " на странице "Сборка " конструктора проектов для .NET Framework 4.5 или более поздних версий обрабатывает ситуацию, когда вы создаете AnyCPU конфигурацию, но требуется, чтобы приложение выполнялось в 32-разрядном режиме при выполнении на платформах, поддерживающих как 32-разрядные, так и 64-разрядные режимы. Если вы установите флажок, для свойства сборки PlatformTarget будет установлено значение anycpu32bitpreferred. См. комментарии по PlatformTarget для C# и /platform для Visual Basic.

Редактирование файла проекта вручную

Иногда необходимо вручную изменить файл проекта для определенной пользовательской конфигурации. Например, если у вас есть условия, которые не могут быть указаны в интегрированной среде разработки, например ссылка, которая отличается для двух разных платформ, или сборка, которая должна быть зарегистрирована для конкретной платформы, чтобы предоставить ее COM. Средство, обрабатывающее файл проекта, — MSBuild.

Регистрация COM

Если вы создаете сборку .NET и предоставляете ее com, Visual Studio регистрирует сборку с определенной архитектурой платформы, так как для каждой архитектуры платформы существуют разные расположения реестра (например, x86 и x64). Если сборка уже нацелена на определенную платформу, это используется, но если регистрируется сборка .NET, созданная для Any CPU, MSBuild по умолчанию регистрирует её для текущей версии среды выполнения MSBuild. Если вы создаете в Visual Studio, это x64 в Visual Studio 2022 и более поздних версиях, а также x86 в Visual Studio 2019 и более ранних версиях. Если вы задаете архитектуру платформы с помощью методов, описанных ранее в этой статье, или укажите другой PlatformTarget в файле проекта, MSBuild будет учитывать это при регистрации. Существует свойство, которое можно задать для переопределения этого поведения. RegisterAssemblyMSBuildArchitecture Вы можете задать RegisterAssemblyMSBuildArchitecture требуемую архитектуру платформы (например, x86 или x64), добавив её в элемент верхнего уровня PropertyGroup в файле проекта.

Ссылки на библиотеки DLL и сборки x86 и x64.

У вас может быть сборка .NET или библиотека DLL с версиями x86 и x64. Чтобы настроить проект для использования этих ссылок, сначала добавьте ссылку, а затем откройте файл проекта и измените его, чтобы добавить ItemGroup условие, которое ссылается как на конфигурацию, так и на целевую платформу. Например, предположим, что двоичный файл, на который вы ссылаетесь, — ClassLibrary1, и существуют разные пути для конфигураций отладки и выпуска, а также версий x86 и x64. Затем используйте четыре ItemGroup элемента со всеми сочетаниями параметров следующим образом:

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

  <PropertyGroup>
    <OutputType>Exe</OutputType>
    <TargetFramework>netcoreapp2.0</TargetFramework>
    <Platforms>AnyCPU;x64;x86</Platforms>
  </PropertyGroup>

  <ItemGroup Condition=" '$(Configuration)|$(Platform)' == 'Debug|x64'">
    <Reference Include="ClassLibrary1">
      <HintPath>..\..\ClassLibrary1\ClassLibrary1\bin\x64\Debug\netstandard2.0\ClassLibrary1.dll</HintPath>
    </Reference>
  </ItemGroup>

  <ItemGroup Condition=" '$(Configuration)|$(Platform)' == 'Release|x64'">
    <Reference Include="ClassLibrary1">
      <HintPath>..\..\ClassLibrary1\ClassLibrary1\bin\x64\Release\netstandard2.0\ClassLibrary1.dll</HintPath>
    </Reference>
  </ItemGroup>

  <ItemGroup Condition=" '$(Configuration)|$(Platform)' == 'Debug|x86'">
    <Reference Include="ClassLibrary1">
      <HintPath>..\..\ClassLibrary1\ClassLibrary1\bin\x86\Debug\netstandard2.0\ClassLibrary1.dll</HintPath>
    </Reference>
  </ItemGroup>
  
  <ItemGroup Condition=" '$(Configuration)|$(Platform)' == 'Release|x86'">
    <Reference Include="ClassLibrary1">
      <HintPath>..\..\ClassLibrary1\ClassLibrary1\bin\x86\Release\netstandard2.0\ClassLibrary1.dll</HintPath>
    </Reference>
  </ItemGroup>
</Project>

Дополнительные сведения о файле проекта см. в справочнике по схеме файлов проекта MSBuild.

Связанный контент

• /platform (параметры компилятора C#)
• 64-разрядные приложения
• Поддержка 64-разрядной среды разработки Visual Studio
• Общие сведения о файле проекта