Beyond Linux® From Scratch (System V Edition) - Version r11.3-1128

Chapter 9. General Libraries

libportal-0.6

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.76.1

Recommended

GTK+-3.24.38, GTK-4.10.4, and (Qt-5.15.10 or qt-alternate-5.15.10)

Optional

Gi-DocGen-2023.1 and Vala-0.56.9

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.1 installed and wish to build the API documentation for this package, issue: 

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

This package does not come with a test suite.

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.1 installed. If you have Gi-DocGen-2023.1 installed and you wish to rebuild and install the API documentation, a meson configure command will reset this option.

-Dbackends=gtk3,gtk4,qt5: This switch allows you to set the available backends. You can use it to disable the dependency on gtk-3, gtk-4, or qt-5. Most applications that use libportal will use either gtk-4 or gtk-3. The default is to build all three backends.

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.