NodeGTK 项目教程

1. 项目的目录结构及介绍

NodeGTK 项目的目录结构如下：

node-gtk/
├── examples/
├── img/
├── lib/
├── src/
├── .gitignore
├── .npmignore
├── COPYING
├── Makefile
├── README.md
├── binding.gyp
├── node-gtk.doap
├── package.json

目录介绍

• examples/: 包含项目的示例代码。
• img/: 包含项目可能使用的图像文件。
• lib/: 包含项目的库文件。
• src/: 包含项目的源代码。
• .gitignore: 指定 Git 版本控制系统忽略的文件和目录。
• .npmignore: 指定 npm 发布时忽略的文件和目录。
• COPYING: 项目的许可证文件。
• Makefile: 项目的 Makefile 文件，用于编译和构建项目。
• README.md: 项目的说明文档。
• binding.gyp: 用于 Node.js 的构建配置文件。
• node-gtk.doap: 项目的描述文件。
• package.json: 项目的 npm 配置文件，包含项目依赖、脚本等信息。

2. 项目的启动文件介绍

NodeGTK 项目的启动文件通常是 examples/ 目录下的示例代码文件。这些文件展示了如何使用 NodeGTK 库来创建和操作 GTK+ 界面。

例如，一个典型的启动文件可能如下：

const { Gtk, GObject } = require('node-gtk');

Gtk.init(null);

const win = new Gtk.Window();
win.setTitle('Hello World');
win.setDefaultSize(200, 200);
win.connect('destroy', () => Gtk.mainQuit());

win.showAll();

Gtk.main();

启动文件介绍

• 引入库: 使用 require('node-gtk') 引入 NodeGTK 库。
• 初始化 GTK: 调用 Gtk.init(null) 初始化 GTK 环境。
• 创建窗口: 使用 new Gtk.Window() 创建一个新窗口。
• 设置窗口属性: 设置窗口的标题和大小。
• 连接事件: 连接窗口的 destroy 事件，以便在窗口关闭时退出 GTK 主循环。
• 显示窗口: 调用 win.showAll() 显示窗口中的所有控件。
• 启动主循环: 调用 Gtk.main() 启动 GTK 主循环。

3. 项目的配置文件介绍

NodeGTK 项目的主要配置文件是 package.json 和 binding.gyp。

package.json

package.json 文件包含了项目的元数据和依赖信息，以及一些脚本命令。以下是一个示例：

{
  "name": "node-gtk",
  "version": "1.0.0",
  "description": "GNOME Gtk+ bindings for Node.js",
  "main": "lib/index.js",
  "scripts": {
    "build": "node-gyp rebuild",
    "test": "echo \"Error: no test specified\" && exit 1"
  },
  "keywords": [
    "gtk",
    "gnome",
    "nodejs"
  ],
  "author": "Your Name",
  "license": "MIT",
  "dependencies": {
    "node-gyp": "^8.2.0"
  }
}

binding.gyp

binding.gyp 文件用于配置 Node.js 的构建系统，指定如何编译和链接 C++ 代码。以下是一个示例：

{
  "targets": [
    {
      "target_name": "node-gtk",
      "sources": [
        "src/main.cc",
        "src/gtk_wrapper.cc"
      ],
      "include_dirs": [
        "<!(node -e \"require('nan')\")"
      ],
      "libraries": [
        "-lgtk-3",
        "-lgdk-3",
        "-lpangocairo-1.0",
        "-lpango-1.0",
        "-latk-1.0",
        "-lcairo-gobject",