Desarrollo Web

/Desarrollo Web

Documentar APIs con Swagger UI en .Net Core

Una de las tareas más importantes (y tediosas) en cualquier proyecto de software es elaborar una buena documentación. Un buen software podría ser infravalorado e infrautilizado si no existen documentos tales como manuales de usuario, descripciones técnicas o manuales de integración, que ayudan a cualquier persona involucrada a conocerlo y explotarlo. Afortunadamente, cada vez existen más herramientas que nos ayudan a generar esa documentación. En el caso de las APIs desarrolladas utilizando la especificación OpenAPI disponemos de Swagger UI, una documentación visual auto generada a partir de nuestro código (utilizando los summary y firmas de los endpoints) que nos permite explorar y probar nuestra API. Integrar Swagger UI en nuestra API es extremadamente sencillo, comenzando por instalar el paquete NuGet Swashbuckle.AspNetCore. Posteriormente, debemos habilitar que se gener el la documentación en XML a partir de nuestros summary. Para ello, nos vamos a las propiedades del proyecto, pestaña Build y activamos el check XML Documentation File. Posteriormente, debemos indicar que se debe generar y utilizar Swagger UI. Para ello, modificamos los métodos ConfigureServices y Configure de nuestra [...]

2020-01-15T11:34:12+00:0015 enero, 2020|Categories: Desarrollo Web|0 Comments

A las puertas de la versión 9 de Angular: Ivy Compiler

Aunque en la sombra, este será la tercera versión del compilador de angular, es decir el encargado de traducir nuestro código TypeScript en algo que entienda el navegador y manejar los cambios en el DOM. En la versión 2 teníamos “Template Compiler”, en la 4 pasamos a “View Engine” y desde la 8 (opcional) y por defecto en la 9 tendremos “Ivy”. Veamos algunas de las novedades o mejoras. Tamaño del bundle Unos de los peros que la gente le achaca a Angular es el tamaño de los bundles generados, y más si los comparamos con otros generados por otras opciones como React o Vue (no olvidemos que Angular es un framework completo) Teniendo esto en mente y si queremos mejorar la experiencia de apps en dispositivos móviles este punto era uno a mejorar. Estos datos solo realmente visibles en proyectos / medianos ya que el equipo de Google se ha centrado en la reducción del código generado y no en el Core. Incremental DOM Como hemos comentado una de las mejoras es Angular 9 es el uso por [...]

2019-11-20T10:55:36+00:0020 noviembre, 2019|Categories: Desarrollo Web|0 Comments

¿Cómo versionar APIs en .Net Core?

Estamos en un mundo dominado por los dispositivos móviles,. La sociedad ha evolucionado en los últimos años y cada vez hay más personas que utilizan sus smartphones o tablets para comunicarse, consumir contenidos, realizar compras, gestiones, etc. En este escenario, las empresas están obligadas a abrir y mantener nuevos canales de comunicación y negocios adaptados a esta nueva situación. Desde el punto de vista del software, esto implica desarrollar sistemas que deben funcionar incluso sin tener el control del último eslabón de la cadena: El dispositivo del consumidor. La rápida evolución y entrega de valor de esas aplicaciones móviles obligan a realizar el mismo esfuerzo con las APIs que les dan soporte, pero no nos podemos olvidar de la compatibilidad, puesto que hay usuarios que no pueden, no desean, o simplemente no se preocupan de mantener actualizadas sus aplicaciones. Si una API evoluciona sin tener en cuenta a este segmento de usuarios, probablemente sus aplicaciones dejen de funcionar correctamente, lo que impactaría en primer lugar en la experiencia de usuario, y finalmente, en el negocio empresarial. Por todo esto, [...]

2019-11-06T10:52:04+00:006 noviembre, 2019|Categories: Desarrollo Web|Tags: , |0 Comments

StackBlitz, el IDE en la nube para crear aplicaciones web

En desarrollo web estamos acostumbrados a utilizar editores online para compartir pequeños fragmentos de código a modo de ejemplos, ya sea con compañeros o en StackOverflow, como por ejemplo CodePen y JSFiddle. En Agosto de 2017 apareció un nuevo editor web basado en Visual Studio Code que va más allá y nos permite crear aplicaciones web utilizando los dos frameworks más utilizados para el desarrollo de Single Page Applications ( SPA ), React y Angular. StackBlitz inmediatamente se convirtió en una herramienta muy popular entre la numerosa comunidad que trabaja con ambos frameworks no sólo por la facilidad para crear una nueva aplicación sino por la sorprendente fluidez y la posibilidad de compartir nuestros proyectos alojados en sus servidores con URLs personalizables. De hecho, la documentación oficial de Angular ahora utiliza StackBlitz para mostrar sus ejemplos, en su tutorial de introducción Tour of Heroes encontraremos un enlace al live example utilizando la versión más reciente del framework donde directamente podemos editar el código y hacer pruebas. En poco más de un año de vida, StackBlitz alcanzó la cifra de un millón [...]

2018-12-12T08:42:47+00:0012 diciembre, 2018|Categories: Desarrollo Web|Tags: , , , , |0 Comments

Las mejores buenas prácticas en DevOps

Cuando me pidieron que escribiera este artículo, la idea era escribir sobre lo que se debería hacer en DevOps frente a lo que no se debería hacer, pero, llamadme optimista: el simple hecho de usar DevOps en un proyecto reduce, y mucho, las posibilidades de cometer errores durante el desarrollo de un proyecto. Aun así, en este texto vamos a repasar las prácticas "menos buenas" en DevOps. No apliques siempre la misma fórmula a todos los proyectos: A menudo veo cómo se aplican los mismos métodos entre clientes y proyectos, pero lo que muchas veces se pasa por alto es lo poco que tienen que ver entre sí. En DevOps, lo que funciona genial para un proyecto puede no servir para otro, y siempre es necesario un análisis previo de las necesidades. Entre otras cosas, se debe tener en cuenta cuántos programadores trabajarán al mismo tiempo, que entornos son los adecuados, si tiene un equipo de control de calidad, la frecuencia de las implementaciones de producción, si va a trabajar en Cloud u on premise... estos son solo algunos [...]

2018-11-28T09:55:13+00:0028 noviembre, 2018|Categories: Desarrollo Web, DevOps|Tags: , , |0 Comments

Qué te puede aportar SASS para añadirlo a tus proyectos

Hubo un tiempo en que aguérridos trabajadores del webmundo habían de enfrentarse a hojas de estilo CSS de miles y miles de líneas de código, ahogados por la desesperanza y temerosos de sustanciales cambios de diseño, pero, entonces, la luz de los preprocesadores acudió presta a dotar de claridad, orden y concisión a tamaña bestia. Bien podríamos comenzar así la historia de Sass (Syntactically Awesome Style Sheets), un preprocesador diseñado por Hampton Catlin y desarrollado por Nathan Weizenbaum que, como indican sus iniciales y representa su logotipo de neón rosado, consigue convertir la codificación de hojas de estilo en una actividad divertida y estimulante. ¿Qué nos aporta como para invertir tiempo y dedicación en él y añadirlo a nuestros proyectos? Ante todo, un enorme ahorro de código si se usa con acierto, así como un documento limpio y ordenado en el que el mantenimiento no se convierte en un infierno. ¿Y con respecto a otros preprocesadores? Pues una sintaxis muy intuitiva y fácil de aprender y entender. Para empezar a trabajar, únicamente necesitaremos Node y un par de comandos. [...]

2018-11-21T09:23:41+00:0021 noviembre, 2018|Categories: Desarrollo Web|Tags: , , , , , , |0 Comments
Translate »