root/Gitcloned-BettaFish
1
1
Fork 0
Code Issues Pull Requests Projects Releases Activity

New Version Dependency Name

Browse Source
This commit is contained in:
马一丁
2025-11-25 10:18:16 +08:00
parent 6c145399fe
commit 6ac676efb3
2 changed files with 29 additions and 20 deletions
Download Patch File Download Diff File Expand all files Collapse all files

22
static/Partial README for PDF Exporting/README-EN.md
View File

@@ -42,6 +42,10 @@ export DYLD_LIBRARY_PATH=/usr/local/lib:$DYLD_LIBRARY_PATH
echo 'export DYLD_LIBRARY_PATH=/opt/homebrew/lib:$DYLD_LIBRARY_PATH' >> ~/.zshrc
# Intel users: echo 'export DYLD_LIBRARY_PATH=/usr/local/lib:$DYLD_LIBRARY_PATH' >> ~/.zshrc
source ~/.zshrc
# 3. Verify in a new terminal
python -m ReportEngine.utils.dependency_check
# You should see “✓ Pango dependency check passed”
```
</details>
@@ -53,11 +57,17 @@ source ~/.zshrc
# 1. Install system dependencies (execute on host machine)
sudo apt-get update
sudo apt-get install -y \
libpango-1.0-0 \
libpangoft2-1.0-0 \
libgdk-pixbuf2.0-0 \
libffi-dev \
libcairo2
libpango-1.0-0 \
libpangoft2-1.0-0 \
libffi-dev \
libcairo2
# Prefer the newer package name; fall back if your repo doesn't provide it
if sudo apt-cache show libgdk-pixbuf-2.0-0 >/dev/null 2>&1; then
sudo apt-get install -y libgdk-pixbuf-2.0-0
else
sudo apt-get install -y libgdk-pixbuf2.0-0
fi
```
</details>
@@ -73,4 +83,4 @@ sudo yum install -y pango gdk-pixbuf2 libffi-devel cairo
</details>
> **Tip**: If using Docker deployment, no need to manually install these dependencies, the Docker image already contains all necessary system dependencies.
> **Tip**: If using Docker deployment, no need to manually install these dependencies, the Docker image already contains all necessary system dependencies.

27
static/Partial README for PDF Exporting/README.md
View File

@@ -28,8 +28,6 @@ python -m ReportEngine.utils.dependency_check
<details>
<summary><b> macOS 系统安装步骤</b></summary>
> **重要提示**：macOS 用户必须完成以下**两个步骤**，缺一不可！仅安装系统依赖而不设置环境变量会导致 `cannot load library 'libgobject-2.0-0'` 错误。
```bash
# 步骤 1: 安装系统依赖
brew install pango gdk-pixbuf libffi
@@ -46,14 +44,10 @@ echo 'export DYLD_LIBRARY_PATH=/opt/homebrew/lib:$DYLD_LIBRARY_PATH' >> ~/.zshrc
# Intel 用户请改为:
# echo 'export DYLD_LIBRARY_PATH=/usr/local/lib:$DYLD_LIBRARY_PATH' >> ~/.zshrc
source ~/.zshrc
```
**验证安装**：
```bash
# 测试 PDF 依赖是否正确配置
# 步骤 3: 验证（请在新终端执行）
python -m ReportEngine.utils.dependency_check
# 应该显示：✓ Pango 依赖检测通过，PDF 导出功能可用
# 输出包含 “✓ Pango 依赖检测通过” 表示配置正确
```
**常见问题**：
@@ -72,11 +66,17 @@ python -m ReportEngine.utils.dependency_check
# 1. 安装系统依赖（在宿主机上执行）
sudo apt-get update
sudo apt-get install -y \
libpango-1.0-0 \
libpangoft2-1.0-0 \
libgdk-pixbuf2.0-0 \
libffi-dev \
libcairo2
libpango-1.0-0 \
libpangoft2-1.0-0 \
libffi-dev \
libcairo2
# 优先使用新包名，若仓库缺失则回退
if sudo apt-cache show libgdk-pixbuf-2.0-0 >/dev/null 2>&1; then
sudo apt-get install -y libgdk-pixbuf-2.0-0
else
sudo apt-get install -y libgdk-pixbuf2.0-0
fi
```
</details>
@@ -92,4 +92,3 @@ sudo yum install -y pango gdk-pixbuf2 libffi-devel cairo
</details>
> **提示**：如果使用 Docker 部署，无需手动安装这些依赖，Docker 镜像已包含所有必要的系统依赖。