BuildSmith

Proč BuildSmith

Funkce

• Čas na stavovém řádku po každém sestavení se změnou oproti předchozímu srovnatelnému sestavení: ⏱ 1 min 48 s (▲ 4.1 s).
• Okno Časová osa sestavení: jeden pruh na projekt v pořadí, v jakém začaly, orámovaná kritická cesta, aktuální projekty šrafované, neúspěšné červeně a u každého pruhu změna oproti předchozímu sestavení.
• Nikdy aktuální: projekty, které se sestavují při každém přírůstkovém sestavení, ačkoli většina řešení byla aktuální — a kolik stojí při každém sestavení.
• Historie všech sestavení řešení, ve výchozím stavu uchovávaná týden: hledání, rozsahy dat, kalendář a pruhy, ze kterých je na první pohled vidět, které sestavení bylo pomalé.
• Štítky — „před opravou“, „nové SDK“ — v jedné z pěti barev nebo ve vlastní; sestavení se štítkem nebo ponechané sestavení se kvůli stáří nikdy neodstraní.
• Porovnání 2 až 10 sestavení: trend celkových časů a tabulka projekty × sestavení s barevnými změnami, minigrafy a kritickou cestou — lze ji zkopírovat jako Markdown do pull requestu.
• Vypnutí bez odinstalace: pro jedno řešení nebo všude; historie zůstane.

Sestavení na první pohled

Otevřete Sestavení › Časová osa sestavení (také v Zobrazit › Další okna a na panelu nástrojů SmithWorks). Okno ukazuje poslední sestavení — nebo libovolné z historie — se souhrnem nahoře a jedním pruhem na projekt pod ním.

Čas na stavovém řádku

Po každém sestavení ukáže stavový řádek Visual Studia jeho čas a změnu oproti předchozímu srovnatelnému sestavení: ⏱ 1 min 48 s (▲ 4.1 s) — ▲ pomalejší, ▼ rychlejší. Je to jediná věc, kterou BuildSmith ukazuje sám od sebe, a v nastavení ji lze vypnout.

Srovnatelné znamená stejný druh sestavení (Sestavit nebo Znovu sestavit), stejnou konfiguraci, stejnou platformu a stejnou větev Gitu. Pokud takové sestavení ještě není, zobrazí se jen čas.

Záhlaví

Horní část okna shrnuje zobrazené sestavení:

Pruhy

Najeďte na pruh pro podrobnosti: jak dlouho projekt trval, od kdy do kdy od začátku sestavení, změna oproti předchozímu sestavení a zda byl na kritické cestě.

Okno může zůstat otevřené, zatímco pracujete: na každé nové sestavení se přepne samo. Nahoře jsou karty Časová osa, Porovnání a Historie.

Nikdy aktuální

Některé projekty se sestavují při každém sestavení, i když se v nich nic nezměnilo. Pokaždé to stojí pár sekund a nikdo si toho nevšimne. BuildSmith ano: nad časovou osou přírůstkového sestavení pruh oznámí, kolik takových projektů je a kolik stojí při každém sestavení. Po rozbalení ukáže seznam projektů; jejich řádky na časové ose dostanou značku ⟳.

Pravidlo: projekt je označen, když se sestavil v každém z posledních 3 až 5 přírůstkových sestavení se stejnou konfigurací a větví, zatímco víc než polovina řešení byla aktuální. Opětovná sestavení se nepočítají — tam se vše sestavuje záměrně.

Obvyklé příčiny:

• soubor s Kopírovat do výstupního adresáře: Vždy kopírovat — stačí Kopírovat, pokud je novější;
• krok před sestavením nebo po něm, který se dotkne souboru, na kterém projekt závisí;
• kód generovaný při každém sestavení, i když se jeho zdroj nezměnil.

Oprava ušetří ten čas při každém sestavení. Pruh lze vypnout v nastavení: Upozorňovat na projekty, které nikdy nejsou aktuální.

Historie

Karta Historie obsahuje zaznamenaná sestavení řešení, od nejnovějších, seskupená podle dnů. Každý řádek ukazuje čas, druh sestavení, konfiguraci a větev, štítek a pruh úměrný času sestavení — pomalé sestavení je hned vidět.

Najít sestavení

Pište do vyhledávacího pole — každé slovo musí být nalezeno ve štítku, větvi, konfiguraci nebo druhu sestavení. Zužte výběr podle data pomocí Dnes, Včera a dnes, 7 dní nebo Vše, případně vyberte data v kalendáři (Data…). Jen se štítkem ponechá sestavení, kterým jste dali štítek.

Otevřít, štítek, ponechat, odstranit

Kliknutím na sestavení (nebo klávesou Enter) ho otevřete na časové ose. Pravým tlačítkem jsou k dispozici Otevřít na časové ose, Štítek…, Ponechat (nikdy neodstraňovat) a Odstranit. Klávesa Delete sestavení odstraní, s možností Zpět po několik sekund. Nabídka ⋯ odstraní sestavení starší než zvolené datum nebo vymaže historii tohoto řešení či všech řešení.

Zaškrtněte sestavení, abyste je porovnali nebo jich odstranili několik najednou. Zaškrtnout se štítkem zaškrtne každé zobrazené sestavení, které má štítek — nejrychlejší způsob, jak porovnat „před“ a „po“.

Jak dlouho se sestavení uchovávají

Sestavení se uchovávají jen v tomto počítači, v %LocalAppData%\BuildSmith, jedna historie na řešení — po dobu 1 dne, 3 dnů, 1 týdne (výchozí), 2 týdnů nebo 1 měsíce. Starší sestavení se odstraní při otevření řešení nebo na konci sestavení. Sestavení se štítkem a ponechaná sestavení zůstávají bez ohledu na stáří.

Štítky

🏷 v záhlaví (nebo Štítek… v nabídce Historie) dá sestavení krátký text a barvu: jednu z pěti nebo vlastní z malého výběru s paletou a nedávnými barvami. Nedávno použité štítky se nabízejí znovu na jedno kliknutí, takže řada sestavení může sdílet jeden štítek.

Sestavení se štítkem se kvůli stáří nikdy neodstraní (pokud nevypnete Uchovávat sestavení se štítkem). Ponechat (nikdy neodstraňovat) zachová sestavení i bez štítku.

Záznam

⏻ v záhlaví určuje, zda se sestavení zaznamenávají:

Když spí, BuildSmith opravdu nic nedělá: neodebírá události sestavení a nic nezapisuje do stavového řádku ani na disk. Historie zůstane a okno nabídne Znovu zaznamenávat sestavení.

Porovnání sestavení

Karta Porovnání staví sestavení vedle sebe: pomohla oprava, který projekt se po aktualizaci zpomalil, jak se čas sestavení vyvíjel během týdne.

Výběr sestavení

Na kartě Historie zaškrtněte 2 až 10 sestavení a stiskněte ⇄ Porovnat (N). Bez zaškrtnutí ukáže karta Porovnání zobrazené sestavení oproti předchozímu srovnatelnému. Sestavení se objeví nahoře jako čipy; ✕ jedno z porovnání vyřadí.

Trend a tabulka

Malý graf ukazuje celkový čas každého sestavení. Pod ním tabulka projekty × sestavení: každá buňka je obarvena podle změny oproti prvnímu sestavení — teplejší je pomalejší, zelená je rychlejší — s minigrafem, změnou a ● tam, kde byl projekt na kritické cestě. Projekty bez výrazné změny jsou sbalené do … dalších N bez výrazné změny.

Jen projekty, které vás zajímají

Projekty: … filtruje tabulku: Všechny projekty (N), Výrazně změněné (N), Na kritické cestě (N) nebo Jen zaškrtnuté, s vyhledávacím polem. Filtr se pamatuje pro každé řešení a trend pak sčítá čas filtrovaných projektů — trend vašich projektů, ne celého řešení.

Jeden projekt napříč sestaveními

Kliknutím na projekt zobrazíte jeho pruhy v každém porovnávaném sestavení; orámovaný pruh znamená, že byl na kritické cestě daného sestavení. ‹ Všechny projekty vede zpět.

Kopírovat jako Markdown

⧉ Kopírovat vloží tabulku tak, jak ji vidíte — stejná sestavení, stejný filtr — do schránky jako tabulku Markdown, připravenou pro pull request nebo chat. V zobrazení jednoho projektu zkopíruje ten projekt.

Nastavení

Nástroje › Možnosti › SmithWorks › BuildSmith (nebo ⚙ v okně Časová osa sestavení). Každá možnost má krátký popis toho, co dělá.

Možnost	Výchozí
Zaznamenávat sestavení	zapnuto
Nezaznamenává se pro:	Žádné řešení není vypnuté.
Uchovávat sestavení:	1 týden
Uchovávat sestavení se štítkem	zapnuto
Čas na stavovém řádku	zapnuto
Upozorňovat na projekty, které nikdy nejsou aktuální	zapnuto
Požádat o hodnocení na Marketplace	zapnuto

Vymazat celou historii (řešení: N, velikost)… odstraní zaznamenaná sestavení všech řešení a zeptá se, zda ponechat sestavení se štítkem a ponechaná sestavení. Dole: Obnovit výchozí, Dokumentace, Ohodnotit na Marketplace a Odeslat zpětnou vazbu.

Nastavení a historie se ukládají do %LocalAppData%\BuildSmith.

Časté dotazy

Historie změn

1.0.0

• První vydání: čas sestavení a jeho změna ve stavovém řádku, okno Časová osa sestavení s kritickou cestou, projekty, které nikdy nejsou aktuální, historie s hledáním, daty a štítky, Porovnání až 10 sestavení s kopírováním do Markdownu, zapnutí a vypnutí záznamu pro jednotlivá řešení, panel nástrojů SmithWorks, jednorázová prosba o hodnocení.