Причина я не доволен демонстрационным кодом и учебными руководствами, состоит в том, что они представляют набор случайного импорта и никогда не объясняют, что они или как использовать их. Я создаю свой собственный ответ, к которому могут добавить другие, так, чтобы люди могли на самом деле знать то, что функционирует, они могут звонить, что они могут импортировать и т.д.

Существует сгенерированная документация для Gnome Shell, но это несколько неполно — я не мог найти большинство вещей, которые я видел в различных учебных руководствах, примерах и опубликовал расширения.

Единственная действительно надежная документация является Gnome сам источник Shell. Просто нет никакого другого актуального или полного способа знать то, что доступно.

Эти две начальных точки особенно хороши:

• Gnome источник Shell C
• Gnome Shell источник JS

Источник C показывает, что существует важный названный объект global это не должно быть импортировано и обеспечивает доступ к вещам как менеджер окон (включая привязки клавиш), информация о сессии, экраны, доступные и другие такие вещи. Вот источник:

• Сам источник оболочки-global.c
• Часть источника, где доступные свойства добавляются
• Часть источника, который показывает Вам типы основных объектов

Я хотел знать, как использовать global.display объект и на данный момент лучшая документация - обеспеченный Alan Knowles.

Другие вещи могут быть импортированы через привязку самоанализа GObject, например:

• Библиотека Clutter UI (imports.gi.Clutter)
• Бойкий самостоятельно (imports.gi.GLib)
• Инструментарий Shell (imports.gi.St)

В целом можно просмотреть справочную документацию для различных компонентов Gnome для нахождения другого импорта.

Примечание по зеркалу: существуют некоторые причуды об использовании этого импорта в зеркале, хотя — я потратил впустую много времени, просто пытаясь проверить вещи на лету. Например:

const Clutter = imports.gi.Clutter;

... не будет работать, потому что Clutter уже существует. Но затем:

const MyClutter = imports.gi.Clutter;

... также не будет работать; MyClutter не определено и не может использоваться. Необходимо сделать:

MyClutter = imports.gi.Clutter;

Конечно, в этом случае Clutter уже существует, таким образом, это не действительно необходимо. Но так как это не документируется, что и уже не находится в пространстве имен зеркала, при попытке импортировать что-то и иметь эти проблемы, имеете в виду его.

Оставление вопросами:

• Что Mainloop? Это импортируется в main.js и, кажется, имеет функции, связанные с Бойким основным циклом. Есть ли документация для этого?
• Что imports.misc? Это, кажется, имеет некоторые действительно полезные вещи там, как ExtensionUtils — что это?
• Как Вы используете DBus? Что относительно самоанализа?