vcpkg 常用命令 - Install
注意：所有以x开头的命令或参数目前都只是实验性质的。
.\vcpkg.exe install {port name}:{triplets} {可选参数}
可选参数
|
命令 |
说明 |
|
--dry-run |
不做任何实质上的下载和安装，仅显示将要被安装的库的名称和版本 |
|
--debug |
显示详细的库的安装时所需要的环境 |
|
--head |
安装库的最新的版本 |
|
--no-downloads |
不下载新的资源 |
|
--only-downloads |
只下载资源包但是不构建 |
|
--only-binarycaching |
本次安装使用二进制缓存文件进行安装，如果不存在二进制缓存文件，则安装失败 |
|
--recurse |
允许在安装过程中删除软件包 |
|
--keep-going |
当一条安装命令中包含多个库时，一个库安装失败时，整条命令不会终止，而是继续安装下一个库 |
|
--editable |
使下载下来的库的原文件可被编辑 |
|
--clean-after-build |
在每一个库构建完成后清理 buildtrees下库的源文件, packages 和 downloads 下的库相关的文件 |
|
--clean-buildtrees-after-build |
在每一个库构建完成后清理 buildtrees 文件夹 |
|
--clean-packages-after-build |
在每一个库构建完成后清理 packages 文件夹 |
|
--clean-downloads-after-build |
在每一个库构建完成后清理 downloads 文件夹 |
|
--triplet=<t> |
指定目标的triplet，和直接在库名称后面以“:xxx”形式添加的triplet功能一致 |
|
--host-triplet=<t> |
指定主机的triplet |
|
--overlay-ports=<path> |
指定port文件所在用的目录，详情参见：Overlay ports |
|
--overlay-triplets=<path> |
指定triplets文件所在的路径，详情参见：Overlay triplets
|
|
--binarysource=<path> |
指定binary cache的路径，而不是使用默认的 %USERPROFILE%\AppData\Local\vcpkg\archives |
|
--downloads-root=<path> |
指定downloads-root的路径，而不是使用默认的.\vcpkg\downloads |
|
--vcpkg-root=<path> |
指定vcpkg-root的路径，即vcpkg.exe所在的路径，使用此参数后，vcpkg的其他文件夹，比如buildtrees, installed之类的都会以此路径为基准进行设置，若此路径下没有可用的vcpkg的相关文件，则安装失败 |
|
--x-write-nuget-packages-config=… |
生成一个自定义名称的文件，此文件以NuGet packages.config格式记录了当前安装的库的信息。 文件的名称就是等号后面的参数，比如命令为.\vcpkg.exe install abseil --x-write-nuget-packages-config=123，则在vcpkg.exe同级目录下生成一个以123为名称的文件，文件内容如下: <?xml version="1.0" encoding="utf-8"?> <packages> <package id="abseil_x86-windows" version="2021.3.24-vcpkge6b53c1a244a2cb4eb9f049fb4fc04e00d6682579fac1785fda70e541e759870"/> </packages> |
|
--x-use-aria2 |
使用aria2来执行下载任务 |
|
--x-buildtrees-root=<path> |
指定buildtrees-root的路径，而不是使用默认的.\vcpkg\buildtrees |
|
--x-install-root=<path> |
指定installed-root的路径，而不是使用默认的.\vcpkg\installed |
|
--x-packages-root=<path> |
指定packages-root的路径，而不是使用默认的.\vcpkg\packages |
|
--x-scripts-root=<path> |
指定scripts-root的路径，而不是使用默认的.\vcpkg\scripts PS F:\vcpkg\vcpkg-feature-bug-test> .\vcpkg.exe install sqlite3 --x-scripts-root=../scripts --debug 目前此功能还没完成，无法成功安装port |
|
--x-builtin-ports-root=<path> |
指定ports-root的路径，而不是使用默认的.\vcpkg\ports |
|
--x-builtin-registry-versions-dir=<path> |
指定versions-root的路径，而不是使用默认的.\vcpkg\versions |
