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

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

Informação do Pacote

Dependências do libportal

Exigidas

GLib-2.82.5 (com GObject Introspection)

Recomendadas

GTK-3.24.48 e GTK-4.16.12

Recomendadas (tempo de execução)

Para tornar esse pacote realmente útil, instale xdg-desktop-portal-1.20.0, xdg-desktop-portal-gtk-1.15.2, xdg-desktop-portal-gnome-47.3 (se executar um ambiente de área de trabalho GNOME) e xdg-desktop-portal-lxqt-1.1.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.3 (para documentação), dbusmock-0.34.3 e pytest-8.3.4 (para testagem), Qt-6.8.2 e Vala-0.56.17

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

Instale libportal executando os seguintes comandos: 

mkdir build &&
cd    build &&

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

Se você tiver Gi-DocGen-2025.3 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 docs=false: Permite construir esse pacote sem Gi-DocGen-2025.3 instalado. Se você tiver Gi-DocGen-2025.3 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