Skip to content

Latest commit

 

History

History
40 lines (28 loc) · 1.41 KB

HACKING.md

File metadata and controls

40 lines (28 loc) · 1.41 KB
Raw

Debugging

GNOME Shell extensions can be installed in ~/.local/share/gnome-shell/extensions. The easiest way to start testing your changes is to create a symbolic link:

$ glib-compile-schemas schemas
$ mkdir -p ~/.local/share/gnome-shell/extensions
$ rm -fr ~/.local/share/gnome-shell/extensions/[email protected] ; \
  cp -r `pwd` ~/.local/share/gnome-shell/extensions/[email protected]

And restart GNOME Shell by pressing Alt+F2 to open the Run Dialog and enter restart or r.

Now, in a terminal, you'll be able to see the extension logs:

$ journalctl -f -o cat /usr/bin/gnome-shell

Documentation

This guide is a good resource to get started with GNOME Shell extensions:

https://gjs.guide/extensions/

This extensions modifies the SwipeTracker class, so it is recommended to familiarize yourself with the Shell code in the different stable versions:

https://gitlab.gnome.org/GNOME/gnome-shell/-/blob/master/js/ui/swipeTracker.js

Creating a release

  • Increment the version number in metadata.json
  • Create a tag matching the new version. Notice that the version is only a number, it doesn't follow semantic versioning:
$ git tag X && git push && git push --tags
  • Wait until the draft release gets created, add a description and publish it
  • Download the generated zip file and publish it on GNOME Extensions