Showing
2 changed files
with
98 additions
and
95 deletions
| @@ -391,104 +391,11 @@ uv venv --python 3.11 # 创建3.11环境 | @@ -391,104 +391,11 @@ uv venv --python 3.11 # 创建3.11环境 | ||
| 391 | 391 | ||
| 392 | ### 2. 安装 PDF 导出所需系统依赖(可选) | 392 | ### 2. 安装 PDF 导出所需系统依赖(可选) |
| 393 | 393 | ||
| 394 | -> ⚠️ **注意**:如果您需要使用 PDF 导出功能,请按照以下步骤安装系统依赖。如果不需要 PDF 导出功能,可以跳过此步骤,系统其他功能不受影响。 | ||
| 395 | - | ||
| 396 | -<details> | ||
| 397 | -<summary><b>📦 macOS 系统安装步骤</b></summary> | ||
| 398 | - | ||
| 399 | -> 🔴 **重要提示**:macOS 用户必须完成以下**两个步骤**,缺一不可!仅安装系统依赖而不设置环境变量会导致 `cannot load library 'libgobject-2.0-0'` 错误。 | ||
| 400 | - | ||
| 401 | -```bash | ||
| 402 | -# 步骤 1: 安装系统依赖 | ||
| 403 | -brew install pango gdk-pixbuf libffi | ||
| 404 | - | ||
| 405 | -# 步骤 2: 设置环境变量(⚠️ 必须执行!) | ||
| 406 | -# 方法一:临时设置(仅当前终端会话有效) | ||
| 407 | -# Apple Silicon | ||
| 408 | -export DYLD_LIBRARY_PATH=/opt/homebrew/lib:$DYLD_LIBRARY_PATH | ||
| 409 | -# Intel Mac | ||
| 410 | -export DYLD_LIBRARY_PATH=/usr/local/lib:$DYLD_LIBRARY_PATH | ||
| 411 | - | ||
| 412 | -# 方法二:永久设置(推荐) | ||
| 413 | -echo 'export DYLD_LIBRARY_PATH=/opt/homebrew/lib:$DYLD_LIBRARY_PATH' >> ~/.zshrc | ||
| 414 | -# Intel 用户请改为: | ||
| 415 | -# echo 'export DYLD_LIBRARY_PATH=/usr/local/lib:$DYLD_LIBRARY_PATH' >> ~/.zshrc | ||
| 416 | -source ~/.zshrc | ||
| 417 | -``` | ||
| 418 | - | ||
| 419 | -**验证安装**: | ||
| 420 | - | ||
| 421 | -```bash | ||
| 422 | -# 测试 PDF 依赖是否正确配置 | ||
| 423 | -python -m ReportEngine.utils.dependency_check | ||
| 424 | -# 应该显示:✓ Pango 依赖检测通过,PDF 导出功能可用 | ||
| 425 | -``` | ||
| 426 | - | ||
| 427 | -**常见问题**: | ||
| 428 | - | ||
| 429 | -- 如果仍然提示找不到库,请确保: | ||
| 430 | - 1. 已执行 `source ~/.zshrc` 重新加载配置 | ||
| 431 | - 2. 在新终端中运行应用(确保环境变量已生效) | ||
| 432 | - 3. 使用 `echo $DYLD_LIBRARY_PATH` 验证环境变量已设置 | ||
| 433 | - | ||
| 434 | -</details> | ||
| 435 | - | ||
| 436 | -<details> | ||
| 437 | -<summary><b>🐧 Ubuntu/Debian 系统安装步骤</b></summary> | ||
| 438 | - | ||
| 439 | -```bash | ||
| 440 | -# 1. 安装系统依赖(在宿主机上执行) | ||
| 441 | -sudo apt-get update | ||
| 442 | -sudo apt-get install -y \ | ||
| 443 | - libpango-1.0-0 \ | ||
| 444 | - libpangoft2-1.0-0 \ | ||
| 445 | - libgdk-pixbuf2.0-0 \ | ||
| 446 | - libffi-dev \ | ||
| 447 | - libcairo2 | ||
| 448 | -``` | ||
| 449 | - | ||
| 450 | -</details> | ||
| 451 | - | ||
| 452 | -<details> | ||
| 453 | -<summary><b>🎩 CentOS/RHEL 系统安装步骤</b></summary> | ||
| 454 | - | ||
| 455 | -```bash | ||
| 456 | -# 1. 安装系统依赖(在宿主机上执行) | ||
| 457 | -sudo yum install -y pango gdk-pixbuf2 libffi-devel cairo | ||
| 458 | -``` | ||
| 459 | - | ||
| 460 | -</details> | ||
| 461 | - | ||
| 462 | -<details> | ||
| 463 | -<summary><b>🪟 Windows 系统安装步骤</b></summary> | ||
| 464 | - | ||
| 465 | -```powershell | ||
| 466 | -# 1. 下载并安装 GTK3 Runtime(在宿主机上执行) | ||
| 467 | -# 访问:https://github.com/tschoonj/GTK-for-Windows-Runtime-Environment-Installer/releases | ||
| 468 | -# 下载最新版本的 .exe 文件并安装 | ||
| 469 | - | ||
| 470 | -# 2. 将 GTK 安装目录下的 bin 添加到 PATH(安装后请重新打开终端) | ||
| 471 | -# 默认路径示例(如果安装在其他目录,请替换成你的实际路径) | ||
| 472 | -set PATH=C:\Program Files\GTK3-Runtime Win64\bin;%PATH% | ||
| 473 | - | ||
| 474 | -# 可选:永久添加到 PATH | ||
| 475 | -setx PATH "C:\Program Files\GTK3-Runtime Win64\bin;%PATH%" | ||
| 476 | - | ||
| 477 | -# 如果安装在自定义目录,请替换为实际路径,或设置环境变量 GTK_BIN_PATH=你的bin路径,再重新打开终端 | ||
| 478 | - | ||
| 479 | -# 3. 验证(新终端执行) | ||
| 480 | -python -m ReportEngine.utils.dependency_check | ||
| 481 | -# 输出包含 “✓ Pango 依赖检测通过” 表示配置正确 | ||
| 482 | -``` | ||
| 483 | - | ||
| 484 | -</details> | ||
| 485 | - | ||
| 486 | -> 💡 **提示**:如果使用 Docker 部署,无需手动安装这些依赖,Docker 镜像已包含所有必要的系统依赖。 | ||
| 487 | - | 394 | +这部分有详细的配置说明:[配置“导出为PDF“所需的依赖](./static/Partial%20README%20for%20PDF%20Exporting/README.md) |
| 488 | 395 | ||
| 489 | ### 3. 安装依赖包 | 396 | ### 3. 安装依赖包 |
| 490 | 397 | ||
| 491 | -> 如果跳过了步骤2,weasyprint库会无法安装,属正常情况。 | 398 | +> 如果跳过了步骤2,weasyprint库可能无法安装,PDF功能可能无法正常使用。 |
| 492 | 399 | ||
| 493 | ```bash | 400 | ```bash |
| 494 | # 基础依赖安装 | 401 | # 基础依赖安装 |
| 1 | + | ||
| 2 | +> ⚠️ **注意**:如果您需要使用 PDF 导出功能,请按照以下步骤安装系统依赖。如果不需要 PDF 导出功能,可以跳过此步骤,系统其他功能不受影响。 | ||
| 3 | + | ||
| 4 | +<details> | ||
| 5 | +<summary><b>🪟 Windows 系统安装步骤</b></summary> | ||
| 6 | + | ||
| 7 | +```powershell | ||
| 8 | +# 1. 下载并安装 GTK3 Runtime(在宿主机上执行) | ||
| 9 | +# 访问:https://github.com/tschoonj/GTK-for-Windows-Runtime-Environment-Installer/releases | ||
| 10 | +# 下载最新版本的 .exe 文件并安装 | ||
| 11 | +# 强烈建议安装到默认路径,这可能有助于规避许多未知错误 | ||
| 12 | + | ||
| 13 | +# 2. 将 GTK 安装目录下的 bin 添加到 PATH(安装后请重新打开终端) | ||
| 14 | +# 默认路径示例(如果安装在其他目录,请替换成你的实际路径) | ||
| 15 | +set PATH=C:\Program Files\GTK3-Runtime Win64\bin;%PATH% | ||
| 16 | + | ||
| 17 | +# 可选:永久添加到 PATH | ||
| 18 | +setx PATH "C:\Program Files\GTK3-Runtime Win64\bin;%PATH%" | ||
| 19 | + | ||
| 20 | +# 如果安装在自定义目录,请替换为实际路径,或设置环境变量 GTK_BIN_PATH=你的bin路径,再重新打开终端 | ||
| 21 | + | ||
| 22 | +# 3. 验证(新终端执行) | ||
| 23 | +python -m ReportEngine.utils.dependency_check | ||
| 24 | +# 输出包含 “✓ Pango 依赖检测通过” 表示配置正确 | ||
| 25 | +``` | ||
| 26 | + | ||
| 27 | +</details> | ||
| 28 | + | ||
| 29 | +<details> | ||
| 30 | +<summary><b>📦 macOS 系统安装步骤</b></summary> | ||
| 31 | + | ||
| 32 | +> 🔴 **重要提示**:macOS 用户必须完成以下**两个步骤**,缺一不可!仅安装系统依赖而不设置环境变量会导致 `cannot load library 'libgobject-2.0-0'` 错误。 | ||
| 33 | + | ||
| 34 | +```bash | ||
| 35 | +# 步骤 1: 安装系统依赖 | ||
| 36 | +brew install pango gdk-pixbuf libffi | ||
| 37 | + | ||
| 38 | +# 步骤 2: 设置环境变量(⚠️ 必须执行!) | ||
| 39 | +# 方法一:临时设置(仅当前终端会话有效) | ||
| 40 | +# Apple Silicon | ||
| 41 | +export DYLD_LIBRARY_PATH=/opt/homebrew/lib:$DYLD_LIBRARY_PATH | ||
| 42 | +# Intel Mac | ||
| 43 | +export DYLD_LIBRARY_PATH=/usr/local/lib:$DYLD_LIBRARY_PATH | ||
| 44 | + | ||
| 45 | +# 方法二:永久设置(推荐) | ||
| 46 | +echo 'export DYLD_LIBRARY_PATH=/opt/homebrew/lib:$DYLD_LIBRARY_PATH' >> ~/.zshrc | ||
| 47 | +# Intel 用户请改为: | ||
| 48 | +# echo 'export DYLD_LIBRARY_PATH=/usr/local/lib:$DYLD_LIBRARY_PATH' >> ~/.zshrc | ||
| 49 | +source ~/.zshrc | ||
| 50 | +``` | ||
| 51 | + | ||
| 52 | +**验证安装**: | ||
| 53 | + | ||
| 54 | +```bash | ||
| 55 | +# 测试 PDF 依赖是否正确配置 | ||
| 56 | +python -m ReportEngine.utils.dependency_check | ||
| 57 | +# 应该显示:✓ Pango 依赖检测通过,PDF 导出功能可用 | ||
| 58 | +``` | ||
| 59 | + | ||
| 60 | +**常见问题**: | ||
| 61 | + | ||
| 62 | +- 如果仍然提示找不到库,请确保: | ||
| 63 | + 1. 已执行 `source ~/.zshrc` 重新加载配置 | ||
| 64 | + 2. 在新终端中运行应用(确保环境变量已生效) | ||
| 65 | + 3. 使用 `echo $DYLD_LIBRARY_PATH` 验证环境变量已设置 | ||
| 66 | + | ||
| 67 | +</details> | ||
| 68 | + | ||
| 69 | +<details> | ||
| 70 | +<summary><b>🐧 Ubuntu/Debian 系统安装步骤</b></summary> | ||
| 71 | + | ||
| 72 | +```bash | ||
| 73 | +# 1. 安装系统依赖(在宿主机上执行) | ||
| 74 | +sudo apt-get update | ||
| 75 | +sudo apt-get install -y \ | ||
| 76 | + libpango-1.0-0 \ | ||
| 77 | + libpangoft2-1.0-0 \ | ||
| 78 | + libgdk-pixbuf2.0-0 \ | ||
| 79 | + libffi-dev \ | ||
| 80 | + libcairo2 | ||
| 81 | +``` | ||
| 82 | + | ||
| 83 | +</details> | ||
| 84 | + | ||
| 85 | +<details> | ||
| 86 | +<summary><b>🎩 CentOS/RHEL 系统安装步骤</b></summary> | ||
| 87 | + | ||
| 88 | +```bash | ||
| 89 | +# 1. 安装系统依赖(在宿主机上执行) | ||
| 90 | +sudo yum install -y pango gdk-pixbuf2 libffi-devel cairo | ||
| 91 | +``` | ||
| 92 | + | ||
| 93 | +</details> | ||
| 94 | + | ||
| 95 | +> 💡 **提示**:如果使用 Docker 部署,无需手动安装这些依赖,Docker 镜像已包含所有必要的系统依赖。 | ||
| 96 | + |
-
Please register or login to post a comment