Solucionar problemas de rendimiento del analyzer

Esta guía te ayuda a diagnosticar y resolver problemas comunes de rendimiento del servidor de análisis de Dart en tu IDE de Dart o Flutter.

Varios problemas comunes afectan significativamente el rendimiento de el servidor de análisis de Dart (el analyzer). Revisa los siguientes problemas para ver si podrían estar afectando tu entorno de desarrollo.

En sistemas Windows, si Windows Defender (u otro software de seguridad en tiempo real) está habilitado, puede ralentizar los tiempos de lectura de archivos lo suficiente como para afectar el rendimiento del analyzer. El analyzer lee archivos con frecuencia, y el escaneo constante puede introducir latencia. Para mitigar esto, puedes configurar exclusiones para los directorios de los cuales lee el analyzer.

Si eliges configurar exclusiones, incluye los siguientes directorios:

• El directorio de caché del servidor de análisis: %LOCALAPPDATA%\.dartServer
• El directorio para los paquetes descargados por pub: %LOCALAPPDATA%\Pub\Cache
• Cualquier otro directorio que contenga código para tus aplicaciones.

Para otra forma de mejorar el rendimiento de E/S de archivos, considera configurar una unidad dev (dev drive).

Si el directorio de tu paquete contiene enlaces simbólicos que apuntan a una ubicación dentro del mismo directorio, o a un directorio padre, podrías experimentar problemas de rendimiento con las herramientas de Dart (como el analyzer).

Estado: El equipo de Dart está trabajando activamente en una solución para este problema.

Solución alternativa: No se conocen soluciones alternativas en este momento.

Si los problemas conocidos no parecen aplicarse a tu situación, por favor abre un reporte en el rastreador de problemas de Dart SDK. Cuanta más información proporciones, más rápido podrá el equipo diagnosticar y solucionar el problema.

En tu reporte de problema, por favor proporciona pasos detallados para reproducir el comportamiento que estás observando.

1. Si estás trabajando en un proyecto de código abierto, incluye instrucciones para descargar el código.
2. Si no puedes compartir tu código, crea un caso de reproducción pequeño y autónomo.
3. Si no puedes proporcionar ninguno de los dos, indícalo en el reporte.

Si el problema está relacionado con el rendimiento, proporcionar datos de rendimiento puede ser de gran ayuda. Puedes recopilar estos datos usando las páginas de diagnóstico del servidor de análisis:

1. Open the Analyzer Diagnostics page:
   • If you are using VS Code:
     1. Haz clic en Ver > Paleta de comandos (View > Command Palette).
     2. Escribe Dart: Open Analyzer Diagnostics y selecciónalo.
   • If you are using IntelliJ / Android Studio:
     1. Abre la ventana de herramientas Dart Analysis.
     2. Haz clic en el icono de configuración y luego selecciona View analyzer diagnostics.
2. Collect the report:
   1. En la página del navegador que se abre, haz clic en Collect Report en el banner superior.
   2. Realiza las acciones que desencadenan el comportamiento lento.
   3. Haz clic en el enlace Download report.
3. Attach the report to your issue.

En algunos casos, los registros de instrumentación pueden proporcionar detalles adicionales para diagnosticar problemas.

Para capturar estos registros:

• VS Code: Sigue las instrucciones para capturar registros de instrumentación del analyzer.
• IntelliJ / Android Studio: Sigue las instrucciones de instrumentación del analyzer.

Antes de adjuntar registros a un problema de GitHub, revísalos cuidadosamente para asegurarte de que no contengan información personal, sensible o confidencial.