Difference between revisions of "Autobuild Shell Functions"
Jump to navigation
Jump to search
Rand Linden (talk | contribs) |
Rand Linden (talk | contribs) |
||
| 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 |