Portabilidad a .NET Core desde .NET FrameworkPorting to .NET Core from .NET Framework

Si tiene código que se ejecuta en .NET Framework, puede que le interese ejecutarlo en .NET Core 1.0.If you've got code running on the .NET Framework, you may be interested in running your code on .NET Core 1.0. Este artículo es una introducción al proceso de portabilidad y describe una lista de las herramientas que puede encontrar de utilidad al realizar la portabilidad a .NET Core.This article covers an overview of the porting process and a list of the tools you may find helpful when porting to .NET Core.

Información general sobre el proceso de portabilidadOverview of the Porting Process

El proceso recomendado para realizar la portabilidad sigue estos pasos.The recommended process for porting follows the following series of steps. Cada una de estas partes del proceso se trata con más detalle en otros artículos.Each of these parts of the process are covered in more detail in further articles.

  1. Identifique y tenga en cuenta las dependencias de terceros.Identify and account for your third-party dependencies.

    Esto implica comprender lo que son las dependencias de terceros, cómo depende de ellas, cómo ver si también se ejecutan en .NET Core y los pasos que puede seguir si no lo hacen.This will involve understanding what your third-party dependencies are, how you depend on them, how to see if they also run on .NET Core, and steps you can take if they don't.

  2. Redirigir todos los proyectos que desee portar a .NET Framework 4.6.2 de destino.Retarget all projects you wish to port to target .NET Framework 4.6.2.

    Esto garantiza que puede usar alternativas de API para destinos específicos de .NET Framework en los casos donde .NET Core no pueda admitir una API determinada.This ensures that you can use API alternatives for .NET Framework-specific targets in the cases where .NET Core can't support a particular API.

  3. Use la herramienta API Portability Analyzer para analizar los ensamblados y desarrollar un plan para realizar la portabilidad basándose en los resultados.Use the API Portability Analyzer tool to analyze your assemblies and develop a plan to port based on its results.

    Esta herramienta analiza los ensamblados compilados y genera un informe que muestra un resumen de portabilidad de alto nivel, junto con un desglose de cada API que usa que no está disponible en .NET Core.The API Portability Analyzer tool will analyze your compiled assemblies and generate a report which shows a high-level portability summary and a breakdown of each API you're using that isn't available on .NET Core. Puede usar este informe junto con un análisis de su código base para desarrollar un plan de cómo portar el código.You can use this report alongside an analysis of your codebase to develop a plan for how you'll port your code over.

  4. Porte el código de prueba.Port your tests code.

    Dado que portar a .NET Core es un cambio tan grande para el código base, se recomienda encarecidamente portar las pruebas de forma que pueda ejecutarlas mientras porta el código.Because porting to .NET Core is such a big change to your codebase, it's highly recommended to get your tests ported so that you can run tests as you port code over. MSTest, xUnit y NUnit todos admiten actualmente .NET Core 1.0.MSTest, xUnit, and NUnit all support .NET Core 1.0 today.

  5. Ejecute el plan de portabilidad.Execute your plan for porting!

Herramientas de ayudaTools to help

Esta es una pequeña lista de las herramientas que puede encontrar de utilidad:Here's a short list of the tools you'll find helpful:

Pasos siguientesNext steps

Análisis de las dependencias de terceros.Analyzing your third-party dependencies.