The link order

The link order depends on the order of library definitions and dependencies in the Project.meta files.

In general, if a library X depends on a library Y, the library X must be linked before Y.

Example:

Project A:

Dependency B
Dependency C

Project B:

Dependency D

Project C:

Dependency D

Project D:

The link order will be

• Objects of A

• B

• C

• D

Same example but with external libraries:

Project A:

ExternalLibrary a1
Dependency B
ExternalLibrary a2
Dependency C
ExternalLibrary a3

Project B:

ExternalLibrary b1
Dependency D
ExternalLibrary b2

Project C:

ExternalLibrary c1
Dependency D
ExternalLibrary c2

Project D:

ExternalLibrary d1
ExternalLibrary d2

The link order will be

• Objects of A

• a1

• B

• b1

• b2

• a2

• C

• c1

• D

• d1

• d2

• c2

• a3

Notes:

The executable will be automatically relinked, if a regular library (LibraryConfig) has been updated (file timestamp).

This does NOT apply to ExternalLibraries, because these are arguments given to the linker which searches itself for the libraries. Exception: if an ExternalLibrary is specified with “search: false”, the exact library is known to bake and is also taken into account.