Распространенные параметры команды

Большинство команд vcpkg принимают группу распространенных параметров, которые управляют перекрестными аспектами инструмента. Не все параметры влияют на каждую команду. Например, команда, которая не загружает файлы, не влияет на изменение каталога скачиваемых файлов.

Параметры

--x-asset-sources=<config>

Примечание.

В этом разделе рассматривается экспериментальная функция vcpkg, которая может изменяться или удаляться в любое время.

Укажите конфигурацию кэша для кэширования активов.

--binarysource=<config>

Добавьте источник для двоичного кэширования.

Этот параметр можно указать несколько раз; Сведения о взаимодействии с несколькими двоичными источниками см. в документации по кэшированию двоичных файлов.

--x-buildtrees-root=<path>

Примечание.

В этом разделе рассматривается экспериментальная функция vcpkg, которая может изменяться или удаляться в любое время.

Указывает временный путь для хранения промежуточных файлов сборки, таких как объекты или распаковка исходного кода.

По умолчанию используется buildtrees/ корневая папка vcpkg.

--classic

Принудительно выполняется классический режим, даже если обнаружен файл манифеста.

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

Примечание.

В этом разделе рассматривается экспериментальная функция vcpkg, которая может изменяться или удаляться в любое время.

Включает CMake --debugger в системах CMakeLists.txtвышестоящей сборки, например внутри vcpkg_cmake_configure.

Значение <debugger-pipe> передается как --debugger-pipe в командной строке CMake.

Если в этом списке есть список портов с запятой, отладчик используется только для портов в этом списке. В противном случае он используется для всех портов.

Переменная VCPKG_CMAKE_CONFIGURE_OPTIONS триплета используется для передачи параметров внутреннему вызову конфигурации CMake. Таким образом, он не будет работать для пользовательских тройных перезаписи VCPKG_CMAKE_CONFIGURE_OPTIONS. Передайте параметры отладки вручную или добавьте параметры VCPKG_CMAKE_CONFIGURE_OPTIONS .

В отличие от выходных данных, указывающих --x-cmake-debug , что сборка ожидает подключения отладчика. Выходные данные просто застоят.Configuring <triplet>

Хотя все порты должны вызывать CMake внутри порта, чтобы получить флаги компиляции из цепочки инструментов CMake. Эта команда в основном полезна для портов, фактически использующих CMake в качестве системы сборки.

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

Примечание.

В этом разделе рассматривается экспериментальная функция vcpkg, которая может изменяться или удаляться в любое время.

Включает CMake во время выполнения скриптов CMake --debugger напрямую, таких как тройные файлы (например, x64-windows.cmake) или portfile.cmake файлы.

Значение <debugger-pipe> передается как --debugger-pipe в командной строке CMake.

Если в этом списке есть список портов с запятой, отладчик используется только для портов в этом списке. В противном случае он используется для всех портов.

Примечание. Отладчик можно подключить, если Waiting for debugger client to connect... его можно наблюдать в выходных данных vcpkg и выполнение будет остановлено до подключения отладчика.

--downloads-root=<path>

Укажите, где должны храниться скачанные средства и архивы исходного кода.

По умолчанию используется VCPKG_DOWNLOADS переменная среды. Если это не задано, по умолчанию используется downloads/ корневая папка vcpkg.

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

Эта переменная может быть задана в списке флагов функций, чтобы принять участие в экспериментальном поведении.

--host-triplet=<triplet>

Укажите триплет узла.

По умолчанию используется VCPKG_DEFAULT_HOST_TRIPLET переменная среды. Если это также не задано, значение выводится на основе архитектуры узла и операционной системы.

--x-install-root=<path>

Примечание.

В этом разделе рассматривается экспериментальная функция vcpkg, которая может изменяться или удаляться в любое время.

Указывает путь для размещения установленных пакетов.

В классическом режиме по умолчанию используется installed/ корневая папка vcpkg.

В режиме манифеста по умолчанию используется vcpkg_installed/ папка манифеста.

--x-manifest-root=<path>

Примечание.

В этом разделе рассматривается экспериментальная функция vcpkg, которая может изменяться или удаляться в любое время.

Указывает каталог, vcpkg.jsonсодержащий .

По умолчанию выполняется поиск вверх от текущего рабочего каталога для ближайшего vcpkg.json.

--overlay-ports=<path>

Указывает каталог либо порт наложения, либо подкаталоги, которые сами являются портами наложения. Если <path> каталог содержит CONTROL или vcpkg.json, он рассматривается как каталог порта наложения, а вложенные каталоги не будут считаться дополнительными портами наложения.

Этот параметр можно указать несколько раз; порты будут разрешаться в первом совпадении.

--overlay-triplets=<path>

Указывает каталог, содержащий триплеты наложения.

Этот параметр можно указать несколько раз, чтобы добавить несколько каталогов; Триплеты будут разрешаться в первом совпадении по имени.

--x-packages-root=<path>

Примечание.

В этом разделе рассматривается экспериментальная функция vcpkg, которая может изменяться или удаляться в любое время.

Указывает временный путь к промежуточным файлам пакета перед окончательной установкой.

По умолчанию используется packages/ корневая папка vcpkg.

--triplet=<triplet>

Укажите триплет целевой архитектуры.

По умолчанию используется VCPKG_DEFAULT_TRIPLET переменная среды. Если это не задано, выводится на основе архитектуры узла и операционной системы.

В операционных системах Windows архитектура всегда выводится как x86 по устаревшим причинам.

Примечание.

Все выпуски, сделанные в сентябре 2023 года, по умолчанию будут входить в состав узла в Windows вместо x86-windows.

--vcpkg-root=<path>

Указывает корневую папку vcpkg.

По умолчанию используется каталог, содержащий программу vcpkg. Каталог должен быть допустимым экземпляром vcpkg, например git clone https://github.com/microsoft/vcpkg. Этот параметр можно использовать для запуска пользовательской копии средства непосредственно из папки сборки.

Файлы ответов (@<file>)

Командная строка vcpkg принимает текстовые файлы, содержащие параметры командной строки, разделенные новой строкой.

Средство будет работать так, как будто элементы в файле были сложены в командную строку вместо @ ссылки. Файлы ответов не могут содержать дополнительные файлы ответа.