Inicio rápido: documentos de calidad de código (2024)

  1. Tu primer escaneo
    1. Creando un proyecto
    2. Vinculación de un repositorio
    3. Escanear un repositorio
  2. Identificación de problemas
    1. Obtenga una descripción general de su software
    2. Ver e interpretar el mapa de calor
    3. Identifique sus principales prioridades con la lista de componentes
    4. Bucear a través de distribuciones de problemas
  3. Mejora del punto de acceso
    1. Uso del Componente Explorer para solucionar problemas
    2. Analizar dependencias
    3. Usando el editor de particiones
  4. Evaluación de cambios
    1. Ver el impacto del cambio
    2. Cavar a cambios detallados

Tu primer escaneo

Para comenzar con la calidad del código Browserstack, simplemente necesita crear un proyecto, vincular un repositorio y ejecutar su primer escaneo.¡Eso es todo!

Para adquirir la licencia autogestionada de la calidad del código BROWSERSTACK.AmableContáctenos.

Creando un proyecto

Los proyectos son lo que utiliza la calidad del código Browserstack para almacenar y administrar su código;Contienen los repositorios que enlaza a la calidad del código Browserstack.Puede crear proyectos Agregar repositorios.Hoy crearemos un solo proyecto y vinculamos un solo repositorio.

Pasos para crear un proyecto:

1. Inicie sesión en su cuenta de calidad de código Browserstack.(Tu dominio.mygamma.io).

2. Navegue a la páginaProyectosy hacer clicCrea un nuevo proyecto.

Ahora debería ver una ventana emergente con dos campos: nombre del proyecto y descripción del proyecto.Normalmente, ingrese la información relevante para su propio proyecto, pero aquí usaremos lo siguiente:

3. En el campoNombre del proyecto, ingresarapache.

4. En el campo,Descripción del Proyecto, ingresarApache Commons Text es una biblioteca centrada en los algoritmos que trabajan en cadenas.

5. Haga clicCrear proyecto.

¡Acabas de crear tu primer proyecto en la calidad del código Browserstack!

Vinculación de un repositorio

Los repositorios son los contenedores de almacenamiento para su código fuente.La mayoría de los repositorios de hoy se almacenan utilizando servicios como GitHub, Gitlab, Bitbucket, etc. (Vea una lista completa de servicios compatiblesaquí).Para analizar cualquier código en la calidad del código Browserstack, primero se debe vincular un repositorio.

Pasos para vincular un repositorio:

Dentro de su nuevo proyecto (Apache), haga clicRepositorios de enlace.

Ahora debería ver una ventana emergente con una serie de formularios que representan la calidad de la calidad del código Browserstack necesita vincular y escanear un repositorio.(Algunos de sus campos pueden diferir de los presentados, estos dependen de la cuenta y/o el tipo de repositorio elegido).

Establezca el tipo de cuenta:

Como su nombre indica, aquí es donde establece el tipo de cuenta de control de versiones en la que se almacena su repositorio (Ejemplo: Git, Bitbucket, TFS, ZIP, SVN, etc.).Actualmente, las cuentas gratuitas de calidad de código de código abierto de código abierto se limitan solo a repositorios públicos de GitHub.

Si no se ha seleccionado, configure el tipo de cuenta/repositorio enGit.

Obtenga la URL del repositorio:

Dado que el proyecto que queremos analizar está alojado en GitHub, necesitaremos usar su URL para acceder a él.Podemos hacer esto yendo alpágina del proyectoy copiar el enlace que se muestra al hacer clic en el botónClon o descargar.

Alternativamente, copiehttps://github.com/apache/commons-text.gity pegar la URL de GitHub en el campo, "URL":

Ingrese el nombre de usuario y la contraseña:

Como se mencionó, si se requieren o no ciertos campos se basan en el tipo de cuenta y/o repositorio.
En este tutorial, estamos analizando unpúblicorepositorio.Por lo tanto, no necesitamos ingresar un nombre de usuario y una contraseña.
Sin embargo, tenga en cuenta que estos campos serían necesarios si estuviéramos tratando de analizar unprivadorepositorio.

Si se presenta con los campos de nombre de usuario y contraseña, deje estos en blanco.

Nombre el repositorio:

Este campo obligatorio ayuda a que usted y sus compañeros de equipo hay una buena indicación de lo que hay dentro.A menudo, la mejor práctica es reflejar el nombre que de otro modo se le da al repositorio.En este caso,Texto común.

En el campoNombre de repositorio, escriba Commons-Text.

Establecer el idioma:

Para que la calidad del código de Browserstack analice correctamente un repositorio, necesita saber en qué lenguaje se escribió. Esto se establece fácilmente a través del menú desplegable en la ventana emergente.
Establecer el idioma aJava.

Hacer clicRepositorio de enlace.
¡Acabas de vincular tu primer repositorio!

Escanear un repositorio

Los escaneos son la base de la calidad del código Browserstack: una vez iniciado, la calidad del código de Browserstack analizará el código fuente dado, generará métricas, identifica problemas de código y encuentra diseño de softwareanti-paternos.Así que ejecutemos un escaneo en el repositorio que acabamos de configurar.

Ejecutar un escaneo

Dentro del repositorio, Apache hace clic en el botón,Escanear.

Inicio rápido: documentos de calidad de código (1)
Selección de escaneo

Después de hacer clic en el botón Escanear, se abre una nueva ventana emergente que le permite especificar qué rama o etiqueta de su repositorio Git desea escanear.También le muestra cuántos de sus créditos de escaneo ya se usan y cuánto de su historial de exploración está ocupado.Por defecto, la rama "maestro" siempre se selecciona.Para que sus resultados sean comparables a los nuestro, navegue alEtiquetaspestaña y seleccioneCommons-Text-1.2.Hacer clicEscanearEn la esquina inferior derecha de la ventana emergente para iniciar el proceso de escaneo real.

Ver progreso del escaneo

Después de hacer clic en el botón Escanear, se programará el análisis.Puede rastrear el estado del escaneo, junto con todos los demás escaneos actualmente en ejecución de la pestaña de cola de escaneo, a la que se puede acceder desde el menú en el lado izquierdo. Al hacer clic en un elemento en esta lista, como en este ejemplo haciendo clic en 'Commons-Texto ', el monitor de progreso detallado se abre y se puede usar para monitorear el progreso del escaneo.

Inicio rápido: documentos de calidad de código (2)

Después de a veces el estado de escaneo debería llegar a completarse.

Inicio rápido: documentos de calidad de código (3)

Todos los escaneos anteriores, junto con varias otras configuraciones específicas del repositorio se pueden encontrar en elrepositoriomenú.Para ver este menú,navegardentro deProyecto Apachey haga clic en los tres puntos en la esquina superior derecha de laTexto comúnTarjeta de repositorio.

Inicio rápido: documentos de calidad de código (4)

¡Felicidades!¡Acabas de terminar tu primer escaneo!Ahora puede navegar de regreso al repositorio para echar un vistazo a los hallazgos.

Inicio rápido: documentos de calidad de código (5)

Identificación de problemas

Obtenga una descripción general de su software e identifique los problemas más importantes.

Obtenga una descripción general de su software

1. Necesita una cuenta de calidad de código BROWSERTACK ACTIVO.(¿No tienes uno?Regístrese gratis aquí).
2. La identificación de problemas se basa en las lecciones aprendidas en los artículos anteriores.Para aprovechar al máximo este artículo le recomendamos que termine suPrimer escaneo.

Sistema de calificación de calidad del código de Browserstack

El sistema de calificación de calidad del código Browserstack es una representación numérica de la calidad del software.La calificación se calcula en todos los niveles;Para una función, un método, un componente, un paquete y la salud general del software.Varía de -5 a 5, donde -5 indica una calificación muy mala y, por lo tanto, mala calidad, y 5 indica que el software está diseñado excepcionalmente.Cuando analizamos el repositorio de texto comunes para la versión 1.2 para preparar este artículo, tenía una calificación general de 2.74, lo cual es bastante bueno.La calificación se muestra en un proyecto y a nivel de repositorio al observar el número dentro del círculo coloreado.Esto ya le permite comparar rápidamente la calidad entre sus proyectos y repositorios una vez que haya escaneado más de uno.

¿Qué está afectando la calificación de calidad del código Browserstack?

Haga clic en el mosaico de repositorio "Commons-Tex".Esto lo traerá directamente a los resultados del escaneo anterior de este repositorio.Más específicamente, le mostrará el tablero del repositorio para el último escaneo.Las primeras áreas en las que se centraron son las clasificaciones que se muestran en las fichas.Lo que se muestra es la calificación general, luego la calificación de ciertos aspectos del código, como el diseño, los problemas del código, las métricas y la duplicación.Todas estas calificaciones contribuyen a la clasificación general de la calidad del código Browserstack.

Inicio rápido: documentos de calidad de código (6)

Leer la descripción general del repositorio

La descripción del repositorio muestra el estado general de su software de un vistazo.Hay dos formas de llegar a esta vista;Puede hacer clic en el mosaico de "calificación general", o puede navegar a la barra de resumen del nodo en la parte superior de su página y hacer clic en el tercer nodo que muestra el número de calificación general.
La sección superior de la página de descripción general muestra información general sobre el repositorio, como la calificación general, el historial de las diferentes clasificaciones de escaneo, las líneas totales de código (LOC), elcantidadde componentes y elcantidadde puntos calientes.La línea de color amarillo verde entre la calificación y la otra información que se muestra en la página indica la clasificación del escaneo.A medida que escanee el repositorio nuevamente para cada nueva actualización, habrá más líneas de diferentes altura y color para indicar la tendencia de las nuevas actualizaciones.Bajo eso, puede ver que el repositorio de texto comunes tiene 27.095 LOC, 13.808 de los cuales son ejecutables, 160 componentes (clases en Java) y noPuntos calientes, que es un componente con una calificación general negativa.

Inicio rápido: documentos de calidad de código (7)

Según la descripción general, hay información más detallada sobre los otros componentes;Diseño, métricas, duplicación y problemas de código.Con una calificación de 4.68, el diseño del código está bien hecho y tiene problemas mínimos.La calificación de métricas es bastante baja en 0.62, lo que se debe en su mayor parte al número de métodos (nom) y complejidad y respuesta para violaciones de clase (RFC).La duplicación tiene una calificación de 3.48, con 21 clones de un tamaño promedio de 58 líneas, y los problemas de código tienen una calificación de 3.88 con 30 problemas altos, pero sin críticos.

Inicio rápido: documentos de calidad de código (8)

Usando la barra de resumen del nodo

La misma información de la descripción del repositorio se muestra en la barra de resumen del nodo en la parte superior de la pantalla.Al pasar el ronco sobre esta barra, puede ver la misma información de las calificaciones y los hallazgos clave.

Inicio rápido: documentos de calidad de código (9)

Navegando a través de su código

Puede navegar a través de su árbol de código fuente con la ruta sobre la barra de resumen del nodo, o puede abrir directamente la bandeja de navegación del árbol haciendo clic en el icono en la parte superior izquierda.

Inicio rápido: documentos de calidad de código (10)
Inicio rápido: documentos de calidad de código (11)

Ver e interpretar el mapa de calor

¿Qué muestra el mapa de calor?

Se puede acceder al mapa de calor desde la barra de navegación superior haciendo clic en el icono del cuadro junto al icono de fuego:

Inicio rápido: documentos de calidad de código (12)

Al hacer clic en ella, lo traerá a la página HeatMap, que muestra los componentes principales de su repositorio.Cada componente se representa como un rectángulo, donde el tamaño del rectángulo representa el tamaño (líneas de código) de este componente, y el color representa la calificación.Al flotar sobre los rectángulos con el mouse, se muestra el nombre del componente, así como su calificación en la escala de calificación.

Inicio rápido: documentos de calidad de código (13)

Uso de mapa de calor

El mapa de calor se puede usar para dos cosas:
1. Comprender la calidad general de su software.
2. Identificar componentes para investigar más

El control deslizante en la parte superior del mapa de calor se puede usar para resaltar los componentes específicos que caen en las diferentes clasificaciones.Por ejemplo, se puede usar para resaltar todos los componentes con una calificación inferior a 1.5.

Inicio rápido: documentos de calidad de código (14)

Los componentes naranjas grandes son indicativosparaproblemas que necesitan más investigación.Cuando hace clic en uno de los componentes, se le lleva al Explorador de componentes.Aquí, puede navegar a través de los diferentes problemas de código y ver las líneas exactas donde reside el problema.En este caso, el componente StrBuilder parece ser un candidato prometedor para una investigación más profunda, ya que tiene una calificación de solo 0.73 (casi un punto de acceso) y es bastante grande.
Para aprender cómo puede usar el Componente Explorer para mejorar la puntuación, eche un vistazo aMejora de los puntos de acceso.

Identifique sus principales prioridades con la lista de componentes

¿Qué muestra la lista de componentes?

Se puede acceder a la lista de componentes desde la barra de resumen del nodo haciendo clic en el icono de la lista:

Inicio rápido: documentos de calidad de código (15)

Será redirigido a una página que muestra una lista de todos los componentes de su software ordenados por la puntuación general ascendente.Los componentes con el peor puntaje están en la parte superior.Junto a la puntuación general, se muestran las sub-calificaciones para el diseño, las métricas, la duplicación y los problemas de código.

Inicio rápido: documentos de calidad de código (16)

La lista puede ser ordenada por cualquiera de estas calificaciones para permitirle encontrar los principales problemas dependiendo de la categoría que desee mejorar primero, como la calidad del diseño.

Inicio rápido: documentos de calidad de código (17)

¿Cómo usar la lista de componentes?

En nuestro ejemplo con Apache Common-Text, los tres peores componentes por calificación general son StrSubstitutor, StrBuilder y StrBuilderAppendInsertTest.Dado que el tercer componente representa pruebas de software, sería mejor centrarse en los otros dos.Para ingresar al nivel de código, haga clic en el nombre del componente y lo redirigirá al Explorador de componentes.

Inicio rápido: documentos de calidad de código (18)

Cuando clasifica por calificación de diseño, hay otros dos componentes que tienen la peor calificación y estarán en la parte superior de la lista.

¿Cómo evaluar el riesgo?

La clasificación de riesgo de calidad del código Browserstack se muestra en la primera columna, junto al nombre del componente.Si bien la calificación general representa la calidad del software de un componente, la calificación de riesgo se trata de cuánto impacto tendría este componente en su software si algo sale mal.Para algunos proyectos, es aceptable que un componente tenga una calificación general baja si el riesgo relacionado con él es bajo.Pero si un componente tiene una calificación de alto riesgo con una puntuación general baja, debe tratarse rápidamente.

En general, el componente strsubstitututor parece ser el componente que necesita más atención.Tiene el puntaje de calidad del código general más bajo de Browserstack, el segundo puntaje de diseño más bajo, un riesgo superior al promedio y no es un componente de prueba.Para averiguar cómo la calidad del código Browserstack ayuda a mejorar los componentes, eche un vistazo a suMejora de los puntos de acceso.

Características más avanzadas

El menú de parámetros en el lado derecho, la lista de componentes se puede usar para características más avanzadas.Puede filtrar las filas mostradas por su estado de hotspot o por varios tipos de componentes.

Inicio rápido: documentos de calidad de código (19)

La lista de componentes también se puede usar para mostrar más información que solo las calificaciones: también puede mostrar todas las métricas calculadas y los detalles de duplicación.Esto se puede seleccionar del menú desplegable de columnas en el lado derecho.Puede ver más información sobre las métricasaquí.

Inicio rápido: documentos de calidad de código (20)

Bucear a través de distribuciones de problemas

Las secciones anteriores mostraron cómo identificar componentes potenciales de baja calidad que necesitan más atención, ya sea a través delMapa de caloro elLista de componentes.En esta sección, la atención se centra en dos aspectos diferentes:
1. Identificar paquetes problemáticos
2. Identificar clases de problemas que conducen a mala calidad

¿Cuáles son las pantallas de distribución disponibles?

Inicio rápido: documentos de calidad de código (21)

Se puede acceder a las pantallas de distribución desde la barra de navegación superior:
Browserstack Code Quality actualmente muestra cinco tipos diferentes de distribuciones:

  • Distribución de problemas de diseño
  • Distribución de problemas de código
  • Distribución de métricas
  • Distribución de duplicación
  • Distribución de puntos de acceso

Haga clic en "51 problemas de código" para acceder a la distribución del problema del código ahora.

¿Qué muestra la pantalla de distribución de código?

La pantalla de distribución siempre muestra el número de problemas que afectan el nivel de paquete actual que se seleccionó de la navegación del árbol.Use el navegador en la parte superior derecha y siga esta ruta: SRC → Principal → Java → org → Apache → Commons → Texto, el "texto" Seleccionar "esta secciónpara aprender a usar la navegación del árbol).Tu pantalla debería verse así:

Inicio rápido: documentos de calidad de código (22)

Lo que se puede ver es que se han encontrado 12 problemas de código altamente priorizados en el archivo str.subsitutor.java.El menú de parámetros en el lado derecho de la pantalla se puede usar para cambiar a una vista diferente;Úselo y seleccione "Módulos frente a tipos de problemas".

Inicio rápido: documentos de calidad de código (23)

Este gráfico muestra con qué frecuencia se han encontrado ciertos tipos de problemas de código.Para el texto comunitario, los problemas identificados con mayor frecuencia han sido "constructivalSoverridableMethod" y "EvitchingStatementaSlastinloop".Estos problemas siempre son específicos para el lenguaje de programación utilizado, por lo que estos problemas son específicos de Java.Para obtener más información sobre estos problemas, haga clic en el gráfico.Para obtener información general sobre cada uno de estos tipos de problemas, visite nuestroCódigo emite documentación.

Inicio rápido: documentos de calidad de código (24)

Mejora del punto de acceso

Browserstack Code Quality ayuda a analizar sus datos.Hay algunas formas a través de las cuales se puede mejorar el punto de acceso:

Uso del Componente Explorer para solucionar problemas

Antes de empezar

Antes de comenzar este tutorial, asegúrese de tener:
1. Una cuenta de calidad de código BROWSERTACK ACTIVO (¿no tienes una?Regístrese gratis aquí).
2. Pasé por tuPrimer escaneoyIdentificación de problemas, yEvaluación de cambios.Mejorar el artículo de los puntos de acceso incorpora las lecciones aprendidas en estos artículos anteriores.

Análisis de la clasificación de componentes

EnIdentificación de problemas, el componente StrSubstitututor de Apache Commons-Tex 1.2 podría ser problemático y requiere una mayor investigación.Navegar a este componente seleccionandoprimeroSe selecciona una instantánea en el menú desplegable y luego use ellista de componenteso elmapa de calorpara navegar a este componente.

Inicio rápido: documentos de calidad de código (25)

En la parte superior del explorador de componentes, la barra de resumen del nodo muestra los puntajes de calidad del código Browserstack para este componente específico.StrSubstitutor tiene una calificación general de 0.68, una calificación de diseño de 3.34, una calificación de emisión de código de –0.19, y así sucesivamente.Al pasar el paso sobre estas calificaciones, se muestra información adicional.Por ejemplo, el rondado de la clasificación de diseño revela que este componente se considera una clase de cerebro.Una clase de cerebro es una clase que contiene demasiadocomplejidad,y a menudo contiene uno o más métodos cerebrales.

Rovering sobre la puntuación de métricas abre los valores métricos reales para este componente.StrSubstitutor tiene una complejidad de 102, consta de 452 declaraciones, 57 métodos, etc.Los valores en rojo indican que una determinada métrica viola nuestro umbral y, por lo tanto, se considera subóptimo.Obtenga más información sobre nuestras métricas y sus umbrales en nuestrodocumentación.

Inicio rápido: documentos de calidad de código (26)

Investigar áreas problemáticas del código

Debajo de los puntajes del componentevidasUna vista del código fuente de esta instantánea.El código en sí se muestra en el lado derecho, mientras que todos los hallazgos específicos del código están en el lado izquierdo.Hay tres tipos diferentes de hallazgos:
1. Método Nivel antipatrones
2. Duplicación
3. Problemas de código

Inicio rápido: documentos de calidad de código (27)
1. Método Nivel antipatrones

Existe una multitud de medtaterns de nivel de método que puede detectar la calidad del código Browserstack.Para obtener una descripción completa, visite nuestra documentación contra el patrón.Un hallazgo interesante dentro de StrSubstitutor es el sustituto del método cerebral.Un método cerebral es un método que tiende a centralizar la funcionalidad de su clase de propietario.Tiende a ser mucho tiempo, ya que lleva a cabo la mayoría de las tareas de la clase que se supone que se distribuyen entre varios métodos.
La reparación de un nivel de método antipatrón depende del tipo de problema.En este caso, el problema puede resolverse simplificando el método "sustituto".Debe reescribirse o dividirse en múltiples métodos más simples.
La reparación del problema del método del cerebro conducirá a una puntuación de diseño más alta e incluso podría resolver el antipatrón de nivel de componente (clase de cerebro) de este componente.

2. Duplicación

Después de hacer clic en la duplicación, se muestran todas las áreas del código fuente que aparecen en más de un lugar.En este ejemplo, hay un bloque de 22 líneas de código que aparece dos veces en la misma clase.En otros ejemplos, también podría ser bloques duplicados en diferentes componentes.El código duplicado se destaca en azul en el explorador de componentes.

Inicio rápido: documentos de calidad de código (28)

Para solucionar este problema, el código fuente de las dos sección duplicada debe reescribirse de una manera que no requiere el mismo código dos veces.Esto podría hacerse moviendo el código duplicado a una nueva función que sea responsable de la funcionalidad común y las otras dos funciones llamarán que actualmente contienen el código duplicado.

3. Problemas de código

La tercera sección del Componente Explorer enumera todos los problemas de código encontrados por la calidad del código BrowserStack.Los problemas de código son violaciones de ciertas reglas de código y se pueden configurar para cada repositorio.Para obtener una lista completa de problemas de código, visite nuestrodocumentación.

Se encontraron doce problemas de alta prioridad y tres prioridades medianas en el componente StrSubstitutor.Al hacer clic en el problema en la barra izquierda, lo lleva directamente a la ubicación donde se ha encontrado el problema seleccionado.Rovering sobre el símbolo {x} en la canaleta del editor revela información adicional sobre el problema específico, y hacer clic en el texto del flujo se mostrará una descripción completa y profunda.

Inicio rápido: documentos de calidad de código (29)

Se arreglar un problema de código depende del problema específico que se haya encontrado.El problema anterior podría solucionarse al no reasignar el parámetro del método "priorvariables", sino trabajando con un nuevo campo temporal dentro del método.Esto también se describe en la ventana emergente al hacer clic en ella.

Inicio rápido: documentos de calidad de código (30)

Analizar dependencias

Después de navegar al explorador de componentes de un determinado componente, se puede acceder a la vista de dependencia a través del menú superior:

La vista de dependencia puede mostrar todas las dependencias entrantes o salientes de un componente.Las dependencias salientes están describiendo los componentes utilizados por el componente actual, las dependencias entrantes muestran qué otros componentes usan el componente actual.El color de la línea de conexión entre dos componentes indica la calificación respectiva de un componente conectado.Esto se puede usar para ver fácilmente qué componentes de baja calificación utilizan el componente actual.Strsubstitutor depende de strbuilder, strlookupyStrmatcher.
StrBuilder tiene una calificación media indicada por el color naranja de la conexión, por lo que esta es una dependencia que debe vigilarse cuidadosamente cuando se desarrolla en StrSubstitutor.Para ver múltiples niveles de dependencias, puede hacer clic en los pequeños círculos después de cada nombre del componente.Esto puede ser especialmente útil al analizar un problema de diseño basado en dependencia, como mariposas globales/locales o rompibles globales/locales.

Inicio rápido: documentos de calidad de código (31)

Usando el editor de particiones

Cuándo usar el editor de particiones

Hay muchos problemas que son el resultado de que las clases son demasiado grandes.Esto puede variar desde componentes que están ligeramente por encima de las líneas recomendadas de umbral de código (como strsubstitutor) hasta componentes grandes conno-cohesivofuncionalidad (como las clases de Dios).
Una estrategia común para tratar con tales componentes es dividirlos en múltiples componentes más pequeños.De esta manera, cada componente proporciona una abstracción limpia y una funcionalidad cohesiva.Desafortunadamente, hacer este tipo de refactorización puede ser bastante complicado, especialmente cuando se trata de clases muy grandes.El editor de particiones está destinado a hacer que este tipo de refactorización funcione más eficiente.

Cómo usar el editor de particiones

Se puede acceder al editor de particiones haciendo clic en el botón correspondiente en el menú superior en el nivel de componente de su árbol de código fuente:

Inicio rápido: documentos de calidad de código (32)

Basado en un algoritmo de partición y procesamiento del lenguaje, recomienda una forma de dividir el componente actual en múltiples componentes más pequeños.Con la entrada de rango en la parte superior, se puede definir la granularidad del algoritmo de partición.Cuanto mayor sea el rango, más fino es la partición recomendada.

Inicio rápido: documentos de calidad de código (33)

La captura de pantalla anterior muestra una partición de muestra del componente StrSubstitutor en una granularidad de 8. Muestra que es posible dividir este componente en aproximadamente tres componentes más pequeños, así como en algunos menores.Al hacer clic en una de las burbujas, muestra qué atributos y métodos del componente se sugiere que se pongan en esa partición

Evaluación de cambios

Analice y comprenda rápidamente el impacto de los cambios en el código en su software.

Ver el impacto del cambio

Antes de empezar

Antes de comenzar este artículo, asegúrese de tener:
1. Una cuenta de calidad de código BROWSERTACK ACTIVO (¿no tienes una?Regístrese gratis aquí).
2. PasóTu primer escaneoyIdentificación de problemas.La evaluación de los cambios se basa en las lecciones aprendidas en los artículos anteriores.Para aprovechar al máximo este artículo, le recomendamos que termine los otros dos primero.

Escaneo de múltiples instantáneas

La pantalla de descripción general de cambios le permite comparar la calidad de dos versiones diferentes de su software.Para esto, debe tener dos instantáneas en la calidad del código Browserstack.Una instantánea representa el estado de su repositorio en cualquier momento dado y se crea como resultado de escanear su software.Si aún no lo ha hecho, sigaPrimer escaneoPara crear su primera instantánea de Apache-Commons versión 1.2.A continuación, realice un segundo escaneo de Apache-Commons y escanee la etiqueta "Commons-Text-1.3".Puede hacer esto haciendo clic en escanear en la esquina superior derecha después de ingresar a su repositorio:

Inicio rápido: documentos de calidad de código (34)

Después de esto, seleccione la etiqueta "Commons-Text-1.3" y haga clic en "Escanear".Una vez finalizado el escaneo, se crea una segunda instantánea que representa Apache-Commons 1.3.

Uso de la pantalla de descripción general de cambio

Navegue a la pantalla Descripción general de cambio utilizando la barra de navegación superior.

Inicio rápido: documentos de calidad de código (35)

Seleccione las dos instantáneas que desea comparar.Por defecto, la instantánea actual se selecciona como el lado derecho de la comparación, que representa la versión 1.3 de Commons-Text.Seleccione la instantánea anterior para el lado izquierdo de la comparación.

Inicio rápido: documentos de calidad de código (36)

En los cambios de cambios muestra que se agregaron 7160 líneas de código ejecutables entre la versión 1.2 y 1.3, y la puntuación general disminuyó en 1.29 puntos.Use el menú desplegable para ver los cambios en las sub-calificaciones, para métricas, diseño, duplicación y problemas de código.

Inicio rápido: documentos de calidad de código (37)

En la descripción general del cambio, se muestran todas las mejoras y el deterioro de los puntos de acceso.En la versión 1.3, se agregaron cinco nuevos puntos de acceso y tres componentes se convirtieron en puntos de acceso.Al hacer clic en ellos, mostrará una vista más detallada de los problemas.

Inicio rápido: documentos de calidad de código (38)
¿Qué me dice?

La descripción general del cambio muestra que entre la versión 1.2 y 1.3, la calidad del software del texto comunitario disminuyó de manera bastante significativa.Al observar la calificación de duplicación, se hace evidente que se agregó mucho código duplicado.Además, se agregaron cinco nuevos componentes del punto de acceso, que tienen una calificación por debajo de cero.Un cambio negativo que este drástico debe discutirse dentro del equipo de desarrollo para identificar las causas raíz y encontrar formas de establecer un proceso de mejora continua.

Como resumen, la descripción general del cambio se usa principalmente para dos propósitos:
1. Revisión del código recién desarrollado, es decir, para una nueva función o una solicitud de extracción.
2. Revisar periódicamente la calidad general, es decir, después de cada ciclo de sprint o liberación.

Cavar a cambios detallados

Usando la lista de componentes cambiados

ElTu primer escaneoEl artículo muestra cómo usar la descripción general del cambio para evaluar rápidamente el impacto de los cambios en el código;Esta parte muestra cómo analizar cambios detallados y su impacto.Para ver esto, haga clic en el icono de la lista de componentes cambiados en la barra de navegación:

Inicio rápido: documentos de calidad de código (39)

Esta lista es similar a la lista de componentes estándar introducida enIdentificación de problemas.La diferencia es que, además de mostrar puntajes y valores actuales, también muestra el cambio en los valores específicos de las versiones seleccionadas en el menú desplegable superior.

Inicio rápido: documentos de calidad de código (40)

El componente con el nombre "strBuilderTest" tiene una calificación de -0.37 en la instantánea creada el 21 de septiembre. En comparación con la instantánea el 20 de septiembre, disminuyó en 2 puntos, indicado por el número rojo.

Utilización de características avanzadas de la lista de componentes cambiados

Además de clasificar la lista por el valor de puntuación actual, también se puede ordenar por el valor de diferencia.Esto puede ayudar a responder preguntas como "qué componente disminuyó más en su puntaje de diseño" o "qué componente eliminó la mayoría de sus duplicaciones anteriores".

Inicio rápido: documentos de calidad de código (41)

Otra característica avanzada es cambiar las columnas para mostrar las métricas específicas en lugar de las puntuaciones.Esto se puede hacer cambiando el menú desplegable de la columna a métricas en el menú de parámetros correctos.Esto puede responder preguntas como "qué componente aumentó su complejidad más" o "qué componente obtuvo la mayor nueva línea de código".

Inicio rápido: documentos de calidad de código (42)
Inicio rápido: documentos de calidad de código (2024)
Top Articles
Latest Posts
Article information

Author: Nicola Considine CPA

Last Updated:

Views: 6228

Rating: 4.9 / 5 (69 voted)

Reviews: 92% of readers found this page helpful

Author information

Name: Nicola Considine CPA

Birthday: 1993-02-26

Address: 3809 Clinton Inlet, East Aleisha, UT 46318-2392

Phone: +2681424145499

Job: Government Technician

Hobby: Calligraphy, Lego building, Worldbuilding, Shooting, Bird watching, Shopping, Cooking

Introduction: My name is Nicola Considine CPA, I am a determined, witty, powerful, brainy, open, smiling, proud person who loves writing and wants to share my knowledge and understanding with you.