Freigeben über

vcpkg install

  • Artikel

Übersicht

  • Klassischer Modus
vcpkg install [options] <package>...
  • Manifestmodus
vcpkg install [options]

Beschreibung

Erstellen und Installieren von Portpaketen.

Klassischer Modus

Im klassischen Modus fügt dieses Verb Portpakete zum vorhandenen Satz im installierten installed/ Verzeichnis hinzu (standardmäßig unter dem vcpkg-Stamm). Dies kann erfordern, dass vorhandene Pakete entfernt und neu erstellt werden, was fehlschlagen kann.

Paketsyntax

portname[feature1,feature2]:triplet

Paketverweise ohne Triplet werden automatisch durch das Standardziel-Triplet qualifiziert. Paketverweise, die nicht explizit aufgeführt core werden, werden als implizieren alle Standardfeatures betrachtet.

Manifestmodus

Im Manifestmodus legt dieser Befehl das installierte Verzeichnis auf den zustand fest, der durch die vcpkg.json Manifestdatei angegeben wird, indem Pakete bei Bedarf hinzugefügt, entfernt oder neu erstellt werden.

Optionen

Alle vcpkg-Befehle unterstützen eine Reihe allgemeiner Optionen.

--allow-unsupported

Anstatt auf einem nicht unterstützten Port zu beenden, fahren Sie mit einer Warnung fort.

Standardmäßig lehnt vcpkg die Ausführung eines Installationsplans ab, der eine Portinstallation für ein Triplet außerhalb seiner "supports" Klausel enthält. Die "supports" Klausel eines Pakets beschreibt den vollständigen Satz von Plattformen, auf denen ein Paket erstellt werden kann. Dieses Flag weist vcpkg an, zu warnen, dass der Build fehlschlägt, anstatt zu stoppen.

--clean-after-build

Bereinigen Sie Buildstrukturen, Pakete und Downloads nach dem Erstellen jedes Pakets.

Diese Option hat die gleiche Auswirkung wie das Übergeben --clean-buildtrees-after-build, , --clean-downloads-after-buildund --clean-packages-after-build.

--clean-buildtrees-after-build

Bereinigen Sie alle Unterverzeichnisse aus den temporären Unterordnern der Buildstrukturen, nachdem Sie jedes Paket erstellt haben.

Alle Dateien auf oberster Ebene im Unterordner der Buildstrukturen (z. B. buildtrees/zlib/config-x64-windows-out.log) werden beibehalten. Alle Unterverzeichnisse werden gelöscht.

--clean-downloads-after-build

Bereinigen Sie alle nicht abgerufenen Ressourcen aus dem downloads/ Ordner, nachdem Sie jedes Paket erstellt haben.

Alle Dateien der obersten Ebene im downloads/ Ordner werden gelöscht. Extrahierte Tools werden beibehalten.

--clean-packages-after-build

Bereinigen Sie den temporären Unterordner der Pakete, nachdem Sie jedes Paket erstellt haben.

Der Unterordner für das integrierte Paket (z. B packages/zlib_x64-windows. ) wird nach der Installation gelöscht.

--dry-run

Drucken Sie den Installationsplan, entfernen Oder installieren Sie keine Pakete.

Der Installationsplan listet alle Pakete und Features auf, die installiert werden sollen, sowie alle anderen Pakete, die entfernt und neu erstellt werden müssen.

--editable

  • Nur klassischer Modus

Führen Sie bearbeitbare Builds für alle direkt referenzierten Pakete in der Befehlszeile aus.

Wenn vcpkg Ports erstellt, wird der Quellcode jedes Mal gelöscht und erneut extrahiert, um sicherzustellen, dass Eingaben korrekt sind. Dies ist erforderlich, damit der Manifestmodus genau aktualisiert, was installiert ist, und für die binäre Zwischenspeicherung, um sicherzustellen, dass zwischengespeicherte Inhalte korrekt sind.

Durch das Übergeben des --editable Flags wird dieses Verhalten deaktiviert, wobei Bearbeitungen an den extrahierten Quellen im buildtrees/ Ordner beibehalten werden. Auf diese Weise können Patches schnell entwickelt werden, indem sie die Notwendigkeit vermeiden, eine Datei für jede Änderung zu schreiben.

Während eines bearbeitbaren Builds extrahierte Quellen verfügen nicht über ein .clean/ Suffix für den Verzeichnisnamen und werden nicht durch nachfolgende, nicht bearbeitbare Builds gelöscht.

--enforce-port-checks

Fehler bei der Installation, wenn ein Port Probleme erkannt hat oder versucht, ein veraltetes Feature zu verwenden.

Standardmäßig führt vcpkg mehrere Überprüfungen für integrierte Pakete aus und gibt Warnungen aus, wenn Probleme erkannt werden. Mit diesem Flag werden diese Warnungen auf einen Fehler aktualisiert.

--x-feature=<feature>

Hinweis

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

  • Nur Manifestmodus

Geben Sie ein zusätzliches Feature aus den Abhängigkeiten an, für die vcpkg.json Abhängigkeiten installiert werden sollen.

Standardmäßig werden nur "dependencies" und die Abhängigkeiten "default-features" installiert.

--head

  • Nur klassischer Modus

Fordern Sie alle Pakete an, auf die in der Befehlszeile explizit verwiesen wird, um die neuesten Quellen abzurufen, die beim Erstellen verfügbar sind.

Dieses Kennzeichen ist nur für temporäre Tests vorgesehen und nicht für die Produktion oder langfristige Verwendung vorgesehen. Dadurch wird die binäre Zwischenspeicherung für alle explizit referenzierten Pakete und deren Abhängige deaktiviert, da vcpkg nicht alle Eingaben genau nachverfolgen kann.

--keep-going

Setzen Sie den Installationsplan nach dem ersten Fehler fort.

Standardmäßig wird vcpkg beim ersten Paketbuildfehler beendet. Dieses Flag weist vcpkg an, das Erstellen und Installieren anderer Teile des Installationsplans fortzusetzen, die nicht vom fehlgeschlagenen Paket abhängen.

--x-no-default-features

Hinweis

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

  • Nur Manifestmodus

Installieren Sie die Standardfeatures nicht aus dem Manifest der obersten Ebene.

Bei Verwendung install im Manifestmodus werden standardmäßig alle Abhängigkeiten der aufgeführten "default-features" Features installiert. Dieses Flag deaktiviert dieses Verhalten, sodass nur features, die explizit aktiviert werden, --x-feature installiert werden.

--no-downloads

Beim Erstellen eines Pakets verhindern Sie, dass Ports während des Builds neue Ressourcen herunterladen.

Standardmäßig erwerben Ports Quellcode und Tools bei Bedarf aus dem Internet (vorbehaltlich der Zwischenspeicherung von Ressourcen). Dieser Parameter blockiert Downloads und schränkt Ports nur auf die Objekte ein, die zuvor auf dem Computer heruntergeladen und zwischengespeichert wurden.

--only-downloads

Versuchen Sie, alle Ressourcen herunterzuladen, die für einen Installationsplan erforderlich sind, ohne Builds auszuführen.

Wenn diese Option übergeben wird, führt vcpkg jeden Build im Plan aus, bis er den ersten aufruft, der nicht heruntergeladene externe Prozess aufruft. Die meisten Ports führen alle Downloads vor dem ersten externen Prozessaufruf (in der Regel an ihr Buildsystem) durch, sodass dieses Verfahren alle erforderlichen Ressourcen herunterlädt. Ports, die diesem Verfahren nicht folgen, verfügen nicht über bereits heruntergeladene Ressourcen.

--only-binarycaching

Verweigerung der Ausführung von Builds. Stellen Sie Nur Pakete aus binären Caches wieder her.

Dieses Flag blockiert die Ausführung von vcpkg-Builds bei Bedarf und schlägt fehl, wenn ein Paket nicht in binären Caches gefunden werden kann.

--recurse

  • Nur klassischer Modus

Genehmigen eines Installationsplans, für den ein Neuerstellen von Paketen erforderlich ist.

Um den Satz von Features eines installierten Pakets zu ändern, muss vcpkg dieses Paket entfernen und neu erstellen. Da dies möglicherweise fehlschlägt und die Installationsstruktur mit weniger Paketen als der Benutzer gestartet hat, muss der Benutzer Pläne genehmigen, mit denen Pakete neu erstellt werden, indem diese Kennzeichnung übergeben wird.

--x-use-aria2

Hinweis

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

Verwenden Sie Aria2, um Downloadaufgaben auszuführen.

--x-write-nuget-packages-config

Hinweis

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

Schreibt eine nuGet-formatierte packages.configDatei für die Verwendung mit binärem Zwischenspeichern.

Diese Option kann in Verbindung mit --dry-run der Liste der NuGet-Pakete verwendet werden, die aus der binären Zwischenspeicherung erforderlich sind, ohne Pakete zu erstellen oder zu installieren. Dadurch kann die NuGet-Befehlszeile separat für erweiterte Szenarien aufgerufen werden, z. B. die Verwendung alternativer Protokolle zum Abrufen der .nupkg Dateien.

--no-print-usage

Unterdrücken Der Erzeugung von Verwendungstext, der am Ende der Installation gedruckt wird.