Difference between revisions of "AMBuild"

From AlliedModders Wiki
Jump to: navigation, search
(Created page with "AMBuild is a tool for software projects to their build source code and create packages for release. It is targeted at C++ projects, though it can be used for anything. It has ...")
 
m
Line 1: Line 1:
 +
=Introduction=
 +
 
AMBuild is a tool for software projects to their build source code and create packages for release. It is targeted at C++ projects, though it can be used for anything. It has been tailored to solve three major problems that most build tools do not address:
 
AMBuild is a tool for software projects to their build source code and create packages for release. It is targeted at C++ projects, though it can be used for anything. It has been tailored to solve three major problems that most build tools do not address:
 
*'''Accuracy'''. AMBuild guarantees that you never need to "clean" a build. Clean rebuilds are unnecessary and a waste of developer time. Builds are always computed accurately, and any failure to do so is considered a bug in AMBuild.
 
*'''Accuracy'''. AMBuild guarantees that you never need to "clean" a build. Clean rebuilds are unnecessary and a waste of developer time. Builds are always computed accurately, and any failure to do so is considered a bug in AMBuild.
Line 4: Line 6:
 
*'''Flexibility'''. Distributing C++ software is hard. AMBuild provides full tuning of the C++ compiler and offers abstraction and introspection of system properties, to avoid boilerplate often seen with Make or Autoconf. Build scripts are written in Python, offering a great deal of programmatic control.
 
*'''Flexibility'''. Distributing C++ software is hard. AMBuild provides full tuning of the C++ compiler and offers abstraction and introspection of system properties, to avoid boilerplate often seen with Make or Autoconf. Build scripts are written in Python, offering a great deal of programmatic control.
  
AMBuild is both a frontend and a backend. Build scripts are written in Python and have access to the AMBuild API. AMBuild parses these scripts and generates ''build targets''. For example, the default target is AMBuild itself; builds will be performed using AMBuild's own dependency graph and parallelization algorithms. However, AMBuild can also generate Visual Studio Project files.
+
Keep in mind, AMBuild is neither widely used nor has it been used on a wide variety of systems. AlliedModders has used it successfully for small to medium-sized C++ projects on Linux, Mac, and Windows. We're happy to receive feedback (see the bottom of this page).
  
Keep in mind, AMBuild is neither widely used nor has it been used on a wide variety of systems. AlliedModders has used it successfully for small to medium-sized C++ projects on Linux, Mac, and Windows. We're happy to receive feedback (see the bottom of this page).
+
=Overview=

Revision as of 17:44, 14 October 2013

Introduction

AMBuild is a tool for software projects to their build source code and create packages for release. It is targeted at C++ projects, though it can be used for anything. It has been tailored to solve three major problems that most build tools do not address:

  • Accuracy. AMBuild guarantees that you never need to "clean" a build. Clean rebuilds are unnecessary and a waste of developer time. Builds are always computed accurately, and any failure to do so is considered a bug in AMBuild.
  • Speed. Most build systems discover changes by recursively searching downward through all build steps and their dependencies. This is very slow. AMBuild instead computes the set of files that have changed, and propagates those changes upward, to each build step that cares. An empty-build takes no time, whereas a large project with other build systems can have 30-second empty builds.
  • Flexibility. Distributing C++ software is hard. AMBuild provides full tuning of the C++ compiler and offers abstraction and introspection of system properties, to avoid boilerplate often seen with Make or Autoconf. Build scripts are written in Python, offering a great deal of programmatic control.

Keep in mind, AMBuild is neither widely used nor has it been used on a wide variety of systems. AlliedModders has used it successfully for small to medium-sized C++ projects on Linux, Mac, and Windows. We're happy to receive feedback (see the bottom of this page).

Overview