Hacking¶
One of the great challenges developing or contributing to a GNOME-Shell extension is the lack of documentation for it. In order to be as inviting as possible and to allow you to get hacking on Hamster-Shell-Extension without dwelling all to deep in the muddy waters of GNOME-Shell development we aim to do two things.
- Highlight those parts of the code that are closely coupled with specific parts of the GNOME-Shell framework. This way you have a good idea if there are hidden constrains to be considered or if “what you see is what you get”.
- Provide some references and bits and pieces about various aspects of GNOME-Shell development in general. This is particularly helpful if you actually need to interact with the shell framework to get you work done.
References¶
- GNOME’s own entry point for extension development
- Notes on i18n and preferences dialog.
- UUID Guidelines
- GJS: Javascript Bindings for GNOME. This also mentions the possibility of tests.
- A non trivial introduction by mathematicalcoffee which also explains some of the mandatory and optional bits and pieces.
- The closest to a practical API Reference I could find. While not perfect it provides a most useful starting point if you know what kind of widget/feature you want but not where to find it. Or of cause, if you want to know where to find out more about this obscure line of code you just stumbled upon.
- Additional information on i18n and multi-file extensions
- Information on current dbus best practices.
This is particular usefull as it mentions that
SyncandRemotestrings are appended to our interface method names. For a full tutorial please see refer to this one.