Configurar projetos para plataformas de destino

Plataformas de destino com o Gerenciador de Configurações

O Configuration Manager oferece uma maneira de adicionar rapidamente uma nova plataforma de destino para seu projeto. Se você selecionar uma das plataformas incluídas no Visual Studio, uma configuração será definida para compilar seu projeto para a plataforma selecionada.

Direcionar a plataformas na interface do usuário de Propriedades do Projeto ou do Designer de Projeto

A interface do usuário do Designer de Projeto ou das Propriedades de Projeto também permite definir diferentes plataformas como destino para seu projeto. Se selecionar uma das plataformas incluídas na lista na caixa de diálogo Nova Plataforma de Solução não funcionar para sua solução, você poderá criar um nome de configuração personalizado e modificar as configurações nas Propriedades de Projeto para ter a plataforma correta como destino.

A execução dessa tarefa varia de acordo com a linguagem de programação que você está usando. Para obter mais informações, consulte os links a seguir:

• Para projetos do Visual Basic, consulte /platform (Visual Basic).

• Para projetos C#, consulte Página de Build, Designer de Projeto (C#).

Configuração “Preferir 32 bits”

A configuração Preferir 32 bits na página Compilação do designer de projeto para projetos do .NET Framework 4.5 ou posterior lida com o caso em que você está criando a configuração AnyCPU, mas deseja que seu aplicativo seja executado no modo de 32 bits quando em plataformas que oferecem suporte aos modos de 32 bits e 64 bits. Se você habilitar a caixa de seleção, a propriedade de compilação PlatformTarget será definida como anycpu32bitpreferred. Consulte os comentários sobre o PlatformTarget para C# e /platform para Visual Basic.

Edição manual do arquivo de projeto

Às vezes, você precisa editar manualmente o arquivo de projeto para algumas configurações personalizadas. Um exemplo é quando você tem condições que não podem ser especificadas no IDE, como uma referência diferente para duas plataformas diferentes ou um assembly que deve ser registrado para uma plataforma específica para expô-la ao COM. A ferramenta que processa o arquivo de projeto é o MSBuild.

Registro COM

Se você estiver criando um assembly do .NET e expondo-o ao COM, o Visual Studio registrará o assembly com uma arquitetura de plataforma específica, já que há locais de registro diferentes para cada arquitetura de plataforma (por exemplo, x86 e x64). Se o assembly já tiver como destino uma plataforma específica, isso será usado, mas se você estiver registrando um assembly .NET criado para Any CPU, o MSBuild usará como padrão registrá-lo no runtime atual do MSBuild. Se você estiver criando no Visual Studio, isso será x64 no Visual Studio 2022 e vers posteriores e x86 no Visual Studio 2019 e versões anteriores. Se você definir a arquitetura da plataforma usando os métodos descritos anteriormente neste artigo ou especificar um PlatformTarget diferente no arquivo de projeto, o MSBuild respeitará isso ao se registrar. Há uma propriedade que você pode definir para substituir esse comportamento, RegisterAssemblyMSBuildArchitecture. Você pode definir RegisterAssemblyMSBuildArchitecture para a arquitetura de plataforma desejada (como x86 ou x64) adicionando-a a um elemento PropertyGroup de nível superior no arquivo de projeto.

Referenciando assemblies e DLLs x86 e x64

Você pode ter um assembly ou uma DLL .NET com as versões x86 e x64. Para configurar o projeto para usar essas referências, primeiro adicione a referência e, em seguida, abra o arquivo de projeto e edite-o para adicionar um ItemGroup com uma condição que referencie a configuração e a plataforma de destino. Por exemplo, suponha que o binário que você está referenciando seja o ClassLibrary1 e que haja caminhos diferentes para as Configurações de Depuração e Versão, bem como para as versões x86 e x64. Em seguida, use quatro elementos ItemGroup com todas as combinações de configurações, da seguinte maneira:

<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>

Para obter mais informações sobre o arquivo de projeto, confira Referência de esquema do arquivo de projeto do MSBuild.

Conteúdo relacionado

• /platform (opções do compilador de C#)
• Aplicativos de 64 bits
• Suporte ao IDE do Visual Studio de 64 bits
• Noções básicas sobre o arquivo de projeto