Freigeben über


MSBuild-Antwortdateien

Antwortdateien (.rsp) sind Textdateien, die MSBuild.exe Befehlszeilenoptionen enthalten. Jeder Schalter kann sich in einer separaten Linie oder alle Schalter in einer Zeile ben. Kommentarzeilen sind mit einem # Symbol versehen. Die @ Option wird verwendet, um eine andere Antwortdatei an MSBuild.exezu übergeben.

MSBuild.rsp

Die Autoresponse-Datei ist eine spezielle .rsp Datei, die beim Erstellen eines Projekts automatisch verwendet MSBuild.exe . Diese Datei MSBuild.rsp muss sich im selben Verzeichnis wie MSBuild.exebefinden, andernfalls wird sie nicht gefunden. Sie können diese Datei bearbeiten, um standard-Befehlszeilenoptionen zu MSBuild.exeanzugeben. Wenn Sie beispielsweise jedes Mal, wenn Sie ein Projekt erstellen, denselben Logger verwenden, können Sie den Switch "-logger " zu MSBuild.rsp hinzufügen und MSBuild.exe die Protokollierung jedes Mal verwendet, wenn ein Projekt erstellt wird.

Directory.Build.rsp

In Version 15.6 und höher durchsucht MSBuild übergeordnete Verzeichnisse des Projekts nach einer Datei namens "Directory.Build.rsp". Diese Datei kann in einem Quellcode-Repository hilfreich sein, um Während der Befehlszeilenbuilds Standardargumente bereitzustellen. Sie kann auch verwendet werden, um die Befehlszeilenargumente gehosteter Builds anzugeben.

Sie können die Syntax %MSBuildThisFileDirectory% in einer Directory.Build.rsp-Datei verwenden, um auf das Verzeichnis zu verweisen, das die Datei "Directory.Build.rsp " enthält. Diese Syntax erfordert Prozentzeichen auf allen Betriebssystemen, z. B. Environment.ExpandEnvironmentVariables, auch wenn MSBuildThisFileDirectory es sich nicht um eine Umgebungsvariable handelt.

Hinweis

Visual Studio (die IDE) wendet beim Erstellen innerhalb der IDE keine Antwortdateien (z.rsp. B. oder MSBuild.rsp) anDirectory.Build.rsp. Diese Dateien werden nur verarbeitet, wenn Sie MSBuild über die msbuild.exedotnet build Befehlszeilentools ausführen.

Deaktivieren von Antwortdateien

Um die automatische Verarbeitung der Standardantwortdateien MSBuild.rsp und Directory.Build.rsp in einem bestimmten Aufruf von MSBuild zu deaktivieren, verwenden Sie die Befehlszeilenoption -noAutoResponse. Alle Antwortdateien, auf die explizit mithilfe der @-Syntax in der Befehlszeile verwiesen wird, werden weiterhin verarbeitet. Informationen finden Sie in der MSBuild-Befehlszeilenreferenz.

Siehe auch