Building with Xcode

This file describes steps to build OCCT libraries from a complete source package on Mac OS X with Xcode.

If you build OCCT from bare sources (as in Git repository) or do some changes affecting CDL files, you need to use WOK to re-generate header files and build scripts / projects. See Using WOK for instructions.

Before building OCCT, you need to install the required third-party libraries; see paragraph 1 of Building OCCT from sources for details.

1. Add paths to the mandatory 3rd-party products (Tcl/Tk and FreeType) in file custom.sh located in <OCCT_ROOT_DIR> . For this:

   1.1. Add paths to the includes in variable CSF_OPT_INC;

   1.2. Add paths to the binary libraries in variable CSF_OPT_LIB64;

   All paths should be separated by ":" symbol.

2. Add paths to the optional 3rd-party libraries (TBB, gl2ps and FreeImage) in the aforementioned environment variables CSF_OPT_INC and CSF_OPT_LIB64 from file custom.sh.

   If you want to build OCCT without the optional libraries perform the following steps:

   2.1 Disable unnecessary library in custom.sh by setting the corresponding variable HAVE_<LIBRARY_NAME> to false.

   export HAVE_GL2PS=false

   2.2 Remove this library from Project navigator in Xcode for each project that uses it: choose the required project, right click on the unnecessary library and select Delete button.

3. Open Terminal application.
4. Enter <OCCT_ROOT_DIR>:

   cd \<OCCT_ROOT_DIR\>

5. To start Xcode, run command /xcode.sh

6. To build a certain toolkit, select it in Scheme drop-down list in Xcode toolbar, press Product in the menu and click Build button.

   To build the entire OCCT, create a new empty project (select File -> New -> Project -> "Empty project in the menu. Input the project name, e.g. OCCT, click Next and Create buttons). Drag and drop the OCCT folder in the created OCCT project in the Project navigator. Select File -> New -> Target -> Aggregate in the menu. Enter the project name (e.g. OCCT) and click Finish. The Build Phases tab will open. Click "+" button to add the necessary toolkits to the target project. It is possible to select all toolkits by pressing Command+A combination.

To start DRAWEXE, which has been built with Xcode on Mac OS X, perform the following steps:

1.Open Terminal application

2.Enter <OCCT_ROOT_DIR>:

cd \<OCCT_ROOT_DIR\>

3.Run the script

./draw_cbp.sh xcd [d]

Option d is used if OCCT has been built in Debug mode.