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

Chapter 25. Graphical Environment Libraries

libadwaita-1.8.4

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

This version of BLFS may not build or run some packages properly if LFS or dependencies have been updated since the most recent stable version of the System V books.

Package Information

libadwaita Dependencies

Required

AppStream-1.1.2, GTK-4.20.3, and sassc-3.6.2

Recommended

Vala-0.56.18

Optional

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

sed "s/apiversion/'1.8.4'/" -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