Skip to content

workspaces: document conanws.cmake file generation #784

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Closed
wants to merge 1 commit into from
Closed

workspaces: document conanws.cmake file generation #784

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
9 changes: 8 additions & 1 deletion changelog.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -23,6 +23,14 @@ Check https://github.com/conan-io/conan for issues and more details about develo
Read more about the :ref:`Conan stability commitment<stability>`.


1.8.1 (??-??-2018)
------------------

**Breaking changes**

- Feature: **[Experimental]** Workspaces generate a *conanws.cmake* file instead of a root *CMakeLists.txt*. You have to write the latter yourself (and include the newly generated file).


1.8.0 (9-October-2018)
-----------------------

Expand Down Expand Up @@ -151,7 +159,6 @@ Check https://github.com/conan-io/conan for issues and more details about develo
- BugFix: Fixed detection of a valid repository for Git in the SCM feature.



1.6.1 (27-July-2018)
--------------------

Expand Down
15 changes: 14 additions & 1 deletion developing_packages/workspaces.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -81,7 +81,20 @@ Note that nothing will really be installed in the local cache. All the dependenc
Also, all the generated *conanbuildinfo.cmake* files for the dependencies are installed in the *build* folder. You can inspect them to check
that the paths they define for their dependencies are user folders. They don't point to the local cache.

As defined in the *conanws.yml*, a root *CMakeLists.txt* is generated for us. We can use it to generate the super-project and build it:
Additionally, a *conanws.cmake* file was generated for us in the build folder. This file contains a list of *add_subdirectory* commands. It will be updated everytime you run *conan install*, we only have to include it in our root *CMakeLists.txt*:

.. code-block:: cmake

cmake_minimum_required(VERSION 3.3)

project(Hello VERSION 0.1 LANGUAGES CXX)

set(CMAKE_CXX_STANDARD 11)
set(CMAKE_CXX_EXTENSIONS OFF)

include(${CMAKE_CURRENT_BINARY_DIR}/conanws.cmake)

Now, we can generate the super-project and build it:

.. code-block:: bash

Expand Down