Configurer des projets pour des plateformes cibles

Cibler des plateformes avec le Gestionnaire de configurations

Le Gestionnaire de configurations vous permet d’ajouter rapidement une nouvelle plateforme à cibler avec votre projet. Si vous sélectionnez l’une des plateformes incluses dans Visual Studio, une configuration est mise en place pour générer votre projet pour la plateforme sélectionnée.

Plateformes cibles dans l’interface utilisateur du concepteur de projet ou des propriétés de projet

L’interface utilisateur du concepteur de projet ou des propriétés du projet permet également de cibler différentes plateformes avec votre projet. Si la sélection de l’une des plateformes incluses dans la liste de la boîte de dialogue Nouvelle plateforme de solution ne fonctionne pas pour votre solution, vous pouvez créer un nom de configuration personnalisé et modifier les paramètres dans Propriétés du projet pour cibler la plateforme appropriée.

L’exécution de cette tâche varie suivant le langage de programmation que vous utilisez. Pour plus d’informations, consultez les liens suivants :

• Pour les projets Visual Basic, consultez /platform (Visual Basic).

• Pour les projets C#, consultez la page Build, Concepteur de projet (C#).

Paramètre Prefer 32 bit

Le paramètre Préférer 32 bits dans la page Version du concepteur de projets pour .NET Framework 4.5 ou versions ultérieures gère le cas où vous générez la configuration AnyCPU, mais vous souhaitez que votre application s’exécute en mode 32 bits lorsqu’elle est exécutée sur des plateformes qui prennent en charge les modes 32 bits et 64 bits. Si vous cochez la case, la propriété de build PlatformTarget est définie sur anycpu32bitpreferred. Consultez les commentaires sur PlatformTarget pour C# et /platform pour Visual Basic.

Modification manuelle du fichier projet

Parfois, vous devez modifier manuellement le fichier projet pour une configuration personnalisée. C’est le cas quand vous avez des conditions qui ne peuvent pas être spécifiées dans l’IDE, comme une référence différente pour deux plateformes différentes ou un assembly qui doit être inscrit pour une plateforme particulière afin de l’exposer à COM. L’outil qui traite le Fichier projet est MSBuild.

Inscription de COM

Si vous créez un assembly .NET et que vous l’exposez à COM, Visual Studio inscrit l’assembly avec une architecture de plateforme particulière, car il existe différents emplacements de registre pour chaque architecture de plateforme (par exemple, x86 et x64). Si votre assembly cible déjà une plateforme spécifique, celle-ci est alors utilisée. Mais si vous inscrivez un assembly .NET généré pour Any CPU, MSBuild est défini par défaut afin de l’inscrire pour le runtime actuel de MSBuild. Si vous générez dans Visual Studio, c’est x64 dans Visual Studio 2022 et versions ultérieures, et x86 dans Visual Studio 2019 et versions antérieures. Si vous définissez l’architecture de plateforme en utilisant les méthodes décrites précédemment dans cet article ou si vous spécifiez une autre valeur PlatformTarget dans le Fichier projet, MSBuild respecte cela lors de l’inscription. Il existe une propriété que vous pouvez définir pour remplacer ce comportement, RegisterAssemblyMSBuildArchitecture. Vous pouvez définir RegisterAssemblyMSBuildArchitecture sur l’architecture de plateforme souhaitée (par exemple x86 ou x64) en l’ajoutant à un élément PropertyGroup de niveau supérieur dans le Fichier projet.

Référencement des assemblys et des DLL x86 et x64

Vous pouvez avoir les versions x86 et x64 d’un assembly ou d’une DLL .NET. Pour configurer votre projet de manière à utiliser ces références, ajoutez d’abord la référence, puis ouvrez le fichier projet et modifiez-le pour ajouter un ItemGroup avec une condition qui fait référence à la fois à la configuration et à la plateforme cible. Par exemple, supposons que le binaire que vous référencez est ClassLibrary1 et qu’il existe des chemins différents pour les configurations Debug et Release, ainsi que des versions x86 et x64. Ensuite, utilisez quatre éléments ItemGroup avec toutes les combinaisons de paramètres, comme suit :

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

Pour plus d’informations sur le fichier projet, consultez Informations de référence sur le schéma de fichier de projet MSBuild.

Contenu connexe

• /platform (options du compilateur C#)
• Applications 64 bits
• Prise en charge de l’IDE Visual Studio 64 bits
• Présentation du fichier projet