Cmake add_library ALIAS












2















I am trying to figure out exactly what this line is for in the cmake file of this github json project,



add_library(${NLOHMANN_JSON_TARGET_NAME} INTERFACE)
add_library(${PROJECT_NAME}::${NLOHMANN_JSON_TARGET_NAME} ALIAS ${NLOHMANN_JSON_TARGET_NAME})


Specifically with this example, what does this allow in this cmake file that otherwise would not be possible?



I see no other references to ${PROJECT_NAME}::${NLOHMANN_JSON_TARGET_NAME} in this CMakeLists.cmake, so I am confused as to what exactly this achieves.



Edit:



The key thing that this achieves, that the comment did not make obvious to me, is that it makes the targets work with the namespaces when the project is used through add_subdirectory()










share|improve this question





























    2















    I am trying to figure out exactly what this line is for in the cmake file of this github json project,



    add_library(${NLOHMANN_JSON_TARGET_NAME} INTERFACE)
    add_library(${PROJECT_NAME}::${NLOHMANN_JSON_TARGET_NAME} ALIAS ${NLOHMANN_JSON_TARGET_NAME})


    Specifically with this example, what does this allow in this cmake file that otherwise would not be possible?



    I see no other references to ${PROJECT_NAME}::${NLOHMANN_JSON_TARGET_NAME} in this CMakeLists.cmake, so I am confused as to what exactly this achieves.



    Edit:



    The key thing that this achieves, that the comment did not make obvious to me, is that it makes the targets work with the namespaces when the project is used through add_subdirectory()










    share|improve this question



























      2












      2








      2








      I am trying to figure out exactly what this line is for in the cmake file of this github json project,



      add_library(${NLOHMANN_JSON_TARGET_NAME} INTERFACE)
      add_library(${PROJECT_NAME}::${NLOHMANN_JSON_TARGET_NAME} ALIAS ${NLOHMANN_JSON_TARGET_NAME})


      Specifically with this example, what does this allow in this cmake file that otherwise would not be possible?



      I see no other references to ${PROJECT_NAME}::${NLOHMANN_JSON_TARGET_NAME} in this CMakeLists.cmake, so I am confused as to what exactly this achieves.



      Edit:



      The key thing that this achieves, that the comment did not make obvious to me, is that it makes the targets work with the namespaces when the project is used through add_subdirectory()










      share|improve this question
















      I am trying to figure out exactly what this line is for in the cmake file of this github json project,



      add_library(${NLOHMANN_JSON_TARGET_NAME} INTERFACE)
      add_library(${PROJECT_NAME}::${NLOHMANN_JSON_TARGET_NAME} ALIAS ${NLOHMANN_JSON_TARGET_NAME})


      Specifically with this example, what does this allow in this cmake file that otherwise would not be possible?



      I see no other references to ${PROJECT_NAME}::${NLOHMANN_JSON_TARGET_NAME} in this CMakeLists.cmake, so I am confused as to what exactly this achieves.



      Edit:



      The key thing that this achieves, that the comment did not make obvious to me, is that it makes the targets work with the namespaces when the project is used through add_subdirectory()







      cmake






      share|improve this question















      share|improve this question













      share|improve this question




      share|improve this question








      edited Nov 19 '18 at 18:56







      rmawatson

















      asked Nov 18 '18 at 23:27









      rmawatsonrmawatson

      1,088312




      1,088312
























          2 Answers
          2






          active

          oldest

          votes


















          1














          This will allow using nlohmann/json project by adding it into your super project with add_subdirectory(...)



          For example simple project structure:



          <root project>
          thirdpartyjson <<-- git submodule to https://github.com/nlohmann/json
          include
          src
          CMakeLists.txt


          In your project CMakeLists.txt



          ...
          project(mySuperApp)

          set(mySuperApp_SRC src/main.c)

          # can under some conditions...
          add_subdirectory(thirdparty/json)

          add_executable(${PROJECT_NAME} ${mySuperApp_SRC})
          target_link_libraries(${PROJECT_NAME} PRIVATE nlohmann_json::nlohmann_json)





          share|improve this answer































            1














            Using git's blame function shows that line was added in this commit: 33a2154, which has the following comment attached:




            CMake convention is to use a project namespace, i.e. Foo::, for imported
            targets. When multiple targets are imported from a project, this looks
            like Foo::Bar1 Foo::Bar2, etc. This adds the nlohmann_json:: namespace to
            the exported target names.



            This also allows the generated project config files to be used from the
            build directory instead of just the install directory.







            share|improve this answer
























            • Thanks. although commenting out this line, and generating the build again, results in identical output for the generated config files.

              – rmawatson
              Nov 19 '18 at 0:22











            Your Answer






            StackExchange.ifUsing("editor", function () {
            StackExchange.using("externalEditor", function () {
            StackExchange.using("snippets", function () {
            StackExchange.snippets.init();
            });
            });
            }, "code-snippets");

            StackExchange.ready(function() {
            var channelOptions = {
            tags: "".split(" "),
            id: "1"
            };
            initTagRenderer("".split(" "), "".split(" "), channelOptions);

            StackExchange.using("externalEditor", function() {
            // Have to fire editor after snippets, if snippets enabled
            if (StackExchange.settings.snippets.snippetsEnabled) {
            StackExchange.using("snippets", function() {
            createEditor();
            });
            }
            else {
            createEditor();
            }
            });

            function createEditor() {
            StackExchange.prepareEditor({
            heartbeatType: 'answer',
            autoActivateHeartbeat: false,
            convertImagesToLinks: true,
            noModals: true,
            showLowRepImageUploadWarning: true,
            reputationToPostImages: 10,
            bindNavPrevention: true,
            postfix: "",
            imageUploader: {
            brandingHtml: "Powered by u003ca class="icon-imgur-white" href="https://imgur.com/"u003eu003c/au003e",
            contentPolicyHtml: "User contributions licensed under u003ca href="https://creativecommons.org/licenses/by-sa/3.0/"u003ecc by-sa 3.0 with attribution requiredu003c/au003e u003ca href="https://stackoverflow.com/legal/content-policy"u003e(content policy)u003c/au003e",
            allowUrls: true
            },
            onDemand: true,
            discardSelector: ".discard-answer"
            ,immediatelyShowMarkdownHelp:true
            });


            }
            });














            draft saved

            draft discarded


















            StackExchange.ready(
            function () {
            StackExchange.openid.initPostLogin('.new-post-login', 'https%3a%2f%2fstackoverflow.com%2fquestions%2f53366477%2fcmake-add-library-alias%23new-answer', 'question_page');
            }
            );

            Post as a guest















            Required, but never shown

























            2 Answers
            2






            active

            oldest

            votes








            2 Answers
            2






            active

            oldest

            votes









            active

            oldest

            votes






            active

            oldest

            votes









            1














            This will allow using nlohmann/json project by adding it into your super project with add_subdirectory(...)



            For example simple project structure:



            <root project>
            thirdpartyjson <<-- git submodule to https://github.com/nlohmann/json
            include
            src
            CMakeLists.txt


            In your project CMakeLists.txt



            ...
            project(mySuperApp)

            set(mySuperApp_SRC src/main.c)

            # can under some conditions...
            add_subdirectory(thirdparty/json)

            add_executable(${PROJECT_NAME} ${mySuperApp_SRC})
            target_link_libraries(${PROJECT_NAME} PRIVATE nlohmann_json::nlohmann_json)





            share|improve this answer




























              1














              This will allow using nlohmann/json project by adding it into your super project with add_subdirectory(...)



              For example simple project structure:



              <root project>
              thirdpartyjson <<-- git submodule to https://github.com/nlohmann/json
              include
              src
              CMakeLists.txt


              In your project CMakeLists.txt



              ...
              project(mySuperApp)

              set(mySuperApp_SRC src/main.c)

              # can under some conditions...
              add_subdirectory(thirdparty/json)

              add_executable(${PROJECT_NAME} ${mySuperApp_SRC})
              target_link_libraries(${PROJECT_NAME} PRIVATE nlohmann_json::nlohmann_json)





              share|improve this answer


























                1












                1








                1







                This will allow using nlohmann/json project by adding it into your super project with add_subdirectory(...)



                For example simple project structure:



                <root project>
                thirdpartyjson <<-- git submodule to https://github.com/nlohmann/json
                include
                src
                CMakeLists.txt


                In your project CMakeLists.txt



                ...
                project(mySuperApp)

                set(mySuperApp_SRC src/main.c)

                # can under some conditions...
                add_subdirectory(thirdparty/json)

                add_executable(${PROJECT_NAME} ${mySuperApp_SRC})
                target_link_libraries(${PROJECT_NAME} PRIVATE nlohmann_json::nlohmann_json)





                share|improve this answer













                This will allow using nlohmann/json project by adding it into your super project with add_subdirectory(...)



                For example simple project structure:



                <root project>
                thirdpartyjson <<-- git submodule to https://github.com/nlohmann/json
                include
                src
                CMakeLists.txt


                In your project CMakeLists.txt



                ...
                project(mySuperApp)

                set(mySuperApp_SRC src/main.c)

                # can under some conditions...
                add_subdirectory(thirdparty/json)

                add_executable(${PROJECT_NAME} ${mySuperApp_SRC})
                target_link_libraries(${PROJECT_NAME} PRIVATE nlohmann_json::nlohmann_json)






                share|improve this answer












                share|improve this answer



                share|improve this answer










                answered Nov 19 '18 at 15:10









                Sergei NikulovSergei Nikulov

                4,2251731




                4,2251731

























                    1














                    Using git's blame function shows that line was added in this commit: 33a2154, which has the following comment attached:




                    CMake convention is to use a project namespace, i.e. Foo::, for imported
                    targets. When multiple targets are imported from a project, this looks
                    like Foo::Bar1 Foo::Bar2, etc. This adds the nlohmann_json:: namespace to
                    the exported target names.



                    This also allows the generated project config files to be used from the
                    build directory instead of just the install directory.







                    share|improve this answer
























                    • Thanks. although commenting out this line, and generating the build again, results in identical output for the generated config files.

                      – rmawatson
                      Nov 19 '18 at 0:22
















                    1














                    Using git's blame function shows that line was added in this commit: 33a2154, which has the following comment attached:




                    CMake convention is to use a project namespace, i.e. Foo::, for imported
                    targets. When multiple targets are imported from a project, this looks
                    like Foo::Bar1 Foo::Bar2, etc. This adds the nlohmann_json:: namespace to
                    the exported target names.



                    This also allows the generated project config files to be used from the
                    build directory instead of just the install directory.







                    share|improve this answer
























                    • Thanks. although commenting out this line, and generating the build again, results in identical output for the generated config files.

                      – rmawatson
                      Nov 19 '18 at 0:22














                    1












                    1








                    1







                    Using git's blame function shows that line was added in this commit: 33a2154, which has the following comment attached:




                    CMake convention is to use a project namespace, i.e. Foo::, for imported
                    targets. When multiple targets are imported from a project, this looks
                    like Foo::Bar1 Foo::Bar2, etc. This adds the nlohmann_json:: namespace to
                    the exported target names.



                    This also allows the generated project config files to be used from the
                    build directory instead of just the install directory.







                    share|improve this answer













                    Using git's blame function shows that line was added in this commit: 33a2154, which has the following comment attached:




                    CMake convention is to use a project namespace, i.e. Foo::, for imported
                    targets. When multiple targets are imported from a project, this looks
                    like Foo::Bar1 Foo::Bar2, etc. This adds the nlohmann_json:: namespace to
                    the exported target names.



                    This also allows the generated project config files to be used from the
                    build directory instead of just the install directory.








                    share|improve this answer












                    share|improve this answer



                    share|improve this answer










                    answered Nov 18 '18 at 23:42









                    KiskaeKiskae

                    12.7k12838




                    12.7k12838













                    • Thanks. although commenting out this line, and generating the build again, results in identical output for the generated config files.

                      – rmawatson
                      Nov 19 '18 at 0:22



















                    • Thanks. although commenting out this line, and generating the build again, results in identical output for the generated config files.

                      – rmawatson
                      Nov 19 '18 at 0:22

















                    Thanks. although commenting out this line, and generating the build again, results in identical output for the generated config files.

                    – rmawatson
                    Nov 19 '18 at 0:22





                    Thanks. although commenting out this line, and generating the build again, results in identical output for the generated config files.

                    – rmawatson
                    Nov 19 '18 at 0:22


















                    draft saved

                    draft discarded




















































                    Thanks for contributing an answer to Stack Overflow!


                    • Please be sure to answer the question. Provide details and share your research!

                    But avoid



                    • Asking for help, clarification, or responding to other answers.

                    • Making statements based on opinion; back them up with references or personal experience.


                    To learn more, see our tips on writing great answers.




                    draft saved


                    draft discarded














                    StackExchange.ready(
                    function () {
                    StackExchange.openid.initPostLogin('.new-post-login', 'https%3a%2f%2fstackoverflow.com%2fquestions%2f53366477%2fcmake-add-library-alias%23new-answer', 'question_page');
                    }
                    );

                    Post as a guest















                    Required, but never shown





















































                    Required, but never shown














                    Required, but never shown












                    Required, but never shown







                    Required, but never shown

































                    Required, but never shown














                    Required, but never shown












                    Required, but never shown







                    Required, but never shown







                    Popular posts from this blog

                    Guess what letter conforming each word

                    Port of Spain

                    Run scheduled task as local user group (not BUILTIN)