Utilities  Version: 0.2.2 Revision: ??? Platform: x64 Build: 21:59 13.12.2024
Решение для тестирования сторонних утилит
Загрузка...
Поиск...
Не найдено
Вычисление метрик кода в решении
Заметки
Для вычисления метрик кода С++ используется утилита SourceMonitor.

Для вычисления метрик кода при сборке решения скриптом необходимо:

  • Создать и настроить проект SourceMonitor.
  • Подключить к решению проект ProcessingMetrics.
  • Подключить к проекту BuildAll файл страницы свойств Metrics.props.
  • Добавить в документацию решения страницу с рультатами подсчета метрик.

Настройка проекта SourceMonitor

Запустить SourceMonitor, создать новый проект, в первом окне мастера выбрать С++, в качестве Include вставить '.cpp;.h;.hpp;.inl', в качестве Exclude - '.mock.hpp;.mock.inl;stdafx.*;pch.h;targetver.h;*.forward.hpp'.

Во втором окне мастера указать в качестве имени проекта Metrics (проект именно с этим именем будет запускать скрипт), а в качестве пути к папке проекта - полный путь к папке Solution решения ($(SolutionDir)\Solution).

В третьем окне мастера указать в качестве пути для обработки вложенную папку Solution.

Настроить вложенные папки для обработки, исключив папки тестовых проектов и документации.

В четвертом окне мастера указать особые параметры проекта.

В пятом окне мастера указать формат проекта.

В шестом окне мастера настроить создание первой контрольной точки.

Подключение проекта ProcessingMetrics

Подключить к решению (в любую папку) проект Metrics из папки $(SolutionDir)\Solution\Solution\Externals\Tools\ProcessingMetrics и добавить проекту BuildAll зависимость от этого проекта.

Заметки
Эта утилита обрабатывает результат расчета метрик кода и формирует файл отчета для включения в документацию Doxygen.

Подключение страницы свойств Metrics.props

К конфигурации Debug|x64 проекта BuildAll подключить страницу свойств $(SolutionDir)\Solution\Solution\Externals\Metrics.props

Заметки
Эта страница свойств содержит скрипт подсчета метрик кода и запуск утилиты обработки результата.

Страница документации с результатами расчета метрик кода

В документацию решения добавить страницу с именем SolutionMetricsPage, содержащую включение файла Metrics.result.html

\page SolutionMetricsPage Метрики кода в решении
\subpage SolutionMetricsFilesPage
Статистика расчета метрик кода
------------------------------
\htmlinclude "Solution\Props\Metrics.props\‍(Documentation).result.html"

Также добавить страницу SolutionMetricsFilesPage, содержащую список наиболее проблемных мест в коде для каждой метрики.

\page SolutionMetricsFilesPage Проблемные места
\htmlinclude "Solution\Props\Metrics.props\‍(Documentation).result.warning.html"