mirror of
https://git.dev.opencascade.org/repos/occt.git
synced 2025-04-04 18:06:22 +03:00
ba06f8bbee
Command gendoc improved to: - generate Reference Manual documentation (OCCT classes reference) with option -refman; option -overview can be used for generation of overview documentation; - generate PDF documents for all User Guides automatically (for files listed in FILES_PDF.txt); - check availability of third-party tools (Doxygen, Inkscape etc.) and properly report warnings and errors. - use templates of configuration files for third-party tools instead of their generation. These template files are located in dox/resources folder Tcl scripts are moved from dox folder to adm. Doxygen warnings are eliminated. Moved all auxilary functions to occaux.tcl. Fixed Reference manual generation on *nix platform. Fixed PDF generation on *nix platforms.
72 lines
2.6 KiB
Markdown
72 lines
2.6 KiB
Markdown
Building with Xcode {#occt_dev_guides__building_xcode}
|
|
===================
|
|
|
|
This file describes steps to build OCCT libraries from complete source package
|
|
on Mac OS X with Xcode.
|
|
|
|
If you are building 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 \ref occt_dev_guides__building_wok for instructions.
|
|
|
|
Before building OCCT, you need to install required third-party libraries; see
|
|
paragraph 1 of \ref occt_dev_guides__building 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 the 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 script
|
|
|
|
./draw_cbp.sh xcd [d]
|
|
|
|
Option "d" is used if OCCT has been built in Debug mode.
|