Difference between revisions of "Autobuild/Lexicon"
Jump to navigation
Jump to search
m (alphabatize and reformat using term/definition instead of subsections) |
m |
||
| (3 intermediate revisions by 3 users not shown) | |||
| Line 1: | Line 1: | ||
This document defines terms as they are used in the context of [[Autobuild]]. This is not | {{Autobuild Nav}} | ||
This document defines terms as they are used in the context of [[Autobuild]]. This is not design documentation, but rather a resource to help define key phrases and words we use. | |||
<br clear=all/> | |||
; Archive | ; Archive | ||
| Line 12: | Line 14: | ||
; Build Configuration | ; Build Configuration | ||
: A named configuration variant specifically for configuring or building package source. In particular a build configuration selects sets of options to pass to the configuration and compiler executables. | : A named configuration variant specifically for configuring or building package source. In particular a build configuration selects sets of options to pass to the configuration and compiler executables. | ||
; Build Id | |||
: A unique number for the build provided by the --id option to the build subcommand; defaults to a date/time stamp | |||
; Build-time Dependency | ; Build-time Dependency | ||
| Line 17: | Line 22: | ||
; Configuration | ; Configuration | ||
: A superset of all | : A superset of all parameters affecting a build of a given version. The package will need to describe which artifacts are specific to which configurations for downstream builds. config info: Platform, Compiler, Build Variant, CPU architecture. | ||
; Package | ; Package | ||
| Line 40: | Line 45: | ||
: The platform under which the autobuild tool is invoked, e.g. 'darwin' when running an autobuild tool on a Mac running OS X. | : The platform under which the autobuild tool is invoked, e.g. 'darwin' when running an autobuild tool on a Mac running OS X. | ||
[[Category:Open Source Portal]] | [[Category:Autobuild]] [[Category:Open Source Portal]] | ||
Latest revision as of 09:42, 19 March 2015
This document defines terms as they are used in the context of Autobuild. This is not design documentation, but rather a resource to help define key phrases and words we use.
- Archive
- A file containing a set of artifacts used to store and transport dependencies from source builds to dependent builds.
- Artifact
- One or more files from a package that can be dependencies of another build. Some artifacts are the output of the build of a package, like a static library, dll or an executable. Some artifacts can be source for a package that needs to be redistributed, like header files that define symbols in a build.
- Autobuild
- Autobuild is the name of the tool. It is a command line tool supported on Windows, MacOS, and Linux. It is useable by developers and scripts to ease building and maintaining projects from multiple modular sources.
- Build Configuration
- A named configuration variant specifically for configuring or building package source. In particular a build configuration selects sets of options to pass to the configuration and compiler executables.
- Build Id
- A unique number for the build provided by the --id option to the build subcommand; defaults to a date/time stamp
- Build-time Dependency
- A file needed by a build for successful completion. Some artifacts, like header files, are build time dependencies.
- Configuration
- A superset of all parameters affecting a build of a given version. The package will need to describe which artifacts are specific to which configurations for downstream builds. config info: Platform, Compiler, Build Variant, CPU architecture.
- Package
- Metadata that describes the dependencies, artifacts and supported configuration info for a build. The sharing the metadata allows dependent builds to use the artifacts. The metadata should also describe how to start with a source version and produce expected artifacts from a build.
- Package Repository
- A database containing info about available packages and the URLs for finding their versions and artifacts.
- Run-time Dependency
- A file needed by a build to execute its output. Some artifacts, like dlls, are run time dependencies and will need to be redistributed with the output of a dependent build. Artifacts can be both run-time and build-time dependencies. Its up to the dependent build to determine.
- Source Repository
- A location containing the source for a project. The source repository format is not specified, it could be an hg repository or a tarball, etc.
- Version
- A unique and reproducible set of source data for a package.
- Working Copy
- The location where a source is being built. A developer will create a local working copy of source and a package to do development. The artifacts for the working copies dependencies will be copied into the working copies build folder.
- Working Platform
- The platform under which the autobuild tool is invoked, e.g. 'darwin' when running an autobuild tool on a Mac running OS X.