Подъем. Build имеет несколько уникальных концепций, которые представлены в этом разделе. Лучший способ объяснить концепции - это сравнить с более классическими инструментами построения.

При использовании любого вкуса изготовления вы прямо указываете таргеты и команды, которые используются для их создания из другой цели. Нижеприведенный пример создает a.o из a.c с помощью команды вызова составителя с жестким кодом.

a.o: a.c
    g++ -o a.o -g a.c

Это довольно низкоуровневый механизм описания, и трудно корректировать команды, варианты и наборы созданных целей в зависимости от используемого компилятора и операционной системы.

Для улучшения переносимости, большинство современных систем сборки обеспечивают набор функций более высокого уровня, которые могут быть использованы в создании файлов описания. Рассмотрим этот пример:

add_program ("a", "a.c")

Это функция вызова, который создает цели, необходимые для создания исполняемого файла из исходного файла a.c. В зависимости от настроенных свойств могут использоваться разные командные строки. Однако add_program является более высоким уровнем, но довольно тонким. Все цели создаются сразу же, когда описание сборки выполнено, что делает невозможным выполнение многомерных сборок. Часто изменение любого строящегося свойства требует полной реконфигурации строящегося дерева.

Для поддержки настоящих многовариантных сборок, Boost. Строение вводит понятие metatarget—an object that is created when the build description is parsed and can be called later with specific build properties to generate actual targets. [ORIG_END] -->

Рассмотрим пример:

exe a : a.cpp ;

Когда это заявление вычеркнуто, буст. Build создает метацель, но пока не решает, какие файлы должны быть созданы, или какие команды должны использоваться. После того, как все файлы сооружаются, Boost. Build рассматривает свойства, запрошенные на командной строке. Предположительно, вы ссылались на Boost. Строить с:

b2 toolset=gcc toolset=msvc

В этом случае метацель будет называться дважды, один раз с toolset=gcc и один раз с toolset=msvc. Оба вызова будут производить конкретные цели, которые будут иметь различные расширения и использовать различные командные строки.

Another key concept is build property. A build property is a variable that affects the build process. It can be specified on the command line, and is passed when calling a metatarget. While all build tools have a similar mechanism, Boost.Build differs by requiring that all build properties are declared in advance, and providing a large set of properties with portable semantics.

The final concept is property propagation. Boost.Build does not require that every metatarget is called with the same properties. Instead, the "top-level" metatargets are called with the properties specified on the command line. Each metatarget can elect to augment or override some properties (in particular, using the requirements mechanism, see the section called “Requirements”). Then, the dependency metatargets are called with the modified properties and produce concrete targets that are then used in the build process. Of course, dependency metatargets maybe in turn modify build properties and have dependencies of their own.

Для более глубокого лечения требований и концепций вы можете обратиться к SYRCoSE 2009 Boost. Строить статью.

В этом разделе будут описаны основы Boost. Jam language—просто достаточно для написания Jamfiles. Дополнительные сведения см. в разделе Боост. Jam документация.

Boost.Jam имеет интерпретированный, процедурный язык. На самом низком уровне программа Boost.Jam состоит из переменных и правила (термин Джама для функций). Они сгруппированы в модули— есть один глобальный модуль и ряд названных модулей. Кроме того, программа Boost.Jam содержит классы и классные экземпляры.

Синтантически, программа Boost.Jam состоит из двух типов элементов—ключевые слова (которые имеют особое значение для Boost.Jam) и литералов. Рассмотрим этот код:

a = b ;

который присваивает значение b переменной a . Здесь = и ; являются ключевыми словами, в то время как a и b являются литературными.

	Warning
	Все синтаксические элементы, даже ключевые слова, должны быть разделены пробелами. Например, опускание пространственного персонажа до ; приведет к синтаксической ошибке.

Если вы хотите использовать буквальное значение, которое является таким же, как и какое-то ключевое слово, значение может быть процитировано:

a = "=" ;

Все переменные в Boost.Jam имеют один и тот же тип— список строк. Определение переменной присваивает ей значение, как в предыдущем примере. Неопределенная переменная такая же, как переменная с пустым значением. К переменным можно получить доступ с помощью синтаксиса $(измеримой). Например:

a = $(b) $(c) ;

Правила определяются путем указания названия правила, названий параметров и допустимого размера списка значений для каждого параметра.

rule example
 (
     parameter1 :
     parameter2 ? :
     parameter3 + :
     parameter4 *
 )
 {
    # rule body
 }
 

Когда это правило называется, список прошел, как первый аргумент должен иметь ровно одно значение. Список прошел, поскольку второй аргумент может иметь одно значение быть пустым. Два оставшихся аргумента могут быть произвольно длинными, но третий аргумент не может быть пустым.

Обзор Boost.Jam языковые заявления приведен ниже:

helper 1 : 2 : 3 ;
x = [ helper 1 : 2 : 3 ] ;

Этот код называет названное правило указанными аргументами. Когда результат вызова должен быть использован внутри некоторого выражения, вам нужно добавить скобки вокруг звонка, как показано на второй строке.

if cond { statements } [ else { statements } ]

Это обычное заявление. Это условие состоит из:

for var in list { statements }

Исследует заявления для каждого элемента в списке, установив переменную var на значение элемента.

while cond { statements }

Неоднократно выполнять заявления, в то время как конд остается верным при входе.

return values ;

Это утверждение должно использоваться только внутри правила и присваивать значения возвратному значению правила.

	Warning
	Заявление возврат не выходит из правила. Например: rule test ( ) { if 1 = 1 { return "reasonable" ; } return "strange" ; } вернет strange, а не разумный.

import module ;
import module : rule ;

Первая форма импортирует указанный модуль. Все правила этого модуля доступны с использованием квалифицированного названия: модуль.правило. Вторая форма импортирует только указанные правила, и их можно назвать неквалифицированными именами.

Иногда необходимо указать фактические командные строки для использования при создании целей. На языке джема вы используете названные действия для этого. Например:

actions create-file-from-another
{
    create-file-from-another $(<) $(>)
}

Это указывает на названное действие, называемое create-file-from-another. Текст внутри брекетов - это команда для вызова. переменная $(<) будет расширена до списка сгенерированных файлов, а $(>) переменная будет расширена до списка исходных файлов.

Чтобы гибко настроить командную строку, вы можете определить правило с тем же названием, что и действие, и принять три параметра—мишени, источники и свойства. Например:

rule create-file-from-another ( targets * : sources * : properties * )
{
   if <variant>debug in $(properties)
   {
       OPTIONS on $(targets) = --debug ;
   }
}
actions create-file-from-another
{
    create-file-from-another $(OPTIONS) $(<) $(>)
}

В этом примере правило проверяет, указана ли определенная строительная собственность. Если это так, он устанавливает переменную OPTIONS затем используется внутри действия. Обратите внимание, что переменные, установленные «на цели», будут видны только внутри действий, строящих эту цель, а не глобально. Если бы они были установлены во всем мире, использование переменной по имени OPTIONS в двух не связанных действий было бы невозможным.

Более подробную информацию можно найти в ссылке Jam, раздел под названием “Rules”.

На старте, Boost. Создайте поиск и прочитает два файла конфигурации: site-config.jam и user-config.jam. Первый обычно устанавливается и поддерживается системным администратором, а второй - для пользователя. Вы можете отредактировать тот, который находится в директории верхнего уровня вашего Boost. Создайте установку или создайте копию в вашем домашнем каталоге и редактируйте копию. Следующая таблица объясняет, где оба файла находятся в поиске.

	Tip
	Вы можете использовать опцию --настройка ошибки, чтобы найти, какие файлы конфигурации на самом деле загружены.

Обычно user-config.jam просто определяет доступные компиляторы и другие инструменты (см. раздел, называемый “Targets в site-config.jam” для более продвинутого использования). Инструмент настроен с использованием следующего синтаксиса:

using tool-name : ... ;

Правило с использованием дается название инструмента и сделает этот инструмент доступным для Boost. Строить. Например,

using gcc ;

сделает GCC компилятор доступным.

Все поддерживаемые инструменты задокументированы в разделе под названием “Builtin tools”, включая конкретные варианты, которые они принимают. Некоторые общие примечания, которые применяются к большинству компиляторов C++, ниже.

Для всех компиляторных инструментов C++, которые увеличиваются. Build поддерживает out-of-the-box, список параметров для использования одинаков: toolset-name, версия, invok-command и options.

Если у вас есть один компилятор, а компилятор исполняемый

он может быть настроен просто:

using tool-name ;

Если компилятор установлен в пользовательском каталоге, вы должны предоставить команду, которая вызывает компилятор, например:

using gcc : : g++-3.2 ;
using msvc : : "Z:/Programs/Microsoft Visual Studio/vc98/bin/cl" ;

Небольшая потеря. Создание инструментов будет использовать этот путь, чтобы предпринять дополнительные действия, необходимые до обращения к компилятору, такие как вызов сценариев, предлагаемых поставщиками, чтобы настроить свои необходимые переменные среды. Когда компилятор, исполняемый для C и C++, отличается, путь к компилятору C++ должен быть указан. Командой может быть любая команда, разрешенная операционной системой. Например:

using msvc : : echo Compiling && foo/bar/baz/cl ;

будет работать.

Чтобы настроить несколько версий набора инструментов, просто нажмите на правило с использованием несколько раз:

using gcc : 3.3 ;
using gcc : 3.4 : g++-3.4 ;
using gcc : 3.2 : g++-3.2 ;

Обратите внимание, что в первом вызове с использованием будет использоваться компилятор, найденный в PATH, и нет необходимости четко указывать команду.

Многие инструменты имеют параметр options для настройки конфигурации. Все, что нужно. Стандартные компиляторные инструменты Build принимают четыре варианта cflags, cxxflags, compileflags и linkflags как options, указывая флаги, которые всегда будут передаваться соответствующим инструментам. Значения cflags передаются непосредственно компилятору C, значения cxxflags функция передается непосредственно компилятору C++, и значения функции compileflags передаются обоим. Например, чтобы настроить набор инструментов gcc, чтобы он всегда генерировал 64-битный код, который вы могли бы написать:

        using gcc : 3.4 : : <compileflags>-m64 <linkflags>-m64 ;

	Warning
	Хотя синтаксис, используемый для указания вариантов набора инструментов, очень похож на синтаксис, используемый для указания требований в Jamfiles, варианты набора инструментов не такие, как функции. Не пытайтесь указать значение функции в инициализации инструментария.

Чтобы вызвать Boost.Build, введите b2 на командной строке. Принимаются три вида токенов командной строки в любом порядке:

b2

b2 lib1 subproject//lib2

b2 toolset=gcc variant=debug optimization=space

b2 link=static link=shared threading=single threading=multi

b2 link=static,shared threading=single,multi

b2 include=static,shared

A Main target - это определяемое пользователем юридическое лицо, которое может быть построено, например, исполняемый файл. Определение основной цели обычно выполняется с использованием одного из основных правил, описанных в разделе под названием “Буилтин правила”. Пользователь также может объявить пользовательские основные целевые правила, как показано в разделе под названием “ Основные целевые правила”.

rule rule-name (
     main-target-name :
     sources + :
     requirements * :
     default-build * :
     usage-requirements * )

obj test.release : test.cpp : <variant>release ;
obj test.debug : test.cpp : <variant>debug ;

exe a : a.cpp ;           # a.cpp is the only source file
exe b : [ glob *.cpp ] ;  # all .cpp files in this directory are sources

lib helper : helper.cpp ;
exe a : a.cpp helper ;
# Since all project ids start with slash, ".." is a directory name.
exe b : b.cpp ..//utils ;
exe c : c.cpp /boost/program_options//program_options ;

exe hello : hello.cpp : <include>/opt/boost <define>MY_DEBUG ;

lib util : util.cpp : <link>static ;
obj main : main.cpp : <optimization>off ;

lib network : network.cpp
    : <link>shared:<define>NETWORK_LIB_SHARED
     <variant>release:<define>EXTRA_FAST
    ;

lib network : network.cpp
    : <toolset>gcc,<optimization>speed:<define>USE_INLINE_ASSEMBLER
    ;

lib network : network.cpp
    : <conditional>@my-rule
    ;
rule my-rule ( properties * )
{
    local result ;
    if <toolset>gcc <optimization>speed in $(properties)
    {
        result += <define>USE_INLINE_ASSEMBLER ;
    }
    return $(result) ;
}

exe main : main.cpp : -<define>UNNECESSARY_DEFINE ;

project test : requirements <threading>multi ;
exe test1 : test1.cpp ;
exe test2 : test2.cpp : <threading>single ;
exe test3 : test3.cpp : -<threading>multi ;

exe hello : hello.cpp : : <threading>multi ;

lib demangler : dummy_demangler.cpp ;                # alternative 1
lib demangler : demangler_gcc.cpp : <toolset>gcc ;   # alternative 2
lib demangler : demangler_msvc.cpp : <toolset>msvc ; # alternative 3

exe hello : hello.cpp
    [ obj helpers : helpers.cpp : <optimization>off ] ;

explicit install_programs ;

Как упоминалось ранее, цели сгруппированы в проекты, и каждый Jamfile - это отдельный проект. Проекты полезны, потому что они позволяют нам группировать связанные с ними цели вместе, определять свойства, общие для всех этих целей, и присваивать символическое название проекту, которое может быть использовано для обозначения его целей.

Проекты называются с использованием правила проект, которое имеет следующий синтаксис:

project id : attributes ;

Вот. атрибуты - это последовательность аргументов правил, каждый из которых начинается с атрибута-имя и сопровождается любым количеством свойств сборки. Список названий атрибутов наряду с их обработкой также показан в таблице ниже. Например, можно написать:

project tennis
    : requirements <threading>multi
    : default-build release
    ;

Возможные атрибуты перечислены ниже.

Проект idProject id is a short way to denote a project, as opposed to the Jamfile's pathname. It is a hierarchical path, unrelated to filesystem, such as "boost/thread". Target references make use of project ids to specify a target.[ORIG_END] -->

Местоположение источника указывает каталог, где источники для проекта находятся.Местоположение источника specifies the directory where sources for the project are located.[ORIG_END] -->

Требования к проекту - это требования, которые применяются ко всем целям в проектах, а также ко всем подпроектам.

По умолчанию - это запрос сборки, который должен быть используется, когда нет запроса на сборку четко указано.По умолчанию is the build request that should be used when no build request is specified explicitly.[ORIG_END] -->

Значение по умолчанию для этих атрибутов приведено в таблице ниже.

Помимо определения проектов и основных целей, Jamfiles часто ссылаются на различные правила полезности. Полный список правил, которые могут быть непосредственно использованы в Jamfile, см. раздел под названием “Буилтин правила”.

Каждый подпроект наследует атрибуты, константы и правила от своего родительского проекта, который определяется ближайшим Jamfile в каталоге предков над подпроектом. Проект верхнего уровня объявлен в файле Jamroot, а не Jamfile. При загрузке проекта, Boost. Build ищет Jamroot или Jamfile. Они обрабатываются одинаково, за исключением того, что если файл называется Jamroot, поиск родительского проекта не выполняется.

Даже при построении в каталоге подпроектов, родительские файлы проектов всегда загружаются перед файлами их подпроектов, так что каждое определение, сделанное в родительском проекте, всегда доступно для его детей. Порядок загрузки любых других проектов не указан. Даже если один проект относится к другому через use-project или целевую ссылку, не следует принимать какой-либо конкретный порядок.

	Note
	Предоставление корневому проекту специального названия “Jamroot” гарантирует, что он будет расти. Build не будет неверно истолковывать каталог выше него как корень проекта только потому, что каталог содержит Jamfile.

Когда вы описали свои цели, вы хотите увеличить. Создайте, чтобы запустить правильные инструменты и создать необходимые цели. В этом разделе будут описаны две вещи: как вы указываете, что строить, и как основные цели фактически построены.

Самое главное, что нужно отметить, это в Boost. Создайте, в отличие от других инструментов построения, цели, которые вы объявляете, не соответствуют конкретным файлам. То, что вы заявляете в Jamfile, больше похоже на “metatarget.” В зависимости от свойств, которые вы указываете на командной строке, каждый метацель будет производить набор реальных целей, соответствующих запрашиваемым свойствам. Вполне возможно, что один и тот же метацель построен несколько раз с различными свойствами, производя разные файлы.

	Tip
	Это означает, что для Boost. Строить, вы не можете напрямую получить вариант сборки из Jamfile. Может быть несколько вариантов, запрашиваемых пользователем, и каждая цель может быть построена с различными свойствами.

b2 app1 lib1//lib1 toolset=gcc variant=debug optimization=full

b2 app1 lib1//lib1 gcc debug optimization=full

explicit hello_test ;