Gjs编程及调用底层库原理

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

Gjs 解析器

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

$ gjs

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

1 2	`gjs> print ("hello world");` `hello world`

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

1	`$ 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(newClutter.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 文件中对应的信息如下：

<functionname="init"c:identifier="clutter_init">

<docxml:whitespace="preserve">...clutter_init 函数的描述信息...</doc>

<return-valuetransfer-ownership="none">

<docxml:whitespace="preserve">a #ClutterInitError value</doc>

<typename="InitError"c:type="ClutterInitError"/>

</return-value>

<parameters>

<parametername="argc"

direction="inout"

caller-allocates="0"

transfer-ownership="full">

<docxml:whitespace="preserve">The number of arguments in @argv</doc>

<typename="gint"c:type="int*"/>

</parameter>

<parametername="argv"

direction="inout"

caller-allocates="0"

transfer-ownership="full"

allow-none="1">

<docxml:whitespace="preserve">A pointer to an array of arguments.</doc>

<arraylength="0"zero-terminated="0"c:type="char***">

<typename="utf8"c:type="char**"/>

</array>

</parameter>

</parameters>

</function>

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

剩下的事情

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

摘自

->> http://garfileo.is-programmer.com/posts/29644.html