Beyond Linux® From Scratch (systemd Edition) - Version r12.0-816

Chapter 9. General Libraries

libportal-0.7.1

Introduction to libportal

The libportal package provides a library that contains GIO-style async APIs for most Flatpak portals.

[Note]

Note

Development versions of BLFS may not build or run some packages properly if LFS or dependencies have been updated since the most recent stable versions of the books.

Package Information

libportal Dependencies

Required

gobject-introspection-1.78.1

Recommended

GTK+-3.24.38 and GTK-4.12.4

Optional

Gi-DocGen-2023.3 (for documentation), dbusmock-0.29.1 and pytest-7.4.3 (for testing), (Qt-5.15.11 or qt-alternate-5.15.11) (for the Qt5 version of libportal), and Vala-0.56.14

Installation of libportal

[Warning]

Warning

If a previous version of libportal is installed, move the headers out of the way so that later packages do not encounter conflicts (as the root user): 

if [ -e /usr/include/libportal ]; then
    rm -rf /usr/include/libportal.old &&
    mv -vf /usr/include/libportal{,.old}
fi

Install libportal by running the following commands: 

mkdir build &&
cd    build &&

meson setup --prefix=/usr --buildtype=release -Ddocs=false .. &&
ninja

If you have Gi-DocGen-2023.3 installed and wish to build the API documentation for this package, issue: 

sed "/output/s/-1/-0.7.1/" -i ../doc/meson.build &&
meson configure -Ddocs=true                    &&
ninja

To test the results, issue: ninja test. Note that additional dbus-daemon processes may need to be killed after the tests are run.

Now, as the root user: 

ninja install

Command Explanations

--buildtype=release: Specify a buildtype suitable for stable releases of the package, as the default may produce unoptimized binaries.

-Ddocs=false: Allow building this package without Gi-DocGen-2023.3 installed. If you have Gi-DocGen-2023.3 installed and you wish to rebuild and install the API documentation, a meson configure command will reset this option.

Contents

Installed Programs: None
Installed Libraries: libportal.so, libportal-gtk3.so, libportal-gtk4.so, and libportal-qt5.so
Installed Directories: /usr/include/libportal and /usr/share/gtk-doc/html/libportal

Short Descriptions

libportal.so

provides GIO-style async APIs for most Flatpak portals

libportal-gtk3.so

provides GTK+-3 specific functions for interacting with Flatpak portals

libportal-gtk4.so

provides GTK-4 specific functions for interacting with Flatpak portals

libportal-qt5.so

provides Qt5 specific functions for interacting with Flatpak portals