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

Capítulo 9. Bibliotecas Gerais

libportal-0.7.1

Introdução a 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.1.

Informação do Pacote

Transferências Adicionais

Dependências do libportal

Exigida

gobject-introspection-1.78.1

Recomendadas

GTK+-3.24.41 e GTK-4.12.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-45.1 (se executar um ambiente de área de trabalho GNOME) e xdg-desktop-portal-lxqt-0.5.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-2023.3 (para documentação), dbusmock-0.30.2 e pytest-8.0.0 (para testagem), (Qt-5.15.12 ou qt-alternate-5.15.12) (para a versão Qt5 da libportal) e Vala-0.56.14

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 uma dúzia de 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 -Ddocs=false .. &&
ninja

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

sed "/output/s/-1/-0.7.1/" -i ../doc/meson.build &&
meson configure -Ddocs=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.

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