跳到主要内容

安装

CadFlow 当前以源码构建的 Python 包形式提供。先安装匹配的 OpenCascade 运行时，CMake 才能在构建包时发现 OCCT 7.9.3 的头文件和共享库。

环境要求​

完整构建目前测试了以下环境：

  • Linux x86-64
  • Python 3.10 至 3.13
  • CMake 3.16 或更高版本
  • 支持 C++17 的编译器
  • Python 开发头文件
  • 由 cadquery-ocp==7.9.3.1 提供的 OpenCascade 7.9.3
平台范围

当前 CMake 发现逻辑针对 Linux .so 库。Windows 和 macOS 仍需平台特定的发现支持，尚未进入完整构建的测试矩阵。

安装系统工具​

Ubuntu 或 Debian：

sudo apt update
sudo apt install build-essential cmake python3-dev

确认 Python 版本处于支持范围：

python3 --version
cmake --version

在虚拟环境中构建​

git clone https://github.com/yhz5613813/CadFlow.git
cd CadFlow

python3 -m venv .venv
source .venv/bin/activate

python -m pip install --upgrade pip setuptools wheel
python -m pip install "cadquery-ocp==7.9.3.1"
python -m pip install --no-build-isolation .

先安装 cadquery-ocp，可以让匹配的 OCCT 文件出现在当前环境内。--no-build-isolation 让源码构建能看到这些文件，而不是进入无法发现它们的隔离构建环境。

验证后端​

运行一次几何操作并检查测量体积：

python - <<'PY'
import cadflow

with cadflow.Model() as model:
    box = model.box(2, 3, 4)
    print("CadFlow", cadflow.__version__)
    print("kind:", box.kind)
    print("volume:", box.volume)
    print("topology:", box.topology)
PY

版本应为 0.1.0，体积应为 24.0。

可选能力​

只安装工作流实际需要的扩展：

# PNG 渲染与图像检查
python -m pip install vtk pillow

# 碰撞检查
python -m pip install "python-fcl>=0.7.0.11"

# 检查结果绘图
python -m pip install "matplotlib>=3.7.0"

核心包已经包含 NumPy、Rich、JSON Schema 支持、草图求解器和 Gordon 曲面辅助包。

下一步​

继续阅读快速开始，构建安装板并导出 STEP 和 GLB 产物。