BuildSmith

Зачем BuildSmith

Возможности

• Время в строке состояния после каждой сборки и разница с предыдущей сопоставимой сборкой: ⏱ 1 min 48 s (▲ 4.1 s).
• Окно «Временная шкала сборки»: по полосе на проект в порядке запуска, обведённый критический путь, заштрихованные актуальные проекты, красные — неудавшиеся, и разница с предыдущей сборкой рядом с каждой полосой.
• Никогда не актуальны: проекты, которые собираются при каждой инкрементной сборке, хотя большая часть решения актуальна, — и во что они обходятся каждой сборке.
• История всех сборок решения, по умолчанию хранится неделю: поиск, диапазоны дат, календарь и полосы, по которым сразу видно, какая сборка была медленной.
• Метки — «до исправления», «новый SDK» — одним из пяти цветов или своим; сборка с меткой или закреплённая сборка никогда не удаляется по возрасту.
• Сравнение от 2 до 10 сборок: тренд общего времени и таблица «проекты × сборки» с цветной разницей, спарклайнами и критическим путём — копируется в Markdown для пул-реквеста.
• Выключение без удаления: для одного решения или везде; история сохраняется.

Сборка с первого взгляда

Откройте Сборка › Временная шкала сборки (также в Вид › Другие окна и на панели инструментов SmithWorks). Окно показывает последнюю сборку — или любую сборку из истории — со сводкой вверху и полосой на каждый проект ниже.

Время в строке состояния

После каждой сборки строка состояния Visual Studio показывает её время и разницу с предыдущей сопоставимой сборкой: ⏱ 1 min 48 s (▲ 4.1 s) — ▲ медленнее, ▼ быстрее. Это единственное, что BuildSmith показывает сам, и это можно выключить в настройках.

Сопоставимая — значит того же вида (сборка или перестроение), с той же конфигурацией, той же платформой и в той же ветке Git. Если такой сборки ещё нет, показывается только время.

Заголовок

Верх окна подводит итог показанной сборки:

Полосы

Наведите курсор на полосу, чтобы увидеть подробности: сколько длился проект, с какого и по какой момент после старта сборки, разницу с предыдущей сборкой и был ли он на критическом пути.

Окно можно держать открытым во время работы: оно само переходит к каждой новой сборке. Вкладки Временная шкала, Сравнение и История — вверху.

Никогда не актуальны

Некоторые проекты собираются при каждой сборке, даже если в них ничего не изменилось. Каждый раз это стоит нескольких секунд, и никто этого не замечает. BuildSmith замечает: над временной шкалой инкрементной сборки полоска сообщает, сколько таких проектов и во что они обходятся каждой сборке. Она раскрывается в список проектов; их строки на временной шкале получают отметку ⟳.

Правило: проект отмечается, если он собирался в каждой из последних 3–5 инкрементных сборок той же конфигурации и ветки, когда больше половины решения было актуально. Перестроения не в счёт — там всё собирается намеренно.

Типичные причины:

• файл с Копировать в выходной каталог: Всегда копировать — достаточно Копировать, если новее;
• шаг перед сборкой или после неё, который трогает файл, от которого зависит проект;
• код, генерируемый при каждой сборке, даже если его исходник не менялся.

Исправив это, вы сэкономите это время на каждой сборке. Полоску можно выключить в настройках: Указывать проекты, которые никогда не бывают актуальными.

История

Вкладка История перечисляет записанные сборки решения, новые сверху, сгруппированные по дням. В каждой строке — время, вид сборки, конфигурация и ветка, метка и полоса, пропорциональная времени сборки: медленная сборка сразу бросается в глаза.

Найти сборку

Введите текст в поле поиска — каждое слово должно найтись в метке, ветке, конфигурации или виде сборки. Сузьте по дате кнопками Сегодня, Вчера и сегодня, 7 дней или Все либо выберите даты в календаре (Даты…). Только с метками оставляет сборки, которым вы поставили метку.

Открыть, пометить, закрепить, удалить

Щёлкните сборку (или нажмите Enter), чтобы открыть её на временной шкале. По правому щелчку — Открыть на временной шкале, Метка…, Хранить (не удалять) и Удалить. Клавиша Delete удаляет сборку, а несколько секунд доступна кнопка Отменить. Меню ⋯ удаляет сборки старше даты, очищает историю этого решения или всех решений.

Отметьте сборки, чтобы сравнить их или удалить несколько сразу. Отметить с метками отмечает все показанные сборки с меткой — самый быстрый способ сравнить «до» и «после».

Сколько хранятся сборки

Сборки хранятся только на этом компьютере, в %LocalAppData%\BuildSmith, по истории на решение — 1 день, 3 дня, 1 неделю (по умолчанию), 2 недели или 1 месяц. Более старые сборки удаляются при открытии решения или по окончании сборки. Сборки с метками и закреплённые остаются, сколько бы им ни было.

Метки

🏷 в заголовке (или Метка… в меню истории) даёт сборке короткий текст и цвет: один из пяти или свой — из небольшой палитры с недавними цветами. Недавние метки предлагаются снова в один щелчок, так что у серии сборок может быть одна метка.

Сборка с меткой никогда не удаляется по возрасту (если не выключить Хранить сборки с метками). Хранить (не удалять) закрепляет сборку без метки.

Запись

⏻ в заголовке определяет, записываются ли сборки:

Во сне BuildSmith действительно ничего не делает: не подписывается на события сборки, ничего не пишет ни в строку состояния, ни на диск. История остаётся, а окно предлагает Снова записывать сборки.

Сравнение сборок

Вкладка Сравнение ставит сборки рядом: помогло ли исправление, какой проект замедлился после обновления, как менялось время сборки за неделю.

Выбор сборок

Отметьте от 2 до 10 сборок на вкладке История и нажмите ⇄ Сравнить (N). Без отметок вкладка Сравнение показывает текущую сборку против предыдущей сопоставимой. Сборки появляются плашками вверху; ✕ убирает сборку из сравнения.

Тренд и таблица

Небольшой график показывает общее время каждой сборки. Под ним — таблица «проекты × сборки»: каждая ячейка окрашена по разнице с первой сборкой — чем теплее, тем медленнее, зелёный — быстрее, — со спарклайном, разницей и ● там, где проект был на критическом пути. Проекты без заметных изменений свёрнуты в строку … ещё N без заметных изменений.

Только нужные проекты

Кнопка Проекты: … фильтрует таблицу: Все проекты (N), Заметно изменились (N), На критическом пути (N) или Только отмеченные, с полем поиска. Фильтр запоминается для каждого решения, и тренд тогда суммирует время отфильтрованных проектов — тренд ваших проектов, а не всего решения.

Один проект во всех сборках

Щёлкните проект, чтобы увидеть его полосы во всех сравниваемых сборках; обведённая полоса означает, что в той сборке он был на критическом пути. ‹ Все проекты возвращает назад.

Копирование в Markdown

⧉ Копировать помещает таблицу в том виде, в каком вы её видите, — те же сборки, тот же фильтр — в буфер обмена как таблицу Markdown, готовую для пул-реквеста или чата. В режиме одного проекта копируется этот проект.

Настройки

Средства › Параметры › SmithWorks › BuildSmith (или ⚙ в окне «Временная шкала сборки»). У каждого параметра есть краткое описание того, что он делает.

Параметр	По умолчанию
Записывать сборки	вкл.
Не записываются:	Ни одно решение не выключено.
Хранить сборки:	1 неделя
Хранить сборки с метками	вкл.
Время в строке состояния	вкл.
Указывать проекты, которые никогда не бывают актуальными	вкл.
Попросить оценку в Marketplace	вкл.

Очистить всю историю (решений: N, размер)… удаляет записанные сборки всех решений и спрашивает, оставить ли сборки с метками и закреплённые. Внизу: Сбросить по умолчанию, Документация, Оценить на Marketplace и Обратная связь.

Настройки и история хранятся в %LocalAppData%\BuildSmith.

Вопросы и ответы

История изменений

1.0.0

• Первый выпуск: время сборки и его изменение в строке состояния, окно «Временная шкала сборки» с критическим путём, проекты, которые никогда не актуальны, история с поиском, датами и метками, сравнение до 10 сборок с копированием в Markdown, включение и выключение записи для каждого решения, панель инструментов SmithWorks, однократная просьба об оценке.