gnome shell 扩展开发的文档？

Question

我一直想开发一些 Gnome Shell 扩展，因为它们只是在 javascript 中，但是我一直在寻找并且几乎零文档，在我看到的任何地方人们只是说使用基本的 Gnome 文档，但这没有帮助，我可以找不到任何关于扩展导入的文档，或任何类型的用于扩展开发的 javascript api，我尝试查看一些教程（其中大部分是针对 Gnome 3.0，而不是 3.2），但没有任何帮助。

有谁知道他们是否正在为扩展开发编写文档？我真的很喜欢一些好的文档......

Answer 1

我对演示代码和教程不满意的原因是它们引入了一堆随机导入，并且从不解释它们是什么或如何使用它们。我正在构建自己的答案，其他人可以添加，以便人们可以真正知道他们可以调用哪些函数，可以导入哪些函数等。

有为Gnome Shell生成的文档，但它有点不完整——我找不到我在各种教程、示例和已发布的扩展中看到的大部分内容。

唯一真正可靠的文档是 Gnome Shell 源代码本身。根本没有任何其他最新或完整的方法来了解可用的内容。

这两个起点特别好：

• Gnome Shell C 源代码
• Gnome Shell JS 源代码

C 源代码显示有一个重要的对象称为global不需要导入，并提供对诸如窗口管理器（包括键绑定）、会话信息、可用屏幕和其他此类内容的访问。这是来源：

• 该壳global.c源本身
• 添加可用属性的源部分
• 显示底层对象类型的源代码部分

我想知道如何使用该global.display对象，目前最好的文档是Alan Knowles 提供的文档。

其他东西可以通过 GObject 自省绑定导入，例如：

• 该杂波UI库（imports.gi.Clutter）
• GLib 本身( imports.gi.GLib)
• 在壳牌工具包（imports.gi.St）

通常，您可以查看各种 Gnome 组件的参考文档以查找其他导入。

关于窥镜的注意事项：虽然在窥镜中使用这些导入有一些怪癖 - 我浪费了很多时间只是试图即时测试。例如：

const Clutter = imports.gi.Clutter;

...不会工作，因为Clutter已经存在。但是之后：

const MyClutter = imports.gi.Clutter;

...也行不通；MyClutter未定义且无法使用。你必须要做：

MyClutter = imports.gi.Clutter;

当然，在这种情况下Clutter已经存在，所以它并不是真正的必要。但是由于它没有记录在 Lookglass 命名空间中的内容和不存在的内容，如果您尝试导入某些内容并遇到这些问题，请记住它。

剩余问题：

• 什么是Mainloop？这是导入的main.js，似乎具有与 GLib 主循环相关的功能。有这方面的文件吗？
• 什么是imports.misc？里面似乎有一些非常有用的东西，比如ExtensionUtils——那是什么？
• 你如何使用DBus？内省呢？