Project-API.md

Core APIs

API	Brief
_ACTION	The action that will be run
_ARGS	Array of action args
_MAIN_SCRIPT
_MAIN_SCRIPT_DIR
_OPTIONS
_OS	The currently targeted operating system
_PREMAKE_COMMAND
_PREMAKE_DIR
_PREMAKE_VERSION	The version of the currently executing instance of Premake
_WORKING_DIR
architecture
atl	Use Microsoft's Active Template Library
basedir
bindirs
buildaction
buildcommands
buildcustomizations
builddependencies
buildinputs
buildlog
buildmessage
buildoptions	Additional build options (passed directly to compiler)
buildoutputs
callingconvention	Sets the function calling convention
cdialect
characterset	Set the character encoding
cleancommands
cleanextensions
clr	Use Microsoft's Common Language Runtime
compileas
compilebuildoutputs
configfile
configmap
configurations
copylocal
cppdialect
customtoolnamespace
debugargs
debugcommand
debugconnectcommands	Debugger commands to execute on remote target connection
debugdir	Working directory for debug session
debugenvs	Env vars for debug session
debugextendedprotocol	Use gdb 'extended' protocol; maintain a persistent connection
debugformat	Format for embedded debug information
debugger
debuggertype
debugport	Port to use for remote debugging
debugremotehost	Target for remote debugging
debugsearchpaths	Search paths for source code while debugging
debugstartupcommands	Debugger commands to execute on debugger startup
defaultconfiguration
defaultplatform
defines
dependson
deploymentoptions
disablewarnings
display
display
editandcontinue
editorintegration	Enable or disable IDE integration
enableunitybuild
enablewarnings
entrypoint	Specify the program entry point function
exceptionhandling	Enable or disable exception handling
external
externalanglebrackets
externalincludedirs
externalrule
externalwarnings
fatalwarnings
fileextension
filename
files
filter
flags
floatabi
floatingpoint
floatingpointexceptions
forceincludes
forceusings
functionlevellinking
gccprefix
group
icon
ignoredefaultlibraries	Specify a list of default libraries to ignore
implibdir
implibextension
implibname
implibprefix
implibsuffix
include
includedirs
includedirsafter
includeexternal
infoplist	Sets the Apple ap bundle infos.
inlining	Tells the compiler when it should inline functions
intrinsics
kind
language
largeaddressaware
libdirs
linkbuildoutputs
linkgroups	Turn on/off linkgroups for gcc/clang
linkoptions	Additional linker options (passed directly to linker)
links
locale
location	Specifies the directory for the generated workspace/project file
makesettings
namespace
nativewchar
nuget
nugetsource
objdir	Output dir for object/intermediate files
optimize	Optimization level
pchheader	Precompiled header file
pchsource	Precompiled header source file (which should build the PCH)
pic	Position independent code
platforms
postbuildcommands
postbuildmessage
prebuildcommands
prebuildmessage
preferredtoolarchitecture
prelinkcommands
prelinkmessage
project
propertydefinition
rebuildcommands
resdefines
resincludedirs
resoptions
resourcegenerator
rtti	Enable or disable runtime type information
rule
rules
runtime
sanitize	Enable fsanitize compiler options
sharedlibtype
startproject
strictaliasing
stringpooling
symbols	Turn symbol generation on/off
symbolspath	Allows you to specify the target location of the symbols
syslibdirs
system
tags
targetdir
targetextension
targetname
targetprefix
targetsuffix
toolset
toolsversion
undefines
usingdirs
uuid	Set project GUID (for VS projects/workspaces)
vectorextensions	Enable hardware vector extensions
vpaths
warnings
wholearchive
workspace

Builtin Extension APIs

The following API reference is for use with various built-in extensions.

Xcode APIs	Brief
xcodebuildsettings
xcodebuildresources