Migración de actividades a .NET 6

Esta página ofrece una descripción general de cómo migrar tus actividades de .NET Framework personalizadas a .NET 6 para su uso en proyectos con la compatibilidad de Windows disponible a partir de Studio 2021.10.6.

Usaremos la actividad de muestra de .NET Framework MathSquareOfSum documentada en la página Crear actividades con código (heredado) como ejemplo para una migración a .NET 6 que se dirige a Windows mientras mantiene la compatibilidad con proyectos de .NET Framework para Windows: heredado.

Paso 1: migrar el proyecto al nuevo formato de estilo SDK y añadir net6.0-windows destino

Un proyecto que utiliza el formato de proyecto .NET Framework debe migrarse al nuevo formato de estilo SDK. Para obtener más información, consulta la documentación de Microsoft. Las referencias de los paquetes deben declararse en el archivo .csproj en lugar de packages.config.

1. En el Explorador de soluciones, haz clic con el botón derecho en el proyecto y selecciona Descargar proyecto.
2. Copia referencias y borra todo del archivo .csproj .
3. Actualiza manualmente el archivo .csproj al nuevo formato.
4. Añade el marco de destino net6.0-windows.
5. Marque las referencias originales como net461 solo añadiendo una condición.
6. Añade una nueva sección de referencia con condiciones para net6.0-windows. Debes declarar las siguientes dependencias de WWF para .NET: UiPath.Workflow.Runtime, UiPath.Workflow, System.Activities.Core.Presentation, System.Activities.Metadata. Asegúrate de que todas tus dependencias admiten .NET. Es posible que debas encontrar versiones de paquete más recientes o paquetes de reemplazo.
7. En el Explorador de soluciones, haz clic con el botón derecho en el proyecto y selecciona Volver a cargar proyecto.

El archivo debe tener el siguiente aspecto.

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

Comprueba el código en el archivo .cs para cada destino en busca de referencias que falten y actualiza las referencias en el archivo .csproj si es necesario.

Importante:

No incluyas los paquetes referenciados en el paquete NuGet ni los añadas como dependencias en los metadatos del paquete. La inclusión de los paquetes a los que se hace referencia da como resultado un error al instalar el paquete en Studio.

Paso 2: crear la solución

Asegúrese de probar el proyecto en busca de errores antes de intentar crearlo.

En el menú Crear , selecciona Crear solución. Las bibliotecas DLL se crean y guardan en la siguiente ubicación en carpetas independientes para cada marco de destino: %UserProfile%\source\repos\MathSquareOfSum\MathSquareOfSum\bin\Debug

Paso 3: crear un paquete NuGet

Crea un paquete NuGet utilizando el Explorador de paquetes NuGet, como se describe en Crear actividades con código (heredado).

1. Inicia el Explorador de paquetes NuGet y haz clic en Crear un nuevo paquete (Ctrl + N). Se muestra una ventana dividida que muestra Metadatos del paquete y Contenido del paquete. Necesitamos añadir todas las dependencias en la última sección.

2. Haz clic con el botón derecho dentro de la sección Contenido del paquete . Se mostrará un menú contextual.

3. Haz clic en Agregar carpeta lib. Ten cuenta que se creará un nuevo elemento lib en la sección de Contenidos del paquete.

4. Haz clic con el botón derecho en lib dos veces y selecciona lo siguiente:

   • Añadir carpeta .NET Framework > v4.6.1
   • Añadir carpeta .NET > v6.0-windows

5. Haz clic con el botón derecho en cada una de las carpetas añadidas en el paso anterior y selecciona Añadir archivo existente para cargar los archivos de ensamblado externo (.dll) necesarios para cada una. Los archivos se encuentran en una subcarpeta con el nombre del marco ubicado en la carpeta \bin\Debug :

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

6. Cambia el nombre de la carpeta net6.0-windows a net6.0-windows7.0.

7. Con el archivo seleccionado, accede al menú Editar y selecciona Editar metadatos. El panel izquierdo ahora está equipado con campos de metadatos editables.

8. Edita los campos de metadatos según sea necesario.

9. Selecciona Editar dependencias y, a continuación, añade los siguientes marcos de destino: net461 y net6.0-windows7.0.

   

10. Haga clic en el botón de marca de verificación verde en la esquina superior izquierda para guardar todos los cambios.

11. Selecciona Archivo > Guardar como para guardar el nuevo archivo.