[Debian-on-mobile-maintainers] Bug#1050917: phosh: please provide a phosh-portals.conf for xdg-desktop-portal

[Simon McVittie]

Package: phosh
Severity: normal
Tags: trixie sid
User: xdg-desktop-portal at packages.debian.org
Usertags: portals.conf

xdg-desktop-portal 1.17.x introduces a new way to select which portals will
be used for which desktop environments, modelled on mimeapps.list:

- each desktop environment should provide a file like
  /usr/share/xdg-desktop-portal/phosh-portals.conf

- the filename is ${DESKTOP}-portals.conf where ${DESKTOP} is the desktop
  environment's entry in $XDG_CURRENT_DESKTOP (the same as the DesktopNames
  from /usr/share/{x,wayland-}sessions/*.desktop), folded to lower case

- sysadmins and users can override this via files named portals.conf or
  ${DESKTOP}-portals.conf in various locations like /etc/xdg-desktop-portal
  and ~/.config/xdg-desktop-portal

Please see portals.conf(5) or its source code
https://github.com/flatpak/xdg-desktop-portal/blob/main/doc/portals-conf.rst
for full details.

If I'm reading correctly, I think phosh uses
XDG_CURRENT_DESKTOP="Phosh:GNOME" but needs portals that are not quite the
same as GNOME's, because it's using a wlroots-based compositor instead of
the mutter-based GNOME Shell?

If that's the case, then it should provide a phosh-portals.conf so that
individual users aren't required to set this up for themselves.

For example, it might look something like this (this is untested and based
on guesses, I don't use Phosh myself, so please check this carefully):

[preferred]
default=gtk;
org.freedesktop.impl.portal.Secret=gnome-keyring;
# Non-GNOME-Shell-specific parts of x-d-p-gnome
org.freedesktop.impl.portal.Account=gnome;gtk;
org.freedesktop.impl.portal.AppChooser=gnome;gtk;
org.freedesktop.impl.portal.Background=gnome;gtk;
org.freedesktop.impl.portal.DynamicLauncher=gnome;gtk;
org.freedesktop.impl.portal.FileChooser=gnome;gtk;
org.freedesktop.impl.portal.Lockdown=gnome;gtk;
org.freedesktop.impl.portal.Print=gnome;gtk;
org.freedesktop.impl.portal.Settings=gnome;gtk;
org.freedesktop.impl.portal.Wallpaper=gnome;gtk;
# Phosh-specific
org.freedesktop.impl.portal.Access=phosh;
org.freedesktop.impl.portal.RemoteDesktop=none;
org.freedesktop.impl.portal.ScreenCast=wlr;
org.freedesktop.impl.portal.Screenshot=wlr;

The desktop environment (either phosh or some larger metapackage) should
probably also have a Recommends, or at least a Suggests, on whatever
portals would be most appropriate for it.

Thanks,
    smcv

-- 
This is part of a mass bug filing:
https://lists.debian.org/debian-devel/2023/08/msg00311.html