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

abv 944d808cd0 0027237: genproj file does not take into account any arguments

Arguments of genproj tool are revised:
* -path option eliminated (current directory is always used);
* IDE should be always indicated by first argument (instead of -target=<ide> option);
* second argument can be used to specify non-default platform (wnt, mac, lin, ios, qnx);
* option -h, -help, --help can be used to get help
* option -static can be used to build static libs with XCode

README.txt and docs on building are updated.
codeblocks.bat is corrected to be able to detect 32-bit installation of Code::Blocks on 64-bit Windows.
Remains of support of OpenCL (obsolete) are commented out in genconf.tcl
genproj.tcl will not copy env.bat if it already exists.

2016-03-15 12:23:35 +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

@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