Dokumentation zum .NET Core CLI-Tool dotnet-build

Name

dotnet-build – Erstellen Sie das Projekt und alle Abhängigkeiten

Zusammenfassung

`dotnet build [--output]

[--build-base-path] [--framework]  
[--configuration]  [--runtime] [--version-suffix]
[--build-profile]  [--no-incremental] [--no-dependencies]
[<project>]`

Beschreibung

Der Befehl dotnet build generiert eine Binärdatei aus mehreren Quelldateien und ihren Abhängigkeiten im Quellprojekt. Standardmäßig liegt die Binärdatei in Intermediate Language (IL) vor und verfügt über eine DLL-Erweiterung. dotnet build generiert außerdem eine *.deps-Gliederungsdatei, die die Hostanwendung zum Ausführen benötigt.

Für die Erstellung ist das Vorhandensein einer Sperrdatei erforderlich, was bedeutet, dass Sie beim Generieren Ihres Codes zuerst dotnet Restore ausführen müssen.

Generieren Sie vor Beginn einer Kompilierung Verben, um das Projekt und seine Abhängigkeiten für inkrementelle Sicherheitsprüfungen zu analysieren. Wenn alle Prüfungen erfolgreich sind, wird die inkrementelle Kompilierung mit dem Projekt und seinen Abhängigkeiten fortgesetzt. Andernfalls wird auf die nicht inkrementelle Kompilierung zurückgegriffen. Über eine Flagge an der Seite können Benutzer zusätzliche Informationen darüber erhalten, wie sie ihre Build-Zeiten verbessern können.

Alle Projekte im Abhängigkeitsdiagramm, die kompiliert werden müssen, müssen die folgenden Sicherheitsprüfungen bestehen, damit der Kompilierungsprozess inkrementell erfolgt:

Verwenden Sie keine Skripte vor/nach der Kompilierung

Nicht aus PATH Kompilierungstools laden (z. B. Resgen, Compiler)

Nur ​​bekannte Compiler verwenden (CSC, VBC, FSC)

Um eine ausführbare Anwendung zu generieren, müssen Sie den Abschnitt „Spezielle Konfiguration“ aufrufen in der project.json-Datei:

{ 
    "compilerOptions": {
      "emitEntryPoint": true
    }
}

options

-o, --output [DIR]

Das Verzeichnis zum Platzieren der generierten Binärdateien.

-b, --build-base-path [DIR]

Verzeichnis zum Platzieren der temporären Ausgabe.

-f, --framework [FRAMEWORK]

Kompilieren Sie ein bestimmtes Framework. Das Framework muss in der Datei project.json definiert werden.

-c, --configuration [Debug|Release]

Definieren Sie eine Konfiguration, die gerade generiert wird. Wenn es weggelassen wird, wird standardmäßig das Debuggen verwendet.

-r, --runtime [RUNTIME_IDENTIFIER]

Generierte Ziellaufzeit.

--version-suffix [VERSION_SUFFIX]

definiert * das Versionsfeld, das in der Datei project.json ersetzt werden soll. Das Format folgt dem Versionsstil von NuGet.

--build-profile

Drucken Sie die Sicherheitsüberprüfungen aus, die der Benutzer automatisch aktivieren muss, damit die Inkremente durch die inkrementelle Kompilierung aufgelöst werden können.

--no-incremental

markiert den Build als unsicheren inkrementellen Build. Dadurch wird die inkrementelle Kompilierung deaktiviert und eine saubere Neuerstellung des Abhängigkeitsdiagramms des Projekts erzwungen.

--no-dependencies

Projekt-zu-Projekt-Referenzen ignorieren und nur das Root-Projekt für den angegebenen Build erstellen.