Add libsoup-3.0 installation instructions to build documentation
All checks were successful
GBCI / build (push) Successful in 15s

- Added libsoup-3.0-dev to Ubuntu/Debian desktop GUI dependencies
- Added libsoup3-devel to Fedora/RHEL desktop GUI dependencies
- Added new troubleshooting section for libsoup-3.0 dependency warning
- Documented that this is only needed for desktop/Tauri builds
- Noted that server-only builds can safely ignore the warning
This commit is contained in:
Rodrigo Rodriguez (Pragmatismo) 2026-02-05 22:28:02 -03:00
parent 9c9b3b6d1f
commit 827e011ac0

View file

@ -96,7 +96,8 @@ sudo apt install -y \
libwebkit2gtk-4.0-dev \ libwebkit2gtk-4.0-dev \
libjavascriptcoregtk-4.1-dev \ libjavascriptcoregtk-4.1-dev \
libayatana-appindicator3-dev \ libayatana-appindicator3-dev \
librsvg2-dev librsvg2-dev \
libsoup-3.0-dev
``` ```
**Note:** Desktop GUI dependencies are only needed if building with `--features desktop`. For minimal builds without desktop GUI, these libraries are not required. **Note:** Desktop GUI dependencies are only needed if building with `--features desktop`. For minimal builds without desktop GUI, these libraries are not required.
@ -140,7 +141,8 @@ sudo dnf install -y \
webkit2gtk3-devel \ webkit2gtk3-devel \
javascriptcore-gtk-devel \ javascriptcore-gtk-devel \
libappindicator-gtk3-devel \ libappindicator-gtk3-devel \
librsvg2-devel librsvg2-devel \
libsoup3-devel
``` ```
**Note:** Desktop GUI dependencies are only needed if building with `--features desktop`. For minimal builds without desktop GUI, these libraries are not required. **Note:** Desktop GUI dependencies are only needed if building with `--features desktop`. For minimal builds without desktop GUI, these libraries are not required.
@ -440,6 +442,33 @@ $env:OPENSSL_DIR="C:\vcpkg\installed\x64-windows"
cargo build --release cargo build --release
``` ```
### libsoup-3.0 Dependency Warning
**Warning:** `pkg-config exited with status code 1` when searching for `libsoup-3.0`
This occurs when the libsoup-3.0 development library is missing but is required by a transitive dependency for desktop features.
**Solution (Linux):**
```bash
sudo apt install libsoup-3.0-dev
```
**Solution (Fedora/RHEL):**
```bash
sudo dnf install libsoup3-devel
```
**Solution (macOS):**
```bash
brew install libsoup
export PKG_CONFIG_PATH=$(brew --prefix libsoup)/lib/pkgconfig:$PKG_CONFIG_PATH
```
**Note:** This library is only needed for desktop/Tauri builds with GTK dependencies. If building with `--no-default-features` for server-only deployments, this library is not required and the warning can be safely ignored.
### PostgreSQL Library Errors ### PostgreSQL Library Errors
If libpq is not found: If libpq is not found: