Migração de atividades para o. NET 6

Esta página oferece uma visão geral de como migrar suas atividades personalizadas do.NET Framework para.NET 6 para uso em projetos com a compatibilidade com o Windows disponível a partir do Studio 2021.10.6.

Usaremos a atividade de exemplo MathSquareOfSum.NET Framework documentada na página Criando atividades com código (Legacy) como um exemplo para uma migração para.NET 6 que tem como alvo o Windows enquanto também mantém a compatibilidade com projetos .NET Framework para Windows - Legacy.

Etapa 1: migrar o projeto para o novo formato estilo SDK e adicionar o net6.0-windows destino

Um projeto que está usando o formato de projeto do .NET Framework deve ser migrado para o novo formato de estilo SDK. Para obter mais informações, consulte a documentação da Microsoft. As referências do pacote devem ser declaradas no arquivo .csproj em vez depackages.config.

1. No Explorador de soluções, clique com o botão direito no projeto e selecione Descarregar projeto.
2. Copie as referências e limpe tudo do arquivo .csproj .
3. Atualize manualmente o arquivo .csproj para o novo formato.
4. Adicione a estrutura de destino net6.0-windows.
5. Marque as referências originais como net461 apenas adicionando uma condição.
6. Adicione uma nova seção de referência com condições para net6.0-windows. Você deve declarar as seguintes dependências da WWF para .NET: UiPath.Workflow.Runtime, UiPath.Workflow, System.Activities.Core.Presentation, System.Activities.Metadata. Certifique-se de que todas as suas dependências ofereçam suporte a .NET. Você pode precisar encontrar versões de pacote mais recentes ou pacotes de substituição.
7. No Explorador de soluções, clique com o botão direito no projeto e selecione Recarregar projeto.

O arquivo deve ter a seguinte aparência.

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

Verifique o código no arquivo .cs para cada destino em busca de referências ausentes e atualize as referências no arquivo .csproj , se necessário.

Importante:

Não inclua os pacotes referenciados no pacote NuGet nem os adicione como dependências nos metadados do pacote. Incluir os pacotes referenciados resulta em uma falha na instalação do pacote no Studio.

Etapa 2: criar a solução

Certifique-se de testar se há erros no projeto antes de tentar criá-lo.

No menu Compilar , selecione Criar solução. As bibliotecas DLL são criadas e salvas no seguinte local em pastas separadas para cada estrutura de destino: %UserProfile%\source\repos\MathSquareOfSum\MathSquareOfSum\bin\Debug

Etapa 3: criar um pacote NuGet

Crie um pacote NuGet usando o NuGet Package Explorer, conforme descrito em Criação de atividades com código (Legacy).

1. Inicie o Explorador de Pacotes NuGet e clique em Criar um novo pacote (Ctrl + N). Uma janela bipartida será exibida com os metadados do pacote e o conteúdo do pacote. Precisamos adicionar todas as dependências na seção final.

2. Clique com o botão direito do mouse na seção Conteúdo do Pacote . O menu de contexto é exibido.

3. Clique em Adicionar pasta lib. Observe que um novo item lib será criado na seção Conteúdo do Pacote.

4. Clique com o botão direito do mouse em lib duas vezes e selecione a seguinte opção:

   • Adicionar pasta do .NET Framework > v4.6.1
   • Adicionar pasta .NET > v6.0-windows

5. Clique com o botão direito do mouse em cada uma das pastas adicionadas na etapa anterior e selecione Adicionar arquivo existente para carregar os arquivos de assembly externo (.dll) necessários para cada um. Os arquivos estão localizados em uma subpasta com o nome de framework localizado na pasta \bin\Debug :

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

6. Renomeie a pasta net6.0-windows para net6.0-windows7.0.

7. Com o arquivo selecionado, acesse o menu Editar e selecione Editar metadados. O painel esquerdo agora está equipado com campos de metadados editáveis.

8. Edite os campos de metadados conforme necessário.

9. Selecione Editar dependências e adicione as seguintes estruturas de destino: net461 e net6.0-windows7.0.

   

10. Clique no botão de marca de seleção verde no canto superior esquerdo para salvar todas as alterações.

11. Selecione Arquivo > Salvar como para salvar o novo arquivo.