アクティビティを .NET 6 に移行する

このページでは、v2021.10.6 以降の Studio で利用可能な Windows 対応のプロジェクトで使用するために、custom.NET Framework アクティビティを to.NET 6 に移行する方法の概要を示します。

ここでは、Windows を対象とする .NET 6 への移行の例として、「コードを使用してアクティビティを作成する (レガシ)」に記載されているサンプルの MathSquareOfSum .NET Framework アクティビティを使用します。.NET Framework for Windows レガシ プロジェクトとの互換性も維持します。

手順 1: プロジェクトを新しい SDK スタイルの形式に移行し、net6.0-windows を追加する ターゲット

.NET Framework プロジェクト形式を使用しているプロジェクトは、新しい SDK スタイルの形式に移行する必要があります。 詳しくは、Microsoft のドキュメントをご覧ください。 パッケージ参照は .csproj ファイルで宣言する必要があります。packages.config ファイルではありません。

1. ソリューション エクスプローラーで、プロジェクトを右クリックし、[ プロジェクトのアンロード] を選択します。
2. 参照をコピーして、 .csproj のファイルからすべてをクリアします。
3. .csproj ファイルを手動で新しい形式に更新します。
4. ターゲット フレームワーク net6.0-windows を追加します。
5. 条件を追加することによってのみ、元の参照を net461 としてマークします。
6. net6.0-windows の条件を含む新しい参照セクションを追加します。.NET の WWF 依存関係 UiPath.Workflow.Runtime、UiPath.Workflow、System.Activities.Core.Presentation、System.Activities.Metadata を宣言する必要があります。すべての依存関係で .NET がサポートされていることを確認してください。新しいパッケージ バージョンまたは置き換えパッケージを見つける必要がある場合があります。
7. ソリューション エクスプローラーで、プロジェクトを右クリックし、[ プロジェクトの再読み込み] をクリックします。

ファイルは次のようになります。

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

.cs ファイルのコードをチェックして、それぞれのターゲットに参照がないかどうか確認し、必要に応じて .csproj ファイル内の参照を更新します。

重要:

参照されるパッケージを NuGet パッケージに含めたり、パッケージ メタデータに依存関係として追加したりしないでください。参照されているパッケージを含めると、Studio へのパッケージのインストールが失敗します。

ステップ 2: ソリューションを構築する

プロジェクトのビルドを試す前に、必ずプロジェクトでエラーがないかテストしてください。

[ 構築 ] メニューの [ ソリューションの構築] をクリックします。DLL ライブラリがビルドされ、ターゲット フレームワークごとに別のフォルダーにビルドされ、次の場所に保存されます %UserProfile%\source\repos\MathSquareOfSum\MathSquareOfSum\bin\Debug

手順 3: NuGet パッケージを作成する

「コードを使用してアクティビティを作成する (レガシ)」の説明に従って、NuGet Package Explorer を使用して NuGet パッケージを作成します。

1. NuGet Package Explorer を起動し、[新しいパッケージを作成] をクリックします (Ctrl + N)。分割ウィンドウが表示され、 パッケージのメタデータ と パッケージの内容が表示されます。後者のセクションにすべての依存関係を追加する必要があります。

2. [ パッケージの内容 ] セクション内を右クリックします。コンテキスト メニューが表示されます。

3. [Add lib folder] をクリックします。新しい [lib] 項目が、[Package contents] セクションに作成されます。

4. lib を 2 回右クリックし、次のように選択します。

   • .NET Framework フォルダーを追加 > v4.6.1
   • .NET フォルダーを v6.0-windows >追加する

5. 前の手順で追加した各フォルダーを右クリックして [ 既存のファイルを追加 ] を選択し、各フォルダーに必要な外部アセンブリ (.dll) ファイルを読み込みます。ファイルは、 \bin\Debug フォルダーにあるフレームワーク名のサブフォルダーにあります。

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

6. net6.0-windows フォルダーの名前を net6.0-windows7.0に変更します。

7. ファイルを選択した状態で、[ 編集 ] メニューにアクセスし、[ メタデータを編集] を選択します。左側のパネルに、編集可能なメタデータ フィールドを追加しました。

8. 必要に応じてメタデータ フィールドを編集します。

9. [ 依存関係の編集] を選択し、ターゲット フレームワーク net461 と net6.0-windows7.0 を追加します。

   

10. 左上隅の緑色のチェックマーク ボタンをクリックすると、すべての変更が保存されます。

11. [ ファイル ] > [ 名前を付けて保存 ] を選択して、新しいファイルを保存します。