Nota
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
En esta guía se proporcionan recomendaciones para que los desarrolladores creen bibliotecas de .NET de alta calidad. Esta documentación se centra en qué y por qué al compilar una biblioteca de .NET, no en cómo.
Aspectos de las bibliotecas de .NET de alta calidad:
- Inclusivo : las buenas bibliotecas de .NET se esfuerzan por admitir muchas plataformas, lenguajes de programación y aplicaciones.
- Estable : las buenas bibliotecas de .NET coexisten en el ecosistema de .NET, que se ejecutan en aplicaciones compiladas con muchas bibliotecas.
- Diseñado para evolucionar : las bibliotecas de .NET deben mejorar y evolucionar con el tiempo, a la vez que admiten usuarios existentes.
- Depurables: las bibliotecas .NET deben usar las herramientas más recientes para ofrecer una buena experiencia de depuración a los usuarios.
- Confianza: Las bibliotecas de .NET se ganan la confianza de los desarrolladores al publicar en NuGet mediante las mejores prácticas de seguridad.
Tipos de recomendaciones
Cada artículo presenta cuatro tipos de recomendaciones: Do, Consider, Avoid y Do not. El tipo de recomendación indica cuán estrictamente debe ser seguida.
Casi siempre debe seguir una recomendación Debe. Por ejemplo:
✔️ Distribuya la biblioteca mediante un paquete NuGet.
Por otro lado, las recomendaciones de tipo Es recomendable generalmente deben seguirse, pero existen una serie de excepciones legítimas, por lo que no pasa nada si no sigue alguna de ellas:
✔️ CONSIDERE la posibilidad de usar semVer 2.0.0 para la versión del paquete NuGet.
Evite recomendaciones que mencionen cosas que generalmente no son una buena idea, pero a veces tiene sentido interrumpir la regla:
❌ EVITE las referencias de paquetes NuGet que exigen una versión exacta.
Y, por último, las recomendaciones de tipo No está permitido indican qué no se puede hacer casi nunca:
❌ NO publique versiones con y sin nombre seguro de su biblioteca. Por ejemplo, Contoso.Api
y Contoso.Api.StrongNamed
.