Getting Started
-
BDE's build system from BDE Tools repository, which has been set up following the instructions from bde-tools documentation.
-
A supported C++ toolchain, including compiler, preprocessor, linker
The BDE library itself builds fairly quickly and does not consume a significant amount of resources (CPU time or memory), but the BDE unit test drivers are substantially larger. It is not unusual for an optimized build of one of the BDE container test drivers to have a working set of more than 1GB of RAM. If a parallel build is invoked, it is quite possible for the build process to consume 4GB (or more) of RAM at its peak.
BDE uses a build system based on CMake. Building software with CMake works in two steps: First you configure the source code, and then you build it.
The CMake based build system is located in the BDE Tools repository, which must be set up before the build system can be used:
- Make sure that python 3.5 - 3.10 are installed on the system.
- Download BDE Tools and add the
path
<bde_tools_repo_root>/binto the systemPATHenvironment variable.
Once the BDE build system has been set up. The following commands can be used to configure and build the BDE repository:
-
From the root of this source repository, run:
eval `bbs_build_env -u dbg_64_cpp17` bbs_build configure
-
To build the libraries, but not the test drivers, run:
bbs_build build
To also build the test drivers, run:
bbs_build build --test build
To build and run the test drivers, run:
bbs_build build --test run
For detailed descriptions of commands and build options available for the BDE build system, please see the relevant wiki page from the bde-tools repository: CMake Build System
See the issue tracker and the Known Issues page for documentation of any known issues building, testing or using BDE on its supported platforms.
If you have questions, comments, suggestions for improvement or any other inquiries regarding BDE or this wiki, feel free to open an issue in the issue tracker.
