esp-idf/examples/build_system/cmake/import_lib
Renz Christian Bagaporo 3882e48e8a cmake: use new signature form of target_link_library to link components
!4452 used setting LINK_LIBRARIES and INTERFACE_LINK_LIBRARIES to link
components built under ESP-IDF build system. However, LINK_LIBRARIES does
not produce behavior same as linking PRIVATE. This MR uses the new
signature for target_link_libraries directly instead. This also moves
setting dependencies during component registration rather than after all
components have been processed.

The consequence is that internally, components have to use the new
signature form as well. This does not affect linking the components to
external targets, such as with idf_as_lib example. This only affects
linking additional libraries to ESP-IDF libraries outside component processing (after
idf_build_process), which is not even possible for CMake<v3.13 as
target_link_libraries is not valid for targets not created in current
directory. See https://cmake.org/cmake/help/v3.13/policy/CMP0079.html#policy:CMP0079
2019-06-11 18:09:26 +08:00
..
main cmake: use new signature form of target_link_library to link components 2019-06-11 18:09:26 +08:00
CMakeLists.txt examples: update with build system changes 2019-05-14 18:01:14 +08:00
partitions_example.csv examples: generic cmake support examples 2018-11-27 13:59:26 +08:00
README.md examples: generic cmake support examples 2018-11-27 13:59:26 +08:00
sdkconfig.defaults examples: generic cmake support examples 2018-11-27 13:59:26 +08:00

Import Third-Party CMake Library Example

This example demonstrates how to import third-party CMake libraries.

Example Flow

tinyxml2 is a a small C++ XML parser. It is imported, without modification, for use in the project's main component (see the main component's CMakeLists.txt). To demonstrate the library being used, a sample XML is embedded into the project. This sample XML is then read and parsed later on using tinyxml2.

Output

I (317) example: Setting up...
I (317) example: Copying sample XML to filesystem...
I (647) example: Reading XML file
I (657) example: Read XML data:
<?xml version="1.0" encoding="UTF-8"?>
<note>
    <to>Tove</to>
    <from>Jani</from>
    <heading>Reminder</heading>
    <body>Don't forget me this weekend!</body>
</note>

I (667) example: Parsed XML data:

To: Tove
From: Jani
Heading: Reminder
Body: Don't forget me this weekend!
I (677) example: Example end

There is a discussion on importing third-party CMake libraries in the programming guide under API Guides -> Build System (CMake) -> Using Third-Party CMake Projects with Components