PythonOCC-Core 7.8.1.1 跨平台构建完全指南-优快云博客

PythonOCC-Core 7.8.1.1 跨平台构建完全指南

【免费下载链接】pythonocc-core tpaviot/pythonocc-core: 是一个基于 Python 的 OpenCASCADE (OCCT) 几何内核库，提供了三维几何形状的创建、分析和渲染等功能。适合对 3D 建模、CAD、CAE 以及 Python 有兴趣的开发者。项目地址: https://gitcode.com/gh_mirrors/py/pythonocc-core

前言

PythonOCC-Core 是基于 OpenCASCADE 技术的 Python 封装，为 CAD/CAM/CAE 领域开发者提供了强大的三维建模能力。本文将详细介绍如何在 Linux 和 Windows 系统上构建 PythonOCC-Core 7.8.1.1 版本，帮助开发者搭建完整的开发环境。

一、Linux 系统构建指南

1.1 系统要求与准备

在开始构建前，请确保您的 Linux 系统满足以下要求：

操作系统：推荐使用 Ubuntu 22.04 LTS
硬件要求：
- 至少 8GB 可用磁盘空间
- 4GB 以上内存
软件依赖：
- Python ≥ 3.9
- OpenCASCADE 7.8.1.1
- SWIG 4.2.1
- CMake ≥ 3.1

1.2 详细构建步骤

1.2.1 安装系统依赖

首先更新系统并安装基础开发工具：

sudo apt-get update
sudo apt-get install -y \
    wget \
    libglu1-mesa-dev \
    libgl1-mesa-dev \
    libxmu-dev \
    libxi-dev \
    build-essential \
    cmake \
    libfreetype6-dev \
    tk-dev \
    python3-dev \
    rapidjson-dev \
    python3 \
    git \
    python3-pip \
    libpcre2-dev

1.2.2 编译 SWIG 4.2.1

由于 Ubuntu 默认仓库中的 SWIG 版本可能不符合要求，我们需要从源码编译：

wget http://prdownloads.sourceforge.net/swig/swig-4.2.1.tar.gz
tar -zxvf swig-4.2.1.tar.gz
cd swig-4.2.1
./configure
make -j$(nproc)
sudo make install

1.2.3 构建 OpenCASCADE

OpenCASCADE 是 PythonOCC 的核心依赖，必须正确构建：

wget https://github.com/Open-Cascade-SAS/OCCT/archive/refs/tags/V7_8_1.tar.gz
tar -xvzf V7_8_1.tar.gz
cd OCCT-7.8.1.1
mkdir cmake-build
cd cmake-build

cmake -DINSTALL_DIR=/opt/occt781 \
      -DBUILD_RELEASE_DISABLE_EXCEPTIONS=OFF \
      ..

make -j$(nproc)
sudo make install

配置系统库路径：

sudo bash -c 'echo "/opt/occt781/lib" >> /etc/ld.so.conf.d/occt.conf'
sudo ldconfig

1.2.4 构建 PythonOCC-Core

git clone https://github.com/tpaviot/pythonocc-core.git
cd pythonocc-core
mkdir cmake-build && cd cmake-build

PYTHONOCC_INSTALL_DIRECTORY=${PYTHONOCC_INSTALL_DIRECTORY:-/usr/local}

cmake \
    -DOCCT_INCLUDE_DIR=/opt/occt781/include/opencascade \
    -DOCCT_LIBRARY_DIR=/opt/occt781/lib \
    -DCMAKE_BUILD_TYPE=Release \
    -DPYTHONOCC_INSTALL_DIRECTORY=$PYTHONOCC_INSTALL_DIRECTORY \
    ..

make -j$(nproc) && sudo make install

配置环境变量：

echo 'export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/opt/occt781/lib' >> ~/.bashrc
source ~/.bashrc

二、Windows 系统构建指南

2.1 系统要求与准备

操作系统：Windows 10/11 64位
硬件要求：
- 至少 10GB 可用磁盘空间
- 8GB 以上内存
开发工具：
- Visual Studio 2019/2022 (社区版)
- Python ≥ 3.9
- CMake ≥ 3.1
- Git
- SWIG 4.2.1

2.2 详细构建步骤

2.2.1 安装必要软件

Visual Studio：安装时选择"使用C++的桌面开发"工作负载
Python：安装时勾选"添加到PATH"选项
CMake：安装最新版本并添加到系统PATH
SWIG：解压到C:\swigwin并添加到PATH

2.2.2 安装 OpenCASCADE

下载 OpenCASCADE 7.8.1.1 Windows 版本
解压到指定目录，如C:\OpenCASCADE-7.8.1.1-vc10-64

2.2.3 构建 PythonOCC-Core

git clone https://github.com/tpaviot/pythonocc-core.git
cd pythonocc-core
mkdir cmake-build
cd cmake-build

cmake -G "Visual Studio 16 2019" -A x64 ^
    -DCMAKE_BUILD_TYPE=Release ^
    -DOCCT_INCLUDE_DIR=C:\OpenCASCADE-7.8.1.1-vc10-64\occt-7.8.1.1\inc ^
    -DOCCT_LIBRARY_DIR=C:\OpenCASCADE-7.8.1.1-vc10-64\occt-7.8.1.1\win64\vc14\lib ^
    -DOCCT_ESSENTIALS_ROOT=C:\OpenCASCADE-7.8.1.1-vc10-64
    ..

cmake --build . --config Release
cmake --install .

三、可选功能与测试

3.1 增强功能配置

NumPy 支持

启用 NumPy 支持可加速 STL 文件处理：

pip install numpy

然后在 CMake 配置中添加：

-DPYTHONOCC_MESHDS_NUMPY=ON

安装额外依赖

pip install svgwrite numpy numpy-stl matplotlib PyQt5

3.2 测试安装

简单测试：

from OCC.Core.gp import gp_Pnt
p = gp_Pnt(1., 2., 3.)
print(p.X())  # 应输出1.0

完整测试套件：

pip install pytest
pytest

四、常见问题解决

Linux 系统问题

库文件找不到：
```
sudo ldconfig
```
SWIG 版本冲突：
- 检查已安装版本：swig -version
- 移除冲突版本

Windows 系统问题

DLL 文件缺失：
- 确保 OpenCASCADE 的 bin 目录已添加到 PATH
- 设置环境变量：
```
setx OCCT_ESSENTIALS_ROOT "%CASROOT%\win64\vc14\bin"
```
CMake 配置错误：
- 检查路径是否使用反斜杠
- 确认 Visual Studio 安装完整

五、总结

本文详细介绍了 PythonOCC-Core 7.8.1.1 在 Linux 和 Windows 系统上的完整构建流程。通过遵循这些步骤，开发者可以成功搭建 PythonOCC 开发环境，为后续的三维建模应用开发奠定基础。建议初次构建时严格按照指南操作，遇到问题时参考常见问题解决部分。

创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考