Porty nakładki

Zazwyczaj porty vcpkg są uzyskiwane z rejestrów. Jest bardzo prawdopodobne, że większość zainstalowanych portów pochodzi z oficjalnego rejestru vcpkg pod adresem https://github.com/Microsoft/vcpkg. Narzędzie vcpkg umożliwia zainstalowanie dostępnych portów za pośrednictwem systemu plików, które nazywamy tymi portami, portami nakładki.

Port nakładki może działać jako wymiana upuszczania istniejącego portu lub jako nowego portu, który w przeciwnym razie nie jest dostępny w rejestrze. Podczas rozpoznawania nazw pakietów porty nakładki mają priorytet.

Porty nakładki są oceniane w następującej kolejności:

• Katalog określony w wierszu polecenia za pośrednictwem --overlay-ports, lub nazwanych podkatalogów, jeśli ten katalog nie CONTROL ma pliku lub vcpkg.json .
• Katalog określony w vcpkg-configuration.json pliku za pośrednictwem overlay-ports, lub nazwanych podkatalogów, jeśli ten katalog nie CONTROL ma pliku lub vcpkg.json .
• Katalog określony przez VCPKG_OVERLAY_PORTS wpisy zmiennej środowiskowej lub nazwane podkatalogi, jeśli ten katalog nie CONTROL ma pliku lub vcpkg.json .

Podczas rozpoznawania nazw portów wybrano pierwszą lokalizację zawierającą pasujący port nakładki.

Korzystanie z portu nakładki

Jeśli określono port nakładki, najpierw vcpkg próbuje załadować ten katalog jako port. Jeśli to się powiedzie, sam katalog jest traktowany jako port, a nazwa nakładki pochodzi z CONTROL pliku lub vcpkg.json . W przeciwnym razie rozważane są podkatalogi z nazwą portu nakładki.

Prawidłowe porty zawierają portfile.cmakewartości , i vcpkg.json lub CONTROL.

Rozważmy na przykład następującą strukturę katalogów:

• x/vcpkg.json "name", pole jest ustawione na "a".
• x/portfile.cmake, skojarzone instrukcje kompilacji dla .a
• x/b/vcpkg.json "name", pole jest ustawione na "b".
• x/b/portfile.cmake, skojarzone instrukcje kompilacji dla .b
• y/c/vcpkg.json "name", pole jest ustawione na "c".
• y/c/portfile.cmake, skojarzone instrukcje kompilacji dla .c
• y/d/vcpkg.json "name", pole jest ustawione na "d".
• y/d/portfile.cmake, skojarzone instrukcje kompilacji dla .d

Narzędzie vcpkg rozważy następujące porty, biorąc pod uwagę następujące ustawienia:

• --overlay-ports=x: W tej nakładce znajduje się jeden port. a Nazwa pochodzi z .vcpkg.json Podkatalog nie jest brany podkatalog b .
• --overlay-ports=x/b: W tej nakładce znajduje się jeden port. b Nazwa pochodzi z .vcpkg.json
• --overlay-ports=y: W tej nakładce znajdują się dwa porty: c i d. Ich nazwy pochodzą z podkatalogów y, a nazwy zadeklarowane w ich vcpkg.json musi być zgodne lub zostanie wygenerowany błąd, jeśli zostanie poproszony o rozważenie c lub d.

Konfigurację portu nakładki można dodać na kilka sposobów:

• Wiersz polecenia: dodaj co najmniej jedną --overlay-ports=<directory> opcję do wiersza polecenia.
• Manifest: Wypełnij tablicę "overlay-ports" w pliku vcpkg-configuration.json.
• Zmienna środowiskowa: ustaw VCPKG_OVERLAY_PORTS na listę rozdzielaną znakami ścieżki.

Przykład: przykład portów nakładki

Biorąc pod uwagę tę strukturę katalogów:

Uruchom:

vcpkg install sqlite3 --overlay-ports=my-ports --overlay-ports=team-ports

W celu zainstalowania stabilizatorów:

• sqlite3 z my-ports

Uruchom:

vcpkg install sqlite3 rapidjson curl \
    --overlay-ports=my-ports/rapidjson \
    --overlay-ports=vcpkg/ports/curl \
    --overlay-ports=team-ports

W celu zainstalowania stabilizatorów:

• sqlite3 z team-ports
• rapidjson z my-ports
• curl z vcpkg/ports

Przykład: używanie portów nakładki do używania zależności menedżera pakietów systemowych

Aby użyć zależności menedżera pakietów systemowych za pośrednictwem vcpkg jeden, zapoznaj się z naszym wpisem w blogu.