Migrieren von Aktivitäten zu. NET 6

Diese Seite bietet einen Überblick darüber, wie Sie Ihre benutzerdefinierten.NET Framework-Aktivitäten zu.NET 6 migrieren, um sie in Projekten mit Windows-Kompatibilität zu verwenden, die ab Studio 2021.10.6 verfügbar ist.

Wir verwenden die Beispielaktivität MathSquareOfSum, die auf der Seite Erstellen von Aktivitäten mit Code (Legacy) dokumentiert ist, als Beispiel für eine Migration zu .NET 6, die auf Windows abzielt und gleichzeitig die Kompatibilität mit .NET Framework für Windows-Legacy-Projekte beibehält.

Schritt 1: Migrieren des Projekts in das neue SDK-Format und Hinzufügen von „net6.0-windows Ziel

Ein Projekt, das das.NET Framework-Projektformat verwendet, muss in das neue SDK-Stil-Format migriert werden. Weitere Informationen finden Sie in der Microsoft-Dokumentation. Paketverweise müssen in der .csproj-Datei im Gegensatz zu packages.config.

1. Klicken Sie im Solution Explorer mit der rechten Maustaste auf das Projekt und wählen Sie Projekt entladen aus .
2. Kopieren Sie Verweise, und löschen Sie alles aus der Datei .csproj .
3. Aktualisieren Sie die Datei .csproj manuell auf das neue Format.
4. Fügen Sie das Zielframework net6.0-windows hinzu.
5. Markieren Sie die ursprünglichen Verweise nur durch Hinzufügen einer Bedingung als net461 .
6. Fügen Sie einen neuen Referenzabschnitt mit Bedingungen für net6.0-windows hinzu. Sie müssen die folgenden WWF-Abhängigkeiten für .NET deklarieren: UiPath.Workflow.Runtime, UiPath.Workflow, System.Activities.Core.Presentation, System.Activities.Metadata. Stellen Sie sicher, dass alle Ihre Abhängigkeiten .NET unterstützen. Möglicherweise müssen Sie neuere Paketversionen oder Ersatzpakete finden.
7. Klicken Sie im Solution Explorer mit der rechten Maustaste auf das Projekt und wählen Sie Projekt neu laden aus.

Die Datei sollte wie folgt aussehen.

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

Überprüfen Sie den Code in der .cs -Datei für jedes Ziel auf fehlende Verweise und aktualisieren Sie bei Bedarf die Verweise in der .csproj -Datei.

Wichtig:

Schließen Sie die referenzierten Pakete nicht in das NuGet-Paket ein oder fügen Sie sie als Abhängigkeiten in den Paketmetadaten hinzu. Das Einbeziehung der referenzierten Pakete führt dazu, dass die Installation des Pakets in Studio fehlschlägt.

Schritt 2: Erstellen der Lösung

Testen Sie das Projekt auf Fehler, bevor Sie versuchen, es zu erstellen.

Wählen Sie im Menü Erstellen die Option Lösung erstellen aus. Die DLL-Bibliotheken werden am folgenden Speicherort in separaten Ordnern für jedes Zielframework erstellt und gespeichert: %UserProfile%\source\repos\MathSquareOfSum\MathSquareOfSum\bin\Debug

Schritt 3: Erstellen eines NuGet-Pakets

Erstellen Sie ein NuGet-Paket mit dem NuGet Package Explorer, wie unter Erstellen von Aktivitäten mit Code (Legacy) beschrieben.

1. Starten Sie den NuGet-Paket-Explorer und klicken Sie auf Ein neues Paket erstellen (Strg+N). Ein geteiltes Fenster wird angezeigt, in dem Paketmetadaten und Paketinhalt enthalten sind. Im letzten Abschnitt müssen alle Abhängigkeiten hinzugefügt werden.

2. Klicken Sie mit der rechten Maustaste auf den Abschnitt Paketinhalte . Ein Kontextmenü wird angezeigt.

3. Klicken Sie auf lib-Ordner hinzufügen (Add lib folder). Ein neues lib (lib)-Element wurde im Bereich Paketinhalt (Package contents) erstellt.

4. Klicken Sie zweimal mit der rechten Maustaste auf lib und wählen Sie folgendermaßen aus:

   • Fügen Sie den .NET Framework-Ordner > v4.6.1hinzu
   • Fügen Sie den .NET-Ordner > v6.0-windowshinzu

5. Klicken Sie mit der rechten Maustaste auf jeden der im vorherigen Schritt hinzugefügten Ordner, und wählen Sie Vorhandene Datei hinzufügen aus, um die für jeden erforderlichen externen Assembly-Dateien (.dll) zu laden. Die Dateien befinden sich in einem Unterordner mit dem Framework-Namen im Ordner \bin\Debug :

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

6. Benennen Sie den Ordner net6.0-windows in net6.0-windows7.0um.

7. Wenn die Datei ausgewählt ist, greifen Sie auf das Menü Bearbeiten zu und wählen Sie Metadaten bearbeiten aus . Das linke Panel ist nun mit bearbeitbaren Metadatenfeldern ausgestattet.

8. Bearbeiten Sie die Metadatenfelder nach Bedarf.

9. Wählen Sie Abhängigkeiten bearbeiten aus und fügen Sie dann die folgenden Zielframeworks hinzu: net461 und net6.0-windows7.0.

   

10. Klicken Sie auf das grüne Häkchen in der oberen linken Ecke, um alle Änderungen zu speichern.

11. Wählen Sie Datei > Speichern als aus, um die neue Datei zu speichern.