43 lines
1.2 KiB
Markdown
43 lines
1.2 KiB
Markdown
|
---
|
||
|
|
title: Linking
|
||
|
|
---
|
||
|
|
|
||
|
|
Linking to external libraries is done with the [`links`](links) function.
|
||
|
|
|
||
|
|
```lua
|
||
|
|
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.
|
||
|
|
|
||
|
|
```lua
|
||
|
|
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.
|
||
|
|
|
||
|
|
```lua
|
||
|
|
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`](libdirs) function.
|
||
|
|
|
||
|
|
```lua
|
||
|
|
libdirs { "libs", "../mylibs" }
|
||
|
|
```
|
||
|
|
|
||
|
|
If you need to discover the location of a library, use the [`os.findlib`](os.findlib) function.
|
||
|
|
|
||
|
|
```lua
|
||
|
|
libdirs { os.findlib("X11") }
|
||
|
|
```
|