Sdílet prostřednictvím

Změna vln

  • Článek

Vlna změn je sada změn chování v nástroji MSBuild, ze které se můžete vyloučit nastavením konkrétního příznaku jako proměnné prostředí. Účelem je upozornit vás na potenciálně rušivé změny, abyste měli flexibilitu při přizpůsobování se těmto změnám, než se stanou standardními funkcemi. Všechny funkce v konkrétní vlně změn lze povolit nebo zakázat pouze společně, ne jednotlivě.

Když upgradujete na novou verzi nástroje MSBuild, změny, které mohou potenciálně způsobit problémy, jsou povoleny ve výchozím nastavení, ale pokud funkce ovlivní sestavení negativně, můžete tuto vlnu změn snadno zakázat. Každá vlna změn je identifikována číslem verze NÁSTROJE MSBuild (například 16.8), ale nastavení vlny změn řídí pouze určité funkce, které mají potenciál ovlivnit proces sestavení, ne všechny změny v této verzi NÁSTROJE MSBuild. Seznam funkcí v každé vlně změn se zobrazí dále v tomto článku. Zakázání vlny změn také zakáže změny ve vyšších verzích.

Odhlášení z funkcí vlny změn

Pokud chcete zakázat funkce v změnové vlně, nastavte proměnnou prostředí MSBuildDisableFeaturesFromVersion na změnovou vlnu (nebo verzi MSBuild), která obsahuje funkci, kterou chcete zakázat. Toto je verze nástroje MSBuild, pro kterou byly vyvinuty funkce. Podívejte se níže na přiřazení vln změn k funkcím.

Hodnoty MSBuildDisableFeaturesFromVersion

Pokud nenastavíte MSBuildDisableFeaturesFromVersion na platnou změnovou vlnu, zobrazí se vám upozornění a/nebo se použije výchozí vlna. V následující tabulce jsou uvedena možná nastavení:

hodnota MSBuildDisableFeaturesFromVersion Výsledek Zobrazí se upozornění?
Nenastavený Povolte všechny vlny změn, což znamená, že jsou povolené všechny funkce za každou vlnou změn. Ne
Jakákoli platná a aktuální vlna změn (například 16.8) Zakažte všechny funkce za vlnou změn 16.8a vyšších. Ne
Neplatná hodnota (například 16.9, pokud jsou platné vlny 16.8 a 16.10) Nastavit na nejbližší platnou hodnotu (vzestupně). Například nastavení 16.9 vás přiřadí ve výchozím nastavení k 16.10. Ne
Mimo otočení (například 17.1, když je nejvyšší vlna 17.0) Uchycení k nejbližší platné hodnotě. Například 17.1 je připevněno k 17.0a 16.5 je připevněno k 16.8 Ano
Neplatný formát (například 16x8, 17_0, garbage) Povolte všechny vlny změn, což znamená, že jsou povolené všechny funkce za každou vlnou změn. Ano

Změna vln a souvisejících prvků

17.10

17.8

17.6

17.4

17.0

Změna vln, které se už nestřídá

16.8

16.10

FAQ

Proč cílit na každou druhou verzi pro vyřazení vln změn?

Věříme, že je to dostatek času na to, abychom mohli diskutovat s těmi, kdo byli ovlivněni, a pomoci s adaptací na změny.

Proč proměnná prostředí a ne vlastnost projektu?

Existují scénáře, kdy chceme umístit funkci pod vlnu změn, než MSBuild načte projekt. Z tohoto důvodu fáze změn vyžadují použití proměnných prostředí.

Proč zvolit odmítnutí před přihlášením?

Varianta opt-out je pro nás lepší přístup; jinak bychom pravděpodobně získali omezenou zpětnou vazbu, pokud nějaká funkce ovlivní zákaznické buildy.

Související obsah