Beyond Linux® From Scratch (System V Edition) - Version r12.4-419

Chapter 25. Graphical Environment Libraries

libadwaita-1.8.1

Introduction to libadwaita

The libadwaita package provides additional GTK4 UI widgets for use in developing user interfaces. It is used primarily for GNOME applications.

[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

libadwaita Dependencies

Required

AppStream-1.1.1, GTK-4.20.2, and sassc-3.6.2

Recommended

Vala-0.56.18

Optional

Gi-DocGen-2025.5 and xdg-desktop-portal-1.20.3 (for two tests)

Installation of libadwaita

Install libadwaita by running the following commands: 

mkdir build &&
cd    build &&

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

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

sed "s/apiversion/'1.8.1'/" -i ../doc/meson.build &&
meson configure -D documentation=true             &&
ninja

To test the results, issue: ninja test. The tests must be run from a graphical session. Two tests will fail if xdg-desktop-portal-1.20.3 is not installed.

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.

Contents

Installed Programs: adwaita-1-demo
Installed Libraries: libadwaita-1.so
Installed Directories: /usr/include/libadwaita-1

Short Descriptions

adwaita-1-demo

provides an example of how to use the libadwaita library

libadwaita-1.so

provides additional GTK widgets for use in creating user interfaces