aui_link

Alias to target_link_libraries with additional rules (see below)

Syntax#

aui_link(aui.example.views PRIVATE aui::core aui::views aui::audio aui::curl)

aui_link(<target>
       <PRIVATE|PUBLIC|INTERFACE> <item>...
       [<PRIVATE|PUBLIC|INTERFACE> <item>...]...)

In contrast to target_link_libraries, the only one syntax variant is allowed.

The PUBLIC, PRIVATE and INTERFACE scope keywords can be used to specify both the link dependencies and the link interface in one command.

Libraries and targets following PUBLIC are linked to, and are made part of the link interface. Libraries and targets following PRIVATE are linked to, but are not made part of the link interface. Libraries following INTERFACE are appended to the link interface and are not used for linking <target>.

If building with BUILD_SHARED_LIBS=OFF, the following rules apply:

1. Visibility is forced to PUBLIC to propagate static libraries up to the executable.
2. Target <item>s with INTERFACE_AUI_WHOLEARCHIVE=TRUE are wrapped with compiler-specific flags during linkage to enable whole archive linking (i.e., forbid dropping of unused symbols). This is essential when linking to binaries with AUI assets.

3. The <item>s are reordered this way: from the most dependant target to the less dependant target.

   If A depends on B; C depends on both A and B, you should write

   target_link_libraries(C PRIVATE A B)

   and not

   target_link_libraries(C PRIVATE B A)  #Wrong!

© 2025 AUI Framework Contributors. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. All trademarks are property of their respective owners.

Contents

Syntax