Migration des activités vers .NET 6

Cette page explique comment migrer vos activités .NET Framework personnalisées vers .NET 6 pour les utiliser dans les projets avec la compatibilité Windows disponible à partir de Studio 2021.10.6.

Nous utiliserons l’exemple d’activité MathSquareOfSum.NET Framework documenté sur la page Création d’activités avec du code (Héritage) comme exemple pour une migration vers .NET 6 qui cible Windows tout en maintenant la compatibilité avec .NET Framework pour les projets Windows - Héritage.

Étape 1 : migrez le projet vers le nouveau format de style SDK et ajoutez le fichier net6.0-windows cible

Un projet qui utilise le format de projet .NET Framework doit être migré vers le nouveau format de style SDK. Pour plus d'informations, consultez la documentation Microsoft. Les références de packages doivent être déclarées dans le fichier .csproj par opposition à packages.config.

1. Dans l' explorateur de solutions, cliquez avec le bouton droit sur le projet et sélectionnez Décharger le projet.
2. Copiez les références et effacez tout ce qui se trouve dans le fichier .csproj .
3. Mettez à jour manuellement le fichier .csproj vers le nouveau format.
4. Ajoutez l'infrastructure cible net6.0-windows.
5. Marquez les références d'origine comme net461 uniquement en ajoutant une condition.
6. Ajoutez une nouvelle section de référence avec des conditions pour net6.0-windows. Vous devez déclarer les dépendances WWF suivantes pour .NET : UiPath.Workflow.Runtime, UiPath.Workflow, System.Activities.Core.Presentation, System.Activities.Metadata. Assurez-vous que toutes vos dépendances prennent en charge .NET. Vous devrez peut-être trouver des versions de package plus récentes ou des packages de remplacement.
7. Dans l'explorateur de solutions, faites un clic droit sur le projet et sélectionnez Recharger le projet.

Le fichier doit ressembler à ceci.

<Project Sdk="Microsoft.NET.Sdk.WindowsDesktop" ToolsVersion="Current">
  <PropertyGroup>
    <TargetFrameworks>net461;net6.0-windows</TargetFrameworks>
    <AssemblyName>MathSquareOfSum</AssemblyName>
    <RootNamespace>MathSquareOfSum</RootNamespace>
    <UseWpf>true</UseWpf>
    <GenerateAssemblyInfo>false</GenerateAssemblyInfo>
  </PropertyGroup>
  <ItemGroup Condition=" '$(TargetFramework)' == 'net461' ">
    <Reference Include="PresentationCore" />
    <Reference Include="PresentationFramework" />
    <Reference Include="System" />
    <Reference Include="System.Activities" />
    <Reference Include="System.Activities.Core.Presentation" />
    <Reference Include="System.Activities.Presentation" />
    <Reference Include="System.ComponentModel.Composition" />
    <Reference Include="System.Core" />
    <Reference Include="System.Xaml" />
    <Reference Include="System.Xml.Linq" />
    <Reference Include="System.Data.DataSetExtensions" />
    <Reference Include="Microsoft.CSharp" />
    <Reference Include="System.Data" />
    <Reference Include="System.Net.Http" />
    <Reference Include="System.Xml" />
    <Reference Include="WindowsBase" />
  </ItemGroup>
  <ItemGroup Condition=" '$(TargetFramework)' == 'net6.0-windows' ">
    <PackageReference Include="UiPath.Workflow.Runtime" Version="6.0.0-20220401-03" PrivateAssets="All" />
    <PackageReference Include="UiPath.Workflow" Version="6.0.0-20220401-03" PrivateAssets="All" />
    <PackageReference Include="System.Activities.Core.Presentation" Version="6.0.0-20220318.2" PrivateAssets="All" />
    <PackageReference Include="System.Activities.Metadata" Version="6.0.0-20220318.2" PrivateAssets="All" />
  </ItemGroup>
</Project>

Vérifiez le code dans le fichier .cs pour chaque cible pour les références manquantes et mettez à jour les références dans le fichier .csproj si nécessaire.

Important :

N'incluez pas les packages référencés dans le package NuGet ou ajoutez-les en tant que dépendances dans les métadonnées du package. L’inclusion des packages référencés entraîne un échec de l’installation du package dans Studio.

Étape 2 : Créer la solution

Assurez-vous de tester le projet pour les erreurs avant d'essayer de le générer.

Dans le menu Créer , sélectionnez Créer une solution. Les bibliothèques DLL sont créées et enregistrées à l'emplacement suivant dans des dossiers distincts pour chaque infrastructure cible : %UserProfile%\source\repos\MathSquareOfSum\MathSquareOfSum\bin\Debug

Étape 3 : Créer un paquet NuGet

Créez un package NuGet à l’aide de l’ Explorateur de packages NuGet, tel que décrit dans Création d’activités avec du code (Héritage).

1. Lancez NuGet Package Explorer et cliquez sur Créer un nouveau package (Ctrl + N). Une fenêtre partagée affiche les Métadonnées du package et le Contenu du package. Il faut ajouter toutes les dépendances dans cette dernière section.

2. Cliquez avec le bouton droit dans la section Contenu du paquet . Un menu contextuel s’affiche.

3. Cliquez sur Ajouter un dossier lib (Add lib folder). Notez qu'un nouvel élément lib (lib) est créé dans la section Contenu du package (Package contents).

4. Cliquez avec le bouton droit sur lib deux fois et sélectionnez comme suit :

   • Ajouter un dossier .NET Framework > v4.6.1
   • Ajouter un dossier .NET > v6.0-windows

5. Cliquez avec le bouton droit sur chacun des dossiers ajoutés à l'étape précédente et sélectionnez Ajouter un fichier existant pour charger les fichiers d'assembly externe (.dll) requis pour chacun. Les fichiers sont situés dans un sous-dossier avec le nom d’infrastructure situé dans le dossier \bin\Debug :

   • net461 - MathSquareOfSum.dll
   • net6.0-windows - MathSquareOfSum.dll

6. Renommez le dossier net6.0-windows en net6.0-windows7.0.

7. Avec le fichier sélectionné, accédez au menu Modifier et sélectionnez Modifier les métadonnées. Le panneau de gauche est désormais équipé de champs de métadonnées modifiables.

8. Modifiez les champs de métadonnées selon vos besoins.

9. Sélectionnez Modifier les dépendances, puis ajoutez les infrastructures cibles suivantes : net461 et net6.0-windows7.0.

   

10. Cliquez sur la coche verte dans le coin supérieur gauche pour enregistrer toutes les modifications.

11. Sélectionnez Fichier > Enregistrer sous pour enregistrer le nouveau fichier.