Typowe opcje poleceń

Większość poleceń vcpkg akceptuje grupę typowych opcji, które kontrolują aspekty krzyżowe narzędzia. Nie wszystkie opcje mają wpływ na każde polecenie. Na przykład polecenie, które nie pobiera żadnych plików, nie będzie miało wpływu na zmianę katalogu pobierania.

Opcje

--x-asset-sources=<config>

Uwaga

W tej sekcji opisano eksperymentalną funkcję vcpkg, która może ulec zmianie lub zostać usunięta w dowolnym momencie.

Określ konfigurację pamięci podręcznej dla Buforowanie zasobów.

--binarysource=<config>

Dodaj źródło dla Buforowanie binarnych.

Tę opcję można określić wiele razy; Zobacz dokumentację binarną Buforowanie, aby dowiedzieć się, w jaki sposób współdziała wiele źródeł binarnych.

--x-buildtrees-root=<path>

Uwaga

W tej sekcji opisano eksperymentalną funkcję vcpkg, która może ulec zmianie lub zostać usunięta w dowolnym momencie.

Określa ścieżkę tymczasową do przechowywania plików kompilacji pośredniej, takich jak obiekty lub rozpakowany kod źródłowy.

Wartość domyślna to buildtrees/ w folderze głównym vcpkg.

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

Uwaga

W tej sekcji opisano eksperymentalną funkcję vcpkg, która może ulec zmianie lub zostać usunięta w dowolnym momencie.

Włącza narzędzia CMake w --debugger nadrzędnych systemach kompilacji, CMakeLists.txttakich jak w systemie vcpkg_cmake_configure.

Wartość <debugger-pipe> jest przekazywana jako --debugger-pipe w wierszu polecenia narzędzia CMake.

Jeśli istnieje lista portów rozdzielonych średnikami, debuger jest używany tylko dla portów na tej liście. W przeciwnym razie jest używany dla wszystkich portów.

Zmienna VCPKG_CMAKE_CONFIGURE_OPTIONS potrójna służy do przekazywania opcji do wewnętrznego wywołania konfiguracji narzędzia CMake. W związku z tym nie będzie działać w przypadku niestandardowych trojaków zastępowania VCPKG_CMAKE_CONFIGURE_OPTIONS. Zamiast tego ręcznie przekaż opcje debugowania lub dołącz opcje.VCPKG_CMAKE_CONFIGURE_OPTIONS

W przeciwieństwie do --x-cmake-debug danych wyjściowych nie będzie wskazywać, że kompilacja czeka na nawiązanie połączenia z debugerem. Dane wyjściowe po prostu utkną w Configuring <triplet>punkcie .

Mimo że wszystkie porty powinny wywoływać narzędzie CMake wewnątrz pliku portfile w celu uzyskania flag kompilacji z łańcucha narzędzi CMake. To polecenie jest głównie przydatne w przypadku portów korzystających z narzędzia CMake jako systemu kompilacji.

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

Uwaga

W tej sekcji opisano eksperymentalną funkcję vcpkg, która może ulec zmianie lub zostać usunięta w dowolnym momencie.

Włącza narzędzie CMake podczas --debugger uruchamiania bezpośrednio wywoływanych skryptów CMake, takich jak pliki potrójne (na przykład : x64-windows.cmake) lub portfile.cmake pliki.

Wartość <debugger-pipe> jest przekazywana jako --debugger-pipe w wierszu polecenia narzędzia CMake.

Jeśli istnieje lista portów rozdzielonych średnikami, debuger jest używany tylko dla portów na tej liście. W przeciwnym razie jest używany dla wszystkich portów.

Uwaga: debuger można dołączyć, jeśli Waiting for debugger client to connect... można go zaobserwować w danych wyjściowych programu vcpkg i wykonanie zostanie zatrzymane do momentu połączenia debugera.

--downloads-root=<path>

Określ, gdzie powinny być przechowywane pobrane narzędzia i archiwa kodu źródłowego.

Domyślnie jest to zmienna VCPKG_DOWNLOADS środowiskowa. Jeśli to nie jest ustawione, wartość domyślna downloads/ to w folderze głównym vcpkg.

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

Tę zmienną można ustawić na listę flag funkcji, aby wyrazić zgodę na eksperymentalne zachowanie.

--host-triplet=<triplet>

Określ trojaczki hosta.

Domyślnie jest to zmienna VCPKG_DEFAULT_HOST_TRIPLET środowiskowa. Jeśli to również nie jest zdenerwowane, wartość jest wywoływana na podstawie architektury hosta i systemu operacyjnego.

--x-install-root=<path>

Uwaga

W tej sekcji opisano eksperymentalną funkcję vcpkg, która może ulec zmianie lub zostać usunięta w dowolnym momencie.

Określa ścieżkę do układania zainstalowanych pakietów.

W trybie klasycznym wartość domyślna to installed/ w folderze głównym vcpkg.

W trybie manifestu wartość domyślna to vcpkg_installed/ w folderze manifestu.

--x-manifest-root=<path>

Uwaga

W tej sekcji opisano eksperymentalną funkcję vcpkg, która może ulec zmianie lub zostać usunięta w dowolnym momencie.

Określa katalog zawierający vcpkg.json.

Domyślnie wyszukiwanie w górę z bieżącego katalogu roboczego najbliższego vcpkg.json.

--overlay-ports=<path>

Określa katalog zawierający porty nakładki.

Tę opcję można określić wiele razy; porty zostaną rozpoznane jako pierwsze dopasowanie.

--overlay-triplets=<path>

Określa katalog zawierający potrójne nakładki.

Tę opcję można określić wiele razy, aby dodać wiele katalogów; Trojaczki będą rozpoznawane jako pierwsze dopasowanie według nazwy.

--x-packages-root=<path>

Uwaga

W tej sekcji opisano eksperymentalną funkcję vcpkg, która może ulec zmianie lub zostać usunięta w dowolnym momencie.

Określa ścieżkę tymczasową do przygotowania plików pakietu pośredniego przed ostateczną instalacją.

Wartość domyślna to packages/ w folderze głównym vcpkg.

--triplet=<triplet>

Określ potrójną architekturę docelową.

Domyślnie jest to zmienna VCPKG_DEFAULT_TRIPLET środowiskowa. Jeśli to nie jest zdenerwowane, wywnioskowane na podstawie architektury hosta i systemu operacyjnego.

W systemach operacyjnych Windows architektura jest zawsze wywoływana jako x86 ze starszych powodów.

Uwaga

Wszystkie wersje wprowadzone we wrześniu 2023 r. i po wrześniu 2023 r. będą domyślnie trypletem hosta w systemie Windows zamiast x86-windows.

--vcpkg-root=<path>

Określa folder główny vcpkg.

Domyślnie katalog zawierający program vcpkg. Katalog musi być prawidłowym wystąpieniem vcpkg, takim jak git clonehttps://github.com/microsoft/vcpkg. Ta opcja może służyć do uruchamiania niestandardowej kopii narzędzia bezpośrednio z folderu kompilacji.

Pliki odpowiedzi (@<file>)

Wiersz polecenia vcpkg akceptuje pliki tekstowe zawierające parametry wiersza polecenia rozdzielanych wierszami nowego wiersza polecenia.

Narzędzie będzie działać tak, jakby elementy w pliku były łączone w wierszu polecenia zamiast @ odwołania. Pliki odpowiedzi nie mogą zawierać dodatkowych plików odpowiedzi.