mirror of https://git.dev.opencascade.org/repos/occt.git synced 2025-04-01 17:36:21 +03:00

abv 72c3745808 0027193: Describe building OCCT with genproj tool

Description of building OCCT with WOK and automake scripts is removed from documentation.
Use of genproj utility is described in pages on building with MSVC, Code::Blocks, and XCode projects.

New script genconf allows starting configuration GUI explicitly; dialog is slightly revised.
Script genproj.sh is renamed to genproj; permissions for scripts are corrected for Linux.

Script env.bat does not set anymore environment required for Products.

2016-03-04 14:44:22 +03:00

3.1 KiB

Raw Blame History

Building with Xcode

@tableofcontents

@section build_xcode_intro General

This file describes steps to build OCCT libraries from sources on Mac OS X with Xcode projects, generated by OCCT legacy tool genproj.

@section build_xcode_3rdparty Third-party libraries

Before building OCCT, make sure to have all the needed third-party libraries installed. On OS X we recommend to use native libraries. You can also build third-party libraries from their sources, see @ref occt_dev_guides__building_3rdparty_osx for instructions.

@section build_xcode_conf Configuration

Before building it is necessary to set up build environment.

The environment is defined in the file custom.sh which can be edited directly:

Add paths to includes of used third-party libraries in variable CSF_OPT_INC (use colon ":" as path separator).
Add paths to their binary libraries in variable CSF_OPT_LIB64.
Set variable SHORTCUT_HEADERS to "true" to have folder inc populated by short-cut files pointing to actual headers located in src; otherwise, header files will be copied to inc.
For optional third-party libraries, set corresponding environment variable HAVE_<LIBRARY_NAME> to either false, e.g.:

       export HAVE_GL2PS=false

Alternatively, or when custom.sh does not exist, you can launch genconf.sh to configure environment interactively:

@figure{/dev_guides/building/3rdparty/images/genconf_osx.png}

Click "Save" to store the specified configuration in custom.sh file.

@section build_xcode_gen Projects generation

Launch genproj tool to update content of inc folder and generate project files after changes in OCCT code affecting layout or composition of source files.

@note To use genproj and genconf tools you need to have Tcl installed and accessible by PATH.

For instance, in Terminal application:

  $ cd /dev/OCCT/opencascade-7.0.0
  $ ./genproj.sh

@section build_xcode_build Building

To start Xcode, launch script xcode.sh.

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; then click Next and Create).
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.

@section build_xcode_draw Launching DRAW

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.

3.1 KiB Raw Blame History

Building with Xcode

3.1 KiB

Raw Blame History