Difference between revisions of "Autobuild Shell Functions"

From Second Life Wiki
Jump to: navigation, search
(Windows-only commands)
Line 43: Line 43:
 
! Description
 
! Description
 
|- style="vertical-align: top;"
 
|- style="vertical-align: top;"
| build_vcproj $vcproj $config
+
|width=200| build_vcproj $vcproj $config
| Launches a Visual Studio build of $vcproj, building configuration $config. If $USE_INCREDIBUILD is set, the same build is launched via BuildConsole, Incredibuild's command-line launcher.
+
| Launches a Visual Studio build of $vcproj, building configuration $config.  
 +
If $USE_INCREDIBUILD is set, the same build is launched via BuildConsole, Incredibuild's command-line launcher.
  
 
|- style="vertical-align: top;"
 
|- style="vertical-align: top;"
 
| build_sln $sln $config $project
 
| build_sln $sln $config $project
| Launches a Visual Studio build using the solution file $sln, configuration $config, and specifying project $project.  If $project is omitted, then the entire solution will be built.
+
| Launches a Visual Studio build using the solution file $sln, configuration $config, and specifying project $project.   
 +
If $project is omitted, then the entire solution will be built.
  
 
|- style="vertical-align: top;"
 
|- style="vertical-align: top;"

Revision as of 11:21, 9 March 2011


Autobuild offers a set of shell functions for use in build-cmd.sh scripts which can be added to the environment by inserting the following line into any build script:
<bash>eval "$("$AUTOBUILD" source_environment)"</bash>

The exact shell code that is injected into your environment upon execution of this command is here.

General functions

Shell functions provided by autobuild:

Function Description
pass Indicates build has succeeded
fail $comment Indicates build has failed, citing $comment in the output
fetch_archive $url $archive $md5 Uses curl to download $archive from the $url and checks the downloaded file hash against the $md5 provided.
extract $file Extracts contents of an archive appropriate for the tar extension of $file.
calc_md5 $file Calculate the md5 of $file

Windows-only commands

Windows-only shell commands (Cygwin):

Function Description
build_vcproj $vcproj $config Launches a Visual Studio build of $vcproj, building configuration $config.

If $USE_INCREDIBUILD is set, the same build is launched via BuildConsole, Incredibuild's command-line launcher.

build_sln $sln $config $project Launches a Visual Studio build using the solution file $sln, configuration $config, and specifying project $project.

If $project is omitted, then the entire solution will be built.

load_vsvars Import Visual Studio paths, includes and libs into the shell environment