Beyond Linux® From Scratch (Edição System V) - Versão 12.2

Capítulo 9. Bibliotecas Gerais

libportal-0.7.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.2.

Informação do Pacote

Transferências Adicionais

Dependências do libportal

Exigidas

GLib-2.80.4 (com GObject Introspection)

Recomendadas

GTK+-3.24.43 e GTK-4.14.5

Recomendadas (tempo de execução)

Para tornar esse pacote realmente útil, instale xdg-desktop-portal-1.18.2, xdg-desktop-portal-gtk-1.15.1, xdg-desktop-portal-gnome-46.2 (se executar um ambiente de área de trabalho GNOME) e xdg-desktop-portal-lxqt-1.0.2 (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-2024.1 (para documentação), dbusmock-0.32.1 e pytest-8.3.2 (para testagem), qt5-components-5.15.14 (para a versão Qt5 da libportal) 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

Se executar a suíte de teste, aplique um remendo para corrigir várias falhas de teste com python-dbusmock 0.30.0 ou posterior: 

patch -Np1 -i ../libportal-0.7.1-testsuite_fix-1.patch

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-2024.1 instalado e desejar construir a documentação da API para esse pacote, emita: 

sed "/output/s/-1/-0.7.1/" -i ../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-2024.1 instalado. Se você tiver Gi-DocGen-2024.1 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-qt5.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-qt5.so

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