Configuración de proyectos para plataformas de destino

Plataformas de destino con Configuration Manager

Configuration Manager proporciona una manera de agregar rápidamente una nueva plataforma como objetivo en tu proyecto. Si selecciona una de las plataformas incluidas con Visual Studio, se configura una configuración para compilar el proyecto para la plataforma seleccionada.

Plataformas de destino en la interfaz de usuario del diseñador de proyectos o la interfaz de propiedades del proyecto

La interfaz de usuario del Diseñador de Proyectos o Propiedades del Proyecto también proporciona una manera de apuntar a diferentes plataformas con el proyecto. Si seleccionar una de las plataformas incluidas en la lista en el cuadro de diálogo Nueva plataforma de solución no funciona para la solución, puede crear un nombre de configuración personalizado y modificar la configuración de Propiedades del proyecto para que tenga como destino la plataforma correcta.

La realización de esta tarea varía en función del lenguaje de programación que use. Vea los vínculos siguientes para obtener más información:

• Para proyectos de Visual Basic, consulte /platform (Visual Basic).

• Para proyectos de C#, vea la Página de Compilación, Diseñador de Proyectos (C#).

Preferir la configuración de 32 bits

La configuración Preferir 32 bits en la página Compilar del diseñador de proyectos para .NET Framework 4.5 o posterior maneja el caso en el que está compilando la AnyCPU configuración pero desea que su aplicación se ejecute en modo de 32 bits cuando se ejecuta en plataformas compatibles con ambos modos de 32 y 64 bits. Si habilita la casilla de verificación, la propiedad de compilación PlatformTarget se establece en anycpu32bitpreferred. Vea los comentarios de PlatformTarget para C# y /platform para Visual Basic.

Edición manual del archivo de proyecto

A veces, debe editar manualmente el archivo del proyecto para alguna configuración personalizada. Un ejemplo es cuando tiene condiciones que no se pueden especificar en el IDE, como una referencia diferente para dos plataformas diferentes, o un ensamblado que se debe registrar para una plataforma determinada para exponerlo a COM. La herramienta que procesa el archivo del proyecto es MSBuild.

El registro COM

Si va a compilar un ensamblado de .NET y exponerlo a COM, Visual Studio registra el ensamblado con una arquitectura de plataforma determinada, ya que hay diferentes ubicaciones del registro para cada arquitectura de plataforma (por ejemplo, x86 y x64). Si el ensamblaje ya está destinado a una plataforma específica, se utiliza, pero si está registrando un ensamblaje de .NET construido para Any CPU, MSBuild lo registra por defecto para el entorno de ejecución actual de MSBuild. Si está creando en Visual Studio, eso es así en x64 Visual Studio 2022 y versiones posteriores, y en x86 Visual Studio 2019 y versiones anteriores. Si establece la arquitectura de la plataforma mediante los métodos descritos anteriormente en este artículo o especifica otro PlatformTarget en el archivo de proyecto, MSBuild respetará eso al registrarse. Hay una propiedad que puede establecer para invalidar este comportamiento, RegisterAssemblyMSBuildArchitecture. Puede establecer RegisterAssemblyMSBuildArchitecture en la arquitectura de plataforma deseada (como x86 o x64) agregándola a un elemento de nivel PropertyGroup superior en el archivo del proyecto.

Referencia a ensamblados y bibliotecas DLL x86 y x64

Es posible que tenga un ensamblado o DLL de .NET que tenga versiones x86 y x64. Para configurar el proyecto para que use estas referencias, agregue primero la referencia y, a continuación, abra el archivo del proyecto y edítelo para agregar un ItemGroup con una condición que haga referencia a la configuración y a la plataforma de destino. Por ejemplo, supongamos que el binario al que hace referencia es ClassLibrary1 y hay diferentes rutas de acceso para las configuraciones de depuración y versión, así como las versiones x86 y x64. A continuación, use cuatro ItemGroup elementos con todas las combinaciones de configuración, como se indica a continuación:

<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 obtener más información sobre el archivo de proyecto, consulte Referencia de esquema de archivo de proyecto de MSBuild.

Contenido relacionado

• /platform (opciones del compilador de C#)
• Aplicaciones de 64 bits
• Compatibilidad con IDE de Visual Studio de 64 bits
• Descripción del archivo del proyecto