Packaging

Note to Users

This documentation is meant for distribution packagers. If you encounter a packaging bug with GSConnect, you should file a downstream bug report with the distribution or package maintainer.

GSConnect uses a complete meson build that can produce a user Zip or system package.

For Ubuntu Budgie support, use AppIndicator for KDE Connect by Bajoja since Ubuntu Budgie is not compatible with Gnome Shell extensions.

Dependencies

The only true dependency of GSConnect is gnome-shell >= 3.28, so packagers can decide what they consider required or optional dependencies. Each feature below lists the precise shared objects (.so), typelibs (.typelib) or binaries required, and briefly describes what plugin or functionality requires it.

• Contacts Integration (libfolks)

  REQUIRES: libgobject-2.0.so.0, libfolks-eds.so.25, Folks-0.6.typelib

  GSConnect supports integrating desktop contacts using libfolks, which aggregates contacts from Gnome Online Accounts, Evolution and more.

  If libfolks is not supported an address book cached from received data will be used.

• Files Integration (nautilus-python)

  REQUIRES: Nautilus-3.0.typelib, libnautilus-python.so

  GSConnect includes a Nautilus extension written using the Python bindings allowing files to be sent from the context menu of selected items.

  See the meson notes for --nautilus below for more information.

• Sound Effects (libcanberra)

  REQUIRES: canberra-gtk-play

  GSConnect plays sounds from the sound-theme-spec and most Gnome Shell users will have libcanberra and canberra-gtk-play installed as a dependency of the desktop. GSConnect can also use the GSound API if available, but this is optional.

  If neither are available, GSConnect will attempt to fallback to using gdk_display_beep().

  The Find My Phone plugin loops a sound effect when receiving a location request.

Notes on meson Options

If you need additional build options to package GSConnect for your distribution, consider opening a New Issue describing your requirements before maintaining a downstream patch. If the required changes don't break compatibility for another packager, they will probably be approved.

• -Dgnome_shell_libdir=PATH

  Default is PREFIX/LIBDIR, where LIBDIR is as defined by --libdir. If provided it will override LIBDIR when searching for Gvc-1.0.typelib so that the result is:

  GNOME_SHELL_LIBDIR/gnome-shell/Gvc-1.0.typelib

  When installed as a user extension PREFIX/LIBDIR is inferred from gjs's GIRepository search path. When building as a system package, GSConnect will fallback to this behaviour if GNOME_SHELL_LIBDIR/gnome-shell/Gvc-1.0.typelib is not found at runtime.

• -Dgsettings_schemadir=PATH

  Default is PREFIX/DATADIR/glib-2.0/schemas. If provided it will override the path when compiling and loading the GSchema so that the result is:

  GSETTINGS_SCHEMADIR/gschemas.compiled

• -Dpost_install=false

  Default is false. If true the script meson/post-install.sh will be run at the end of the install target. Currently, this compiles the GSchemas in GSETTINGS_SCHEMADIR using glib-compile-schemas.

• -Dsession_bus_services_dir=PATH

  GSConnect uses DBus Activation so that the Shell extension can start the service at login and restart it if updated.

  When installed as a user extension the service file is installed to XDG_DATA_HOME/dbus-1/services/ by the Shell extension when it is loaded (not enabled/disabled). When building as a system package the default is to check pkg-config, then fallback back to PREFIX/DATADIR/dbus-1/services.

• -Dopenssl_path=openssl
-Dsshadd_path=ssh-add
-Dsshkeygen_path=ssh-keygen

  When building as a system package, each option will override the default behaviour of searching PATH when spawning an external process. In other words, the default is the executable name (eg. sshfs), but may be overriden with an absolute path to the executable (eg. /usr/bin/sshfs).

• -Dnautilus=true
-Dnemo=true

  Default is true. If false a helper extension will not be installed for the corresponding file manager.

  When installed as a user extension the file manager helpers are installed by the Shell extension when it is loaded (not enabled/disabled) at the following locations:

  XDG_DATA_HOME/nautilus-python/extensions/nautilus-gsconnect.py
  XDG_DATA_HOME/nemo-python/extensions/nemo-gsconnect.py

  When building as a system package:

  PREFIX/DATADIR/nautilus-python/extensions/nautilus-gsconnect.py
  PREFIX/DATADIR/nemo-python/extensions/nemo-gsconnect.py

  Although there is currently no build target for producing a separate package for the Nautilus or Nemo extensions, if that's appropriate for your distribution you are welcome to do so. The extensions depend on the nautilus-python / nemo-python file manager extension framework, and only require access to the Session DBus and translations.

• -Dwebextension=true

  Default is true. If false the WebExtension manifests will not be installed, making it impossible for the Native Messaging Host to be started by the Chrome Extension or Firefox Add-On. Although there is currently no build target for producing a separate package for the manifests it is possible, although the WebExtension itself will always be distributed from the browser's extension or add-on website.

  When installed as a user extension the manifests are installed by the Shell extension when it is loaded (not enabled/disabled) in the following locations:

  XDG_CONFIG_HOME/google-chrome{,-beta,-unstable}/NativeMessagingHosts/
  XDG_CONFIG_HOME/chromium/NativeMessagingHosts/
  HOME/.mozilla/native-messaging-hosts/

  When building as a system package:

  SYSCONFDIR/opt/chrome/native-messaging-hosts/
  SYSCONFDIR/chromium/native-messaging-hosts/
  PREFIX/LIBDIR/mozilla/native-messaging-hosts/

• -Dchrome_nmhdir=PATH
-Dchromium_nmhdir=PATH
-Dmozilla_nmhdir=PATH

  When building as a system package, these three options override the install path for the native messaging hosts so that the destination is:

  CHROME_NMHDIR/org.gnome.shell.extensions.gsconnect.json
  CHROMIUM_NMHDIR/org.gnome.shell.extensions.gsconnect.json
  MOZILLA_NMHDIR/org.gnome.shell.extensions.gsconnect.json