С++ Builder: как ускорить компиляцию с помощью предкомпилированных заголовков

Вместо вступления сразу приведу пример. Полная сборка (build) проекта, содержащего около 170 cpp-модулей, при использовании предкомпилированных заголовков происходит за 811 секунд, при этом число обработанных компилятором строк составляет 1,808,780. При компиляции того же проекта без использования предкомпилированных заголовков, время сборки составляет 2399 секунд, а число строк, обработанных компилятором - 45,261,820. Впечатляет, не так ли? Плата за это ускорение, в принципе не велика - предкомпилированный образ, размер которого около 40 Мб.

При компиляции исходных текстов, компилятор должен обработать все *.cpp файлы проекта и все включенные в них *.h - файлы. При этом обрабатываются как пользовательские заголовочные файлы, так и стандартные, такие как vcl.h или Word2k.h. Количество кода, находящегося в стандартных заголовках может быть очень большим, например размер файла Word2k.h превышает 5 Мб, в нем больше 130 000 строк кода.

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

Принцип действия предкомпилированных заголовков
Для управления предкомпилированными предназначена директива компилятора #pragma hdrstop. Все заголовочные файлы, включенные до этой директивы, помещаются в один образ, например:
 

#include <vcl.h>


#include <string>


#pragma hdrstop

- состав включенный файлов до директивы hdrstop должен быть тем же
- последовательность включения файлов до директивы hdrstop должна быть той же
 

- ВСЕ cpp-файлы проекта имели одинаковый блок включений до директивы hdrstop
- в этот блок должны входить ВСЕ стандартные заголовочные файлы, необходимые для проекта
 

#include <pch.h>


#pragma hdrstop

#ifndef PCH_H


#define PCH_H





#define INC_VCLDB_HEADERS


#define INC_VCLEXT_HEADERS


#include <vcl.h>





#include <sysset.h>


#include <IniFiles.hpp>


#include <AppEvnts.hpp>


#include <ActnMan.hpp>


...


#endif

static const Extended NaN = 0.0 / 0.0;


static const Extended Infinity = 1.0 / 0.0;

#include <vcl.h>   


#pragma hdrstop   





#include "Unit1.h"


....

#include "pch.h"


#pragma hdrstop

#include "pch.h" // включает  vcl.h, string и т.д.


#pragma hdrstop





#include <vcl.h>


#include <string>


...

- визуальное наблюдение за процессом компиляции. Обычно, число строк компилируемых в одном файле не должно превышать 10000-15000 строк
- если для проекта выбран индивидуальный файл для хранения образа предкомпилированных заголовков и этот файл называется pch.csm, то нужно обратить внимание на наличие вспомогательных файлов с именами pch.#00, pch.#01 и т.д. Если для всех файлов проекта используется один и тот же предкомпилированный образ, то вспомогательный файл должен быть только один - pch.#00. Если таких файлов больше, это значит что для каких-то cpp-модулей создаются дополнительные образы.
 

#ifndef PCH_H


#define PCH_H





#define INC_VCLDB_HEADERS


#define INC_VCLEXT_HEADERS


#include <vcl.h>


/* Все, что подключается предыдущими 3-мя строчками


	// Core (minimal) Delphi RTL headers


	#include <System.hpp>


	#include <Types.hpp>


	#include <Windows.hpp>


	#include <Messages.hpp>


	#include <SysUtils.hpp>


	#include <Classes.hpp>





	// Core (minimal) VCL headers


	#if defined(INC_VCL)


	#include <Controls.hpp>


	#include <Graphics.hpp>


	#include <Forms.hpp>


	#include <Dialogs.hpp>


	#include <StdCtrls.hpp>


	#include <ExtCtrls.hpp>





	// VCL Database related headers


	#if defined(INC_VCLDB_HEADERS)


	#include <DBCtrls.hpp>


	#include <DB.hpp>


	#include <DBTables.hpp>


	#endif  //  INC_VCLDB_HEADERS





	// Full set of VCL headers


	#if defined(INC_VCLEXT_HEADERS)


	#include <Buttons.hpp>


	#include <ChartFX.hpp>


	#include <ComCtrls.hpp>


	#include <DBCGrids.hpp>


	#include <DBGrids.hpp>


	#include <DBLookup.hpp>


	#include <DdeMan.hpp>


	#include <FileCtrl.hpp>


	#include <GraphSvr.hpp>


	#include <Grids.hpp>


	#include <MPlayer.hpp>


	#include <Mask.hpp>


	#include <Menus.hpp>


	#include <OleCtnrs.hpp>


	#include <OleCtrls.hpp>


	#include <Outline.hpp>


	#include <Tabnotbk.hpp>


	#include <Tabs.hpp>


	#include <VCFImprs.hpp>


	#include <VCFrmla1.hpp>


	#include <VCSpell3.hpp>


	#endif  // INC_VCLEXT_HEADERS





	#endif  //  INC_VCL


*/





#include <sysset.h>


#include <IniFiles.hpp>


#include <AppEvnts.hpp>


#include <ActnMan.hpp>


#include <ActnCtrls.hpp>


#include <BandActn.hpp>


#include <CustomizeDlg.hpp>


#include <ImgList.hpp>


#include <ToolWin.hpp>


#include <ExtDlgs.hpp>


#include <ActnList.hpp>





#include <IBDatabase.hpp>


#include <IBCustomDataSet.hpp>


#include <IBQuery.hpp>


#include <IBTable.hpp>


#include <IBSQL.hpp>


#include <IBServices.hpp>





#include <math.h>


#include <assert.h>


#include <complex.h>


#include <values.h>





#include <map>


#include <list>


#include <set>


#include <vector>


#include <algorithm>


#include <functional>


#include <string>


#include <memory>


#include <fstream>





//нестандартные компоненты RxLib и EhLib


#include "CURREDIT.hpp"


#include "RXSpin.hpp"


#include "RxCalc.hpp"


#include "RxCombos.hpp"


#include "APPUTILS.hpp"


#include "RXDBCtrl.hpp"


#include "Placemnt.hpp"


#include "DBGridEh.hpp"

#endif

Автор: Серебров Борис
Источник: www.people.overclockers.ru

16.02.2006