Chapter 46. Boost.Jam : 3.1.19 . Boost , The Boost C++ Libraries BoostBook Documentation Subset , Part II. Boost Tools

Chapter 46. Boost.Jam : 3.1.19

Rene Rivera

David Abrahams

Vladimir Prus

Распространяется под лицензией Boost Software License, версия 1.0. (См. сопроводительный файл LICENSE_1_0.txt или копию по адресуhttp://www.boost.org/LICENSE_1_0.txt)

Таблица содержания

Building B2

Language

Lexical Features
Targets
Rules
Flow-of-Control
Variables
Modules

Miscellaneous

Diagnostics
Bugs, Limitations
Fundamentals

History

Building B2

Установка<B2>после создания — это просто копирование сгенерированных исполняемых файлов где-то в вашем доме.<PATH>. Для создания исполняемых файлов существует набор<build>скриптов бутстрапа для размещения определенных сред. Сценарии принимают один дополнительный аргумент, название набора инструментов для создания. Когда набору инструментов не дается попытка обнаружить доступный набор инструментов и использовать его. Сценарии сборки принимают эти аргументы:

build [toolset]

Запуск сценариев без аргументов даст вам наилучшие шансы на успех. На платформах Windows из командной консоли делают:

cd jam source location
.\build.bat

На платформах типа Unix:

cd jam source location
sh ./build.sh

Для Роста. Источник джема, включенный в распределение Boostджем-источник<BOOST_ROOT/tools/build/src/engine>.

Если скрипты не могут обнаружить соответствующий набор инструментов для сборки с вашим конкретным набором инструментов, он может не быть автоматически обнаруживаемым. В этом случае вы можете указать набор инструментов в качестве первого аргумента, это предполагает, что набор инструментов легко доступен в<PATH>.

	Note
	Инструментарий, используемый для создания Boost. Jam не зависит от инструментов, используемых для Boost. Построй. Только одна версия Boost. Джам нужен, чтобы использовать Boost. Построй.

Поддерживаемые наборы инструментов и независимо от того, обнаружены ли они автоматически, являются:

Table 46.1. Supported Toolsets

сценарий

Платформа

инструментарий

Обнаружение и заметки

build.bat

Windows NT, 2000, and XP

borland

BorlandC++Builder (BCC 5.5)

Место установки: "C:\Borland\BCC55
BCC32.EXEвPATH

como

Comeau Computing на C/C++

gcc

GNU GCC

gcc-nocygwin

GNU GCC

intel-win32

Компилятор Intel C++ для Windows

ICL.EXEвPATH

metrowerks

MetroWerks CodeWarrior C/C++ 7.x, 8.x, 9.x

CWFolderпеременная конфигурация
MWCC.EXEвPATH

mingw

GNUGCCкак конфигурацияMinGW

Место установки: "C:\MinGW

msvc

Microsoft Visual C++ 6.x

VCVARS32.BATуже установленный
%MSVCDir%присутствует в окружающей среде.
Общие места установки: "%ProgramFiles%\Microsoft Visual Studio", "%ProgramFiles%\Microsoft Visual C++"
CL.EXEвPATH

vc7

Microsoft Visual C++ 7.x

VCVARS32.BATилиVSVARS32.BATуже сконфигурированы
%VS71COMNTOOLS%присутствует в окружающей среде.
%VCINSTALLDIR%присутствует в окружающей среде.
Общие места установки: "%ProgramFiles%\Microsoft Visual Studio .NET", "%ProgramFiles%\Microsoft Visual Studio .NET 2003"
CL.EXEвPATH

vc8 and vc9

Microsoft Visual C++ 8.x и 9.x

Detection:

VCVARSALL.BATуже установленный
%VS90COMNTOOLS%присутствует в окружающей среде.
Место установки: "%ProgramFiles%\Microsoft Visual Studio 9
%VS80COMNTOOLS%присутствует в окружающей среде.
Место установки: "%ProgramFiles%\Microsoft Visual Studio 8
CL.EXEвPATH

Notes:

ЕслиVCVARSALL.BATпризван настроить набор инструментов, то он пропускает все дополнительные аргументы, см. ниже для чего эти аргументы. Это может быть использовано для создания, например, версии Win64b2. Проконсультируйтесь с документацией VisualStudio о возможных значениях аргументовVCVARSALL.BAT.

build.sh

Unix, Linux, Cygwin, etc.

acc

HP-UX ACC

aCCвPATH
uname— «HP-UX»

como

Comeau Computing на C/C++

Комо вPATH

gcc

GNU GCC

GCC вPATH

intel-linux

Intel C++ для Linux

iccвPATH
Общие места установки: "/opt/intel/cc/9.0", "/opt/intel_cc_80", "/opt/intel/compiler70", "/opt/intel/compiler60", "/opt/intel/compiler50".

kcc

Intel KAI C++

KCCвPATH

kylix

БорландC++Builder

bc++ в PATH

mipspro

SGI MIPSpro C

uname— «IRIX» или «IRIX64».

sunpro

Семинар Sun 6 C++

Стандартное место установки: "/opt/SUNWspro

<qcc>

Нейтрино QNX

unameявляетсяQNXиqccвPATH.

true64cxx

Компилятор Compaq C++ для True64 UNIX

uname— «OSF1».

vacpp

IBM Visual Visual Возраст C++

xlcвPATH

MacOS X

darwin

Apple MacOS X GCC

uname— «Darwin».

Windows NT, 2000, and XP

mingw

GNUGCCкак конфигурацияMinGWс оболочкой MSYS

Место установки: "/mingw

Созданные исполняемые файлы размещаются в подкаталоге, специально предназначенном для вашей платформы. Например, в Linux, работающем на чипе, совместимом с Intel x86, исполняемые файлы помещаются в:<bin.linuxx86>. Исполняемый =b2[.exe]= может быть использован для вызова Boost. Построй.

Скрипты сборки поддерживают дополнительные аргументы вызова для использования разработчиками Boost. Jam и для дополнительной настройки набора инструментов. Дополнительные аргументы приходят после набора инструментов:

Аргументы не в виде опции, а перед аргументами опции, используются для дополнительной настройки скриптов конфигурации набора инструментов.
Аргументы формы «<--option>», которые передаются на<build.jam>стройпись.
Аргументы не в виде опции, а после опций, которые являются мишенями для сценария<build.jam>.

build [toolset] [setup*] [--option+ target*]

Аргументы сразу после набора инструментов передаются непосредственно в скрипт настройки набора инструментов, если он доступен и если его необходимо вызвать. Это позволяет настроить набор инструментов, необходимый для выполнения сборок без по умолчанию<b2>. Например, для создания версии Win64<vc8>. Смотрите описание набора инструментов выше, когда конкретные наборы инструментов поддерживают это.

Аргументы, начинающиеся с формы<--option>, передаются в сценарий<build.jam>и используются для дальнейшей настройки того, что создается. Варианты и цели, поддерживаемые сценарием<build.jam>:

<--->: Пустой вариант, когда нужно только указать цель.
<--release>: По умолчанию строит оптимизированный исполняемый файл.
<--debug>: Создает отладочные версии исполняемого файла. При построении они размещаются в собственном каталоге<bin./platform/.debug>.
<--grammar>: Обычно файлы анализа грамматики языка Jam не регенерируются. Это заставляет строить грамматику, хотя это не может заставить регенерацию грамматического парсера. Если парсер устарел, он будет восстановлен и впоследствии построен.
<--with-python=path>: Включает интеграцию с Python, учитывая путь к библиотекам Python.
<--gc>: Позволяет использовать сборщик мусора Boehm. Сборка будет искать источник Boehm-GC в подкаталоге «boehm_gc» из<b2>источников.
<--duma>: Позволяет использовать отладчик памяти DUMA (Detect Uintended Memory Access). В сборке предполагается найти исходные файлы DUMA в подкаталоге «duma» из<b2>источников.
<--toolset-root=path>: Указывает, где находится набор инструментов, используемый для сборки. Этот вариант передается в бутстрап (<build.bat>или<build.sh>).
<--show-locate-target>: Для информации распечатывает, куда поставит построенный исполняемый файл.
<--noassert>: Отключить отладочные утверждения, даже если построена отладочная версия исполняемого файла.
<dist>: Создавайте пакеты (сжатые архивы), подходящие для распространения на платформе.
<clean>: Удалите все построенные исполняемые файлы и объекты.

Статья Chapter 46. Boost.Jam : 3.1.19 раздела The Boost C++ Libraries BoostBook Documentation Subset Part II. Boost Tools может быть полезна для разработчиков на c++ и boost.