Lernprogramm: Installieren einer Abhängigkeit aus einer Git-basierten Registrierung
Artikel
vcpkg verwendet ein Konzept namens Registries zum Verwalten von Repositorys von Paketen. Standardmäßig findet vcpkg Bibliotheken aus der öffentlichen kuratierten Registrierung unter https://github.com/Microsoft/vcpkg. Sie können Drittanbieter- oder private Registrierungen hinzufügen, um zusätzliche Pakete zur Installation zur Verfügung zu stellen.
2 – Erstellen der Manifest- und Konfigurationsdateien
Führen Sie den folgenden Befehl aus:
vcpkg new --application
Der new commmand erstellt zwei Dateien: eine Manifestdatei (vcpkg.json) und eine Konfigurationsdatei(vcpkg-configuration.json). In der Regel muss --name der Befehl bereitgestellt --version werden, aber da es sich bei diesem Lernprogramm um eine Endbenutzeranwendung handelt, verwenden wir stattdessen die --application Option.
Die generierten Dateien haben den folgenden Inhalt:
Die generierte Konfigurationsdatei enthält zwei Registrierungsdefinitionen. Dies default-registry verweist auf die kuratierte vcpkg-Registrierung bei https://github.com/Microsoft/vcpkg, wobei der neueste Commit als Basisplan verwendet wird, und eine zusätzliche "artifacts" Registrierung, die für den Zweck dieses Lernprogramms unnötig ist und gelöscht werden kann.
3 – Hinzufügen privater Registrierungen zu Ihrer vcpkg-Konfigurationsdatei
Der Quellcode verweist auf zwei Bibliotheken, die in der kuratierten vcpkg-Registrierung nicht verfügbar sind. Um diese Abhängigkeiten zu erfüllen, müssen wir als zusätzliche Registrierung hinzufügen https://github.com/microsoft/vcpkg-docs .
Ändern sie den Inhalt von vcpkg-configuration.json in:
Die Konfigurationsdatei fügt eine externe Registrierung als Quelle für die und beison die beicode Pakete hinzu. Zusätzliche Registrierungen müssen explizit die Pakete deklarieren, die sie mithilfe der "packages" Liste bereitstellen. Wenn vcpkg Paketnamen in eine Registrierung aufgelöst, wird standardmäßig jeder Paketname, der in einer zusätzlichen Registrierung nicht gefunden wird, auf die "default-registry". Weitere Informationen zur Paketnamenauflösung finden Sie in der Registrierungsdokumentation.
4 – Installieren von Paketen aus einer Registrierung
Nachdem der Konfigurationsdatei eine Registrierung hinzugefügt wurde, muss nichts Besonderes unternommen werden, um Pakete daraus zu installieren. vcpkg löst die Paketnamen in Der vcpkg.json richtigen Registrierung transparent auf, wenn sie den üblichen Installationsmaschinen folgen.
Fügen Sie die beicode Abhängigkeiten und beison Abhängigkeiten in Ihrer vcpkg.json Datei hinzu:
vcpkg add port beicode beison
Erstellen sie das Projekt, und führen Sie es aus (ersetzen $VCPKG_ROOT Sie den vcpkg-Installationspfad):
Führen Sie das Programm aus, sollte die Ausgabe wie folgt aussehen:
{
"name": "demo"
}
Nächste Schritte
Sperren der Versionen für wiederholbare Builds mithilfe der Versionsverwaltung
Wiederverwenden von Binärdateien über lokale oder fortlaufende Integrationsausführungen mithilfe der binären Zwischenspeicherung
Verwalten Ihrer privaten Bibliotheken mithilfe benutzerdefinierter Registrierungen
Zusammenarbeit auf GitHub
Die Quelle für diesen Inhalt finden Sie auf GitHub, wo Sie auch Issues und Pull Requests erstellen und überprüfen können. Weitere Informationen finden Sie in unserem Leitfaden für Mitwirkende.
Feedback zu vcpkg
vcpkg ist ein Open Source-Projekt. Wählen Sie einen Link aus, um Feedback zu geben:
Arbeiten Sie mithilfe von Bicep-Registrierungen mit wiederverwendbaren Bicep-Modulen. Erstellen Sie eine private Registrierung für Ihre Organisation. Veröffentlichen und nutzen Sie Module durch die Registrierung Ihrer Organisation.