Beyond Linux® From Scratch (Edição systemd ) - Versão 12.4

Capítulo 9. Bibliotecas Gerais

libportal-0.9.1

Introdução ao libportal

O pacote libportal fornece uma biblioteca que contém APIs assíncronas estilo GIO para a maioria dos portais Flatpak.

Esse pacote é conhecido por construir e funcionar corretamente usando uma plataforma LFS 12.4.

Informação do Pacote

Transferências Adicionais

Dependências do libportal

Exigidas

GLib-2.84.4 (com GObject Introspection)

Recomendadas

GTK-3.24.50 e GTK-4.18.6

Recomendadas (tempo de execução)

Para tornar esse pacote realmente útil, instale xdg-desktop-portal-1.20.3, xdg-desktop-portal-gtk-1.15.3, xdg-desktop-portal-gnome-48.0 (se executar um ambiente de área de trabalho GNOME) e xdg-desktop-portal-lxqt-1.2.0 (se executar um ambiente de área de trabalho LXQt). Eles não são necessários se usar esse pacote somente para satisfazer uma dependência de construção.

Opcionais

Gi-DocGen-2025.4 (para documentação), dbusmock-0.36.0 e pytest-8.4.1 (para testagem), Qt-6.9.2 e Vala-0.56.18

Instalação do libportal

[Atenção]

Atenção

Se uma versão anterior do "libportal" estiver instalada, [então] mova os cabeçalhos para fora do caminho, de forma que os pacotes posteriores não encontrem conflitos (como o(a) usuário(a) root): 

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

Primeiro, aplique um remendo para corrigir construção contra Qt 6.9 e posteriores: 

patch -Np1 -i ../libportal-0.9.1-qt6.9_fixes-1.patch

Instale libportal executando os seguintes comandos: 

mkdir build &&
cd    build &&

meson setup --prefix=/usr       \
            --buildtype=release \
            -D vapi=false       \
            -D docs=false       \
            .. &&
ninja

Se você tiver Gi-DocGen-2025.4 instalado e desejar construir a documentação da API para esse pacote, emita: 

sed -i "/output/s/-1/-0.9.1/" ../doc/meson.build &&
meson configure -D docs=true                     &&
ninja

Para testar os resultados, emita: ninja test. Observe que processos adicionais dbus-daemon possivelmente precisem ser eliminados depois que os testes forem executados.

Agora, como o(a) usuário(a) root: 

ninja install

Explicações do Comando

--buildtype=release: Especifique um tipo de construção adequado para lançamentos estáveis do pacote, pois o padrão possivelmente produza binários não otimizados.

-D vapi=false: Esse parâmetro desabilita usar Vala-0.56.18. Remova esse parâmetro se você o tiver instalado.

-D docs=false: Permite construir esse pacote sem Gi-DocGen-2025.4 instalado. Se você tiver Gi-DocGen-2025.4 instalado e desejar reconstruir e instalar a documentação da API, um comando meson configure reconfigurará essa opção.

Conteúdo

Aplicativos Instalados: Nenhum(a)
Bibliotecas Instaladas: libportal.so, libportal-gtk3.so, libportal-gtk4.so e libportal-qt6.so
Diretórios Instalados: /usr/include/libportal e /usr/share/gtk-doc/html/libportal

Descrições Curtas

libportal.so

fornece APIs assíncronas no estilo GIO para a maioria dos portais Flatpak

libportal-gtk3.so

fornece funções específicas do GTK+-3 para interagir com portais Flatpak

libportal-gtk4.so

fornece funções específicas do GTK-4 para interagir com portais Flatpak

libportal-qt6.so

fornece funções específicas do Qt6 para interagir com portais Flatpak