按照 GNOME 官方的说法，Gjs 是 GNOME 的 JavaScript 绑定，主要基于 Spider Monkey 这个 JavaScript 引擎与 GObject Introspection [1] 实现。本文简单介绍一下 Gjs 的用法，之所以是简单介绍，是因为我对 JavaScript 不太熟悉。

Gjs 解析器

Gjs 解析器基于 Spider Monkey 实现，后者是 Firefox 的 JavaScript 引擎。如果系统中已安装了 gjs，那么在终端中执行：

$ gjs

便可运行 gjs 解析器，然后我在其中输入了我的第一个 Hello world 程序：

gjs> print ("hello world");
hello world

可以将 "print ("hello world");" 字符串保存到 hello-world.js 文件中，然后在终端中执行：

$ gjs hello-world.js

这样便可执行一个独立的 JavaScript 脚本程序了。

导入 GNOME 模块

gjs 提供了 imports.gi 对象，使用它可以导入被 GObject Introspection（GI）认可的 typelib 二进制文件所关联的 GNOME 模块对应的 JavaScript 对象，然后 gjs 便可以访问底层基于 GObject 库实现的 C 程序库。看下面的示例：

const GLib = imports.gi.GLib;

print (GLib.get_home_dir ());

当使用 gjs 执行这个脚本程序时，便会在终端中输出 $HOME 的值。

如何知道哪些 GNOME 库已被 GI 化

现在，GNOME 桌面的大部分程序库皆已 GI 化，通常可在 /usr/lib/girepository-1.0 目录中看到它们，只要在该目录中的出现的 typelib 文件，其对应的库便可在 gjs 通过 imports.gi 对象进行连接。再举个导入 Clutter 库的例子：

const Clutter = imports.gi.Clutter;

Clutter.init (null, null);

let stage = Clutter.Stage.get_default ();

stage.title = "Test";
stage.set_color(new Clutter.Color({red:150, blue:0, green:0, alpha:255}));
stage.show ();

Clutter.main ();

stage.destroy ();

如何使用被 GI 化的 GNOME 库函数

上面那个导入 Clutter 库的示例中，出现了许多 Clutter 库函数的 JavaScript 版本，它们对应的 C 函数原型信息可从  /usr/share/gir-1.0 目录中的 gir 文件中查到。例如 Clutter.init() 函数在 Clutter-1.0.gir 文件中对应的信息如下：

    <function name="init" c:identifier="clutter_init">
      <doc xml:whitespace="preserve">...clutter_init 函数的描述信息...</doc>
      <return-value transfer-ownership="none">
        <doc xml:whitespace="preserve">a #ClutterInitError value</doc>
        <type name="InitError" c:type="ClutterInitError"/>
      </return-value>
      <parameters>
        <parameter name="argc"
                   direction="inout"
                   caller-allocates="0"
                   transfer-ownership="full">
          <doc xml:whitespace="preserve">The number of arguments in @argv</doc>
          <type name="gint" c:type="int*"/>
        </parameter>
        <parameter name="argv"
                   direction="inout"
                   caller-allocates="0"
                   transfer-ownership="full"
                   allow-none="1">
          <doc xml:whitespace="preserve">A pointer to an array of arguments.</doc>
          <array length="0" zero-terminated="0" c:type="char***">
            <type name="utf8" c:type="char**"/>
          </array>
        </parameter>
      </parameters>
    </function>

不知道 GNOME 开发者以后会不会为 gir 文件提供一个浏览器。现在如果使用 gjs 的话，只好自己去读这样的 xml 文件或者自行去解析。

剩下的事情

上述只是简略介绍一下 gjs 的基本用法。如果真的打算使用 gjs 来写 GNOME 3 桌面程序的话，那么不仅要熟悉 javascript，还要能够读懂 devhelp 中 glib, gtk+, clutter 等 C 库的文档。

参考资料

[1] GObject Introspection 的简单示例

• 相关文章
• 全局相关文章