Allgemeine Befehlsoptionen

Die meisten vcpkg-Befehle akzeptieren eine Gruppe allgemeiner Optionen, die schneidende Aspekte des Tools steuern. Nicht alle Optionen wirken sich auf jeden Befehl aus. Beispielsweise ist ein Befehl, der keine Dateien herunterlädt, nicht betroffen, indem das Downloadverzeichnis geändert wird.

Optionen

--x-asset-sources=<config>

Hinweis

In diesem Abschnitt wird ein experimentelles Feature von vcpkg behandelt, das jederzeit geändert oder entfernt werden kann.

Geben Sie die Cachekonfiguration für die Zwischenspeicherung von Objekten an.

--binarysource=<config>

Fügen Sie eine Quelle für die binäre Zwischenspeicherung hinzu.

Diese Option kann mehrmals angegeben werden. Weitere Informationen zur Interaktion mehrerer binärer Quellen finden Sie in der Dokumentation zum Binären Zwischenspeichern.

--x-buildtrees-root=<path>

Hinweis

In diesem Abschnitt wird ein experimentelles Feature von vcpkg behandelt, das jederzeit geändert oder entfernt werden kann.

Gibt den temporären Pfad zum Speichern von Zwischenbuilddateien an, z. B. Objekte oder entpackten Quellcode.

Der Standardwert ist buildtrees/ unter dem vcpkg-Stammordner.

--classic

Erzwingt den klassischen Modus , auch wenn eine Manifestdatei erkannt wird.

--x-cmake-configure-debug=<debugger-pipe>[;semicolon;port;list]

Hinweis

In diesem Abschnitt wird ein experimentelles Feature von vcpkg behandelt, das jederzeit geändert oder entfernt werden kann.

Ermöglicht CMakes --debugger innerhalb von Upstream-Buildsystemen CMakeLists.txt, z. B. innerhalb vcpkg_cmake_configurevon .

Der <debugger-pipe> Wert wird wie --debugger-pipe in der Befehlszeile "CMake" übergeben.

Wenn eine durch Semikolons getrennte Portliste vorhanden ist, wird der Debugger nur für Ports in dieser Liste verwendet. Andernfalls wird sie für alle Ports verwendet.

Die Tripletvariable VCPKG_CMAKE_CONFIGURE_OPTIONS wird verwendet, um die Optionen an den internen CMake-Konfigurationsaufruf zu übergeben. Daher funktioniert es nicht für benutzerdefinierte Dreifache überschreiben VCPKG_CMAKE_CONFIGURE_OPTIONS. Übergeben Sie entweder manuell die Debugoptionen, oder fügen Sie stattdessen Die Optionen an VCPKG_CMAKE_CONFIGURE_OPTIONS .

Im Gegensatz dazu --x-cmake-debug gibt es keine Ausgabe, die angibt, dass der Build auf einen Debugger wartet, um eine Verbindung herzustellen. Die Ausgabe wird einfach angehalten Configuring <triplet>.

Obwohl alle Ports CMake innerhalb der Portdatei aufrufen sollten, um kompilierte Flags aus der CMake-Toolkette abzurufen. Dieser Befehl eignet sich hauptsächlich für Ports, die CMake als Buildsystem verwenden.

--x-cmake-debug=<debugger-pipe>[;semicolon;port;list]

Hinweis

In diesem Abschnitt wird ein experimentelles Feature von vcpkg behandelt, das jederzeit geändert oder entfernt werden kann.

Aktiviert CMake-Skripts --debugger beim Ausführen direkt aufgerufener CMake-Skripts wie Tripletdateien (z. B. : x64-windows.cmake) oder portfile.cmake Dateien.

Der <debugger-pipe> Wert wird wie --debugger-pipe in der Befehlszeile "CMake" übergeben.

Wenn eine durch Semikolons getrennte Portliste vorhanden ist, wird der Debugger nur für Ports in dieser Liste verwendet. Andernfalls wird sie für alle Ports verwendet.

Hinweis: Der Debugger kann angefügt werden, wenn Waiting for debugger client to connect... in der Ausgabe von vcpkg beobachtet werden kann und die Ausführung angehalten wird, bis ein Debugger verbunden ist.

--downloads-root=<path>

Geben Sie an, wo heruntergeladene Tools und Quellcodearchive aufbewahrt werden sollen.

Standardmäßig wird die VCPKG_DOWNLOADS Umgebungsvariable verwendet. Wenn dies nicht festgelegt ist, wird downloads/ standardmäßig unter dem vcpkg-Stammordner festgelegt.

--feature-flags=<flag1>,...

Diese Variable kann auf eine Liste von Featurekennzeichnungen festgelegt werden, um sich für experimentelles Verhalten zu entscheiden.

--host-triplet=<triplet>

Geben Sie das Host-Triplet an.

Standardmäßig wird die VCPKG_DEFAULT_HOST_TRIPLET Umgebungsvariable verwendet. Wenn dies ebenfalls nicht festgelegt ist, wird der Wert basierend auf der Hostarchitektur und dem Betriebssystem abgeleitet.

--x-install-root=<path>

Hinweis

In diesem Abschnitt wird ein experimentelles Feature von vcpkg behandelt, das jederzeit geändert oder entfernt werden kann.

Gibt den Pfad zum Layout der installierten Pakete an.

Im klassischen Modus wird installed/ standardmäßig unter dem vcpkg-Stammordner festgelegt.

Im Manifestmodus wird vcpkg_installed/ standardmäßig unter dem Manifestordner angezeigt.

--x-manifest-root=<path>

Hinweis

In diesem Abschnitt wird ein experimentelles Feature von vcpkg behandelt, das jederzeit geändert oder entfernt werden kann.

Gibt das Verzeichnis an, das enthält vcpkg.json.

Standardmäßig wird nach oben aus dem aktuellen Arbeitsverzeichnis nach oben nach dem nächstgelegenen vcpkg.jsongesucht.

--overlay-ports=<path>

Gibt ein Verzeichnis entweder einen Überlagerungsport oder Unterverzeichnisse an, die selbst Überlagerungsports sind. Wenn <path> es sich um ein Verzeichnis handelt, das ein CONTROL vcpkg.jsonOder enthält, wird es als Überlagerungsportverzeichnis behandelt, und Unterverzeichnisse werden nicht als zusätzliche Überlagerungsports betrachtet.

Diese Option kann mehrmals angegeben werden. Ports werden in die erste Übereinstimmung aufgelöst.

--overlay-triplets=<path>

Gibt ein Verzeichnis an, das Überlagerungs-Triplets enthält.

Diese Option kann mehrmals angegeben werden, um mehrere Verzeichnisse hinzuzufügen; Dreifache werden nach Namen in die erste Übereinstimmung aufgelöst.

--x-packages-root=<path>

Hinweis

In diesem Abschnitt wird ein experimentelles Feature von vcpkg behandelt, das jederzeit geändert oder entfernt werden kann.

Gibt den temporären Pfad zur Phase von Zwischenpaketdateien vor der endgültigen Installation an.

Der Standardwert ist packages/ unter dem vcpkg-Stammordner.

--triplet=<triplet>

Geben Sie das Triplet der Zielarchitektur an.

Standardmäßig wird die VCPKG_DEFAULT_TRIPLET Umgebungsvariable verwendet. Wenn dies nicht festgelegt ist, wird basierend auf der Hostarchitektur und dem Betriebssystem abgeleitet.

Unter Windows-Betriebssystemen wird die Architektur aus älteren Gründen immer als x86 abgeleitet.

Hinweis

Alle Versionen, die in und nach September 2023 vorgenommen wurden, werden standardmäßig auf dem Host-Triplet unter Windows anstelle von x86-Windows verwendet.

--vcpkg-root=<path>

Gibt den vcpkg-Stammordner an.

Standardmäßig wird das Verzeichnis verwendet, das das vcpkg-Programm enthält. Das Verzeichnis muss eine gültige vcpkg-Instanz sein, z. B. eine git clone von https://github.com/microsoft/vcpkg. Diese Option kann verwendet werden, um eine benutzerdefinierte Kopie des Tools direkt aus dem Buildordner auszuführen.

Antwortdateien (@<file>)

Die vcpkg-Befehlszeile akzeptiert Textdateien, die zeilentrennte Befehlszeilenparameter enthalten.

Das Tool fungiert so, als ob die Elemente in der Datei anstelle des @ Verweises in die Befehlszeile kompliziert wurden. Antwortdateien können keine zusätzlichen Antwortdateien enthalten.