Configuración de proyectos para plataformas de destino

Configurar plataformas de destino con el Administrador de configuración

El Administrador de configuración proporciona una forma de agregar rápidamente nuevas plataformas de destino para el proyecto. Si selecciona una de las plataformas que se incluyen con Visual Studio, las propiedades del proyecto se modifican para que pueda compilar para esa plataforma.

Plataformas de destino en la interfaz de usuario del Diseñador de proyectos o de Propiedades del proyecto

La interfaz de usuario del Diseñador de proyectos o de Propiedades del proyecto también proporciona una forma de configurar distintas plataformas para el proyecto de destino. Si la selección de una de las plataformas incluidas en la lista del 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 en Propiedades del proyecto a fin de configurar el proyecto para la plataforma de destino apropiada.

La realización de esta tarea varía según el lenguaje de programación utilizado. Para obtener más información, vea los siguientes vínculos:

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

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

Preferencia de configuración de 32 bits

La configuración Preferencia de 32 bits de la página Compilar del diseñador de proyectos para .NET Framework 4.5 o posterior controla el caso en el que va a compilar la configuración AnyCPU, pero quiere que la aplicación se ejecute en modo de 32 bits cuando se ejecuta en plataformas que admiten modos de 32 y 64 bits. Si habilita la casilla, 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 del proyecto

A veces hay que modificar manualmente el archivo de proyecto debido a alguna configuración personalizada. Un ejemplo es cuando se tienen condiciones que no se pueden especificar en el IDE, como una referencia que es diferente para dos plataformas distintas, o un ensamblado que debe registrarse para una plataforma concreta con el fin de exponerlo a COM. La herramienta que procesa el archivo del proyecto es MSBuild.

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 ensamblado ya tiene como destino una plataforma específica, se usa, pero si va a registrar un ensamblado de .NET compilado para Any CPU, el valor predeterminado de MSBuild es registrarlo para el entorno de ejecución actual de MSBuild. Si va a compilar en Visual Studio, se encuentra x64 en Visual Studio 2022 y versiones posteriores, y x86 en 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 superior PropertyGroup en el archivo del proyecto.

Referencia a ensamblados y DLL de x86 y x64

Puede que tenga un ensamblado .NET o DLL que tenga las versiones tanto x86 como x64. Para configurar el proyecto para que use estas referencias, primero agregue la referencia y, después, abra el archivo de proyecto y edítelo para agregar un elemento ItemGroup con una condición que haga referencia a la configuración y a la plataforma de destino. Por ejemplo, supongamos que el archivo binario al que está haciendo referencia es ClassLibrary1 y que hay varias rutas de acceso distintas para las configuraciones Debug y Release, así como las versiones x86 y x64. Use cuatro elementos ItemGroup con todas las combinaciones de configuraciones, como aquí:

<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 más información sobre el archivo de proyecto, vea Referencia de esquemas del archivo del proyecto MSBuild.

Contenido relacionado

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