Organiza tu proyecto para admitir tanto .NET Framework como .NET

Puede crear una solución que se compile para .NET Framework y .NET en paralelo. En este artículo se describen varias opciones de organización del proyecto que le ayudarán a lograr este objetivo. Estos son algunos escenarios típicos que se deben tener en cuenta al decidir cómo configurar el diseño del proyecto con .NET. Es posible que la lista no cubra todo lo que desee.

• Combinar proyectos existentes y proyectos de .NET en un único proyecto

  Ventajas

  • Simplifica el proceso de compilación mediante la compilación de un solo proyecto en lugar de varios proyectos que tienen como destino una versión o plataforma de .NET Framework diferente.
  • Simplifica la administración de archivos de origen para proyectos de varios destinos, ya que debe administrar un único archivo de proyecto. Al agregar o quitar archivos de código fuente, las alternativas requieren que se sincronicen manualmente estos archivos con otros proyectos.
  • Genere fácilmente un paquete NuGet para su consumo.
  • Permite escribir código para una versión específica de .NET Framework mediante directivas del compilador.

  Desventaja:

  • Requiere que los desarrolladores usen Visual Studio 2019 o una versión posterior para abrir proyectos existentes. Para admitir versiones anteriores de Visual Studio, mantener los archivos del proyecto en carpetas diferentes es una opción mejor.

• Mantener todos los proyectos separados

  Ventajas

  • Admite el desarrollo en proyectos existentes para desarrolladores y colaboradores que pueden no tener Visual Studio 2019 o una versión posterior.
  • Reduce la posibilidad de crear nuevos errores en proyectos existentes porque no se requiere renovación de código en esos proyectos.

Considere este repositorio de GitHub de ejemplo. En la ilustración siguiente se muestra cómo se ha diseñado este repositorio:

En las secciones siguientes se describen varias maneras de agregar compatibilidad con .NET en función del repositorio de ejemplo.

Reemplazar los proyectos existentes por un proyecto de .NET de destino múltiple

Reorganiza el repositorio para que se quiten los archivos *.csproj existentes y se cree un único archivo *.csproj que tenga como destino varios marcos. Esta es una excelente opción, ya que un solo proyecto puede compilarse para marcos diferentes. También tiene la capacidad de controlar diferentes opciones de compilación y dependencias por marco de trabajo de destino.

Para obtener código de ejemplo, consulte GitHub.

Los cambios en la nota son:

• Reemplazo de packages.config y *.csproj con un nuevo .NET *.csproj. Los paquetes NuGet se especifican con <PackageReference> ItemGroup.

Mantener los proyectos existentes y crear un proyecto de .NET

Si hay proyectos existentes que tienen como destino marcos anteriores, es posible que desee dejar estos proyectos intactos y usar un proyecto de .NET para establecer como destino marcos futuros.

Para obtener código de ejemplo, consulte GitHub.

Los proyectos de .NET y existentes se mantienen en carpetas independientes. Mantener los proyectos en carpetas independientes evita forzar que tenga Visual Studio 2019 o versiones posteriores. Puede crear una solución independiente que solo abra los proyectos antiguos.

Consulte también

• Documentación de portabilidad de .NET