vcpkg install
- Klassischer Modus
vcpkg install [options] <package>...
- Manifestmodus
vcpkg install [options]
Erstellen und Installieren von Portpaketen.
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.
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.
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.
Alle vcpkg-Befehle unterstützen eine Reihe allgemeiner Optionen.
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.
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-build
und --clean-packages-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.
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.
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.
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.
- 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.
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.
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.
- 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.
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.
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.
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.
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.
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.
- 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.
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.
Hinweis
In diesem Abschnitt wird ein experimentelles Feature von vcpkg behandelt, das jederzeit geändert oder entfernt werden kann.
Schreibt eine nuGet-formatierte packages.config
Datei 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.
Unterdrücken Der Erzeugung von Verwendungstext, der am Ende der Installation gedruckt wird.
Feedback zu vcpkg
vcpkg ist ein Open Source-Projekt. Wählen Sie einen Link aus, um Feedback zu geben: