Skip to main content

Linking

Linking to external libraries is done with the links function.

links { "png", "zlib" }

When specifying libraries, system-specific decorations, such as prefixes or file extensions, should be omitted. Premake will synthesize the correct format based on the target platform automatically. The one exception to the rule is Mac OS X frameworks, where the file extension is required to identify it as such.

links { "Cocoa.framework" }

To link to a sibling project (a project in the same workspace) use the project name. Premake will deduce the correct library path and name based on the current platform and configuration.

workspace "MyWorkspace"

   project "MyLibraryProject"
      -- ...project settings here...

   project "MyExecutableProject"
      -- ...project settings here...
      links { "MyLibraryProject" }

Finding Libraries​

You can tell Premake where to search for libraries with the libdirs function.

libdirs { "libs", "../mylibs" }

If you need to discover the location of a library, use the os.findlib function.

libdirs { os.findlib("X11") }

Linker​

The linker defaults to the specified toolset default linker, but can be changed with the linker flag.