Dela via

MSBuild-resurshantering för anpassad kultur

Från och med MSBuild 17.14 är resurshanteringen för anpassad kultur inte längre aktiverad som standard. Användarna måste uttryckligen välja att aktivera den här funktionen. Den här ändringen förhindrar oavsiktligt beteende som orsakas av automatisk identifiering av kataloger som liknar kulturkoder.

Version lanserad

MSBuild 17.14

Anmärkning

Eftersom den här ändringen påverkar MSBuilds beteende påverkar den två versioner av .NET: .NET 10 Preview 1 och .NET 9.0.2 som stöds. Det transparenta stödet för ändring av anpassad kultur introducerades i .NET SDK 9.0.200 och ändringen som gör att den anmäls finns i .NET SDK 9.0.300.

Tidigare beteende

MSBuild behandlade tidigare kataloger med namn som liknar kulturkoder (till exempel en-US, fr-FR) som kulturspecifika resurskataloger som standard. Det här beteendet inkluderade ibland orelaterade kataloger, till exempel de med hash-baserade eller tekniska namn, vilket ledde till oavsiktliga resurssammansättningar i byggprocessen.

Nytt beteende

  • Resurshantering för anpassad kultur är inaktiverad som standard.
  • Om du vill aktivera den här funktionen anger du projektegenskapen EnableCustomCulture till true.
  • Använd egenskapen CustomCultureExcludeDirectories för att ange en semikolonavgränsad lista med katalognamn som ska undantas från anpassad kulturbearbetning.

Typ av brytande ändring

Det här är en beteendeförändring.

Orsak till ändring

Den automatiska identifieringen av kulturspecifika resurskataloger orsakade oförutsägbart byggbeteende när katalognamn av en tillfällighet matchade kulturkoder. Att kräva explicit opt-in garanterar mer förutsägbara versioner och ger användarna större kontroll över resurshanteringen.

Om din byggprocess förlitar sig på anpassad kulturresurshantering:

  1. Ange projektegenskapen EnableCustomCulture till true.
  2. Du kan också använda egenskapen CustomCultureExcludeDirectories för att undanta specifika kataloger från att behandlas som kulturresurser.

Berörda API:er

Ingen.