Skip to content

Commit b7c66bc

Browse files
authored
Add runtime_deploy docs (#3789)
* add runtime_deploy * minor changes
1 parent 531ae64 commit b7c66bc

File tree

2 files changed

+5
-3
lines changed

2 files changed

+5
-3
lines changed

reference/commands/install.rst

Lines changed: 4 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -118,13 +118,15 @@ like collecting licenses, generating reports, deploying binaries to the system,
118118
$ conan install . --deployer=full_deploy
119119
120120
121-
There are 2 built-in deployers:
121+
There are 3 built-in deployers:
122122

123123
- ``full_deploy`` does a complete copy of the dependencies binaries in the local folder, with a minimal folder
124124
structure to avoid conflicts between files and artifacts of different packages
125125
- ``direct_deploy`` does a copy of only the immediate direct dependencies, but does not include the transitive
126126
dependencies.
127-
127+
- ``runtime_deploy`` deploys all the shared libraries and the executables of the
128+
dependencies (like ``.so``, ``.dll``, or ``.dylib`` files) into a flat directory
129+
structure. (Available since Conan 2.5.0)
128130

129131
Some generators might have the capability of redefining the target "package folder". That means that if some other
130132
generator like ``CMakeDeps`` is used that is pointing to the packages, it will be pointing to the local deployed

whatsnew.rst

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -57,7 +57,7 @@ Conan 2 has redesigned the CLI for better consistency, removing ambiguities, and
5757

5858
New deployers
5959
-------------
60-
Conan 2 implements “deployers”, which can be called in the command line as ``conan install …. --deployer=mydeploy``, typically to perform copy operations from the Conan cache to user folders. Such deployers can be built-in (“full_deploy” and “direct_deploy” are provided so far), or user-defined, which can be shared and managed with ``conan config install``. Deployers run before generators, and they can change the target folders. For example, if the ``--deployer=full_deploy`` deployer runs before ``CMakeDeps``, the files generated by ``CMakeDeps`` will point to the local copy in the user folder done by the ``full_deploy`` deployer, and not to the Conan cache.
60+
Conan 2 implements “deployers”, which can be called in the command line as ``conan install …. --deployer=mydeploy``, typically to perform copy operations from the Conan cache to user folders. Such deployers can be built-in (“full_deploy”, “direct_deploy” and "runtime_deploy" are provided so far), or user-defined, which can be shared and managed with ``conan config install``. Deployers run before generators, and they can change the target folders. For example, if the ``--deployer=full_deploy`` deployer runs before ``CMakeDeps``, the files generated by ``CMakeDeps`` will point to the local copy in the user folder done by the ``full_deploy`` deployer, and not to the Conan cache.
6161

6262
Deployers can be multi-configuration. Running ``conan install . --deployer=full_deploy`` repeatedly for different profiles, can achieve a fully self-contained project, including all the artifacts, binaries, and build files that is completely independent of Conan and no longer require Conan at all to build.
6363

0 commit comments

Comments
 (0)