2020-05-02 06:28:55 +08:00
|
|
|
# vcpkg_copy_tools
|
|
|
|
|
2021-03-11 01:56:07 +08:00
|
|
|
The latest version of this document lives in the [vcpkg repo](https://github.com/Microsoft/vcpkg/blob/master/docs/maintainers/vcpkg_copy_tools.md).
|
2021-03-01 05:17:19 +08:00
|
|
|
|
2020-05-02 06:28:55 +08:00
|
|
|
Copy tools and all their DLL dependencies into the `tools` folder.
|
|
|
|
|
|
|
|
## Usage
|
|
|
|
```cmake
|
|
|
|
vcpkg_copy_tools(
|
|
|
|
TOOL_NAMES <tool1>...
|
|
|
|
[SEARCH_DIR <${CURRENT_PACKAGES_DIR}/bin>]
|
2021-04-01 03:47:35 +08:00
|
|
|
[DESTINATION <${CURRENT_PACKAGES_DIR}/tools/${PORT}>]
|
2020-05-02 06:28:55 +08:00
|
|
|
[AUTO_CLEAN]
|
|
|
|
)
|
|
|
|
```
|
|
|
|
## Parameters
|
|
|
|
### TOOL_NAMES
|
|
|
|
A list of tool filenames without extension.
|
|
|
|
|
|
|
|
### SEARCH_DIR
|
2021-05-10 01:48:42 +08:00
|
|
|
The path to the directory containing the tools. This will be set to `${CURRENT_PACKAGES_DIR}/bin` if omitted.
|
2020-05-02 06:28:55 +08:00
|
|
|
|
2021-04-01 03:47:35 +08:00
|
|
|
### DESTINATION
|
2021-05-10 01:48:42 +08:00
|
|
|
Destination to copy the tools to. This will be set to `${CURRENT_PACKAGES_DIR}/tools/${PORT}` if omitted.
|
2021-04-01 03:47:35 +08:00
|
|
|
|
2020-05-02 06:28:55 +08:00
|
|
|
### AUTO_CLEAN
|
2021-10-27 14:44:43 +08:00
|
|
|
Auto clean the copied executables from `${CURRENT_PACKAGES_DIR}/bin` and `${CURRENT_PACKAGES_DIR}/debug/bin`.
|
2020-05-02 06:28:55 +08:00
|
|
|
|
|
|
|
## Examples
|
|
|
|
|
|
|
|
* [cpuinfo](https://github.com/microsoft/vcpkg/blob/master/ports/cpuinfo/portfile.cmake)
|
|
|
|
* [nanomsg](https://github.com/microsoft/vcpkg/blob/master/ports/nanomsg/portfile.cmake)
|
|
|
|
* [uriparser](https://github.com/microsoft/vcpkg/blob/master/ports/uriparser/portfile.cmake)
|
|
|
|
|
|
|
|
## Source
|
2021-03-01 05:17:19 +08:00
|
|
|
[scripts/cmake/vcpkg\_copy\_tools.cmake](https://github.com/Microsoft/vcpkg/blob/master/scripts/cmake/vcpkg_copy_tools.cmake)
|