go-wayland 项目使用教程

1. 项目目录结构及介绍

go-wayland/
├── cmd/
│   └── go-wayland-scanner/
├── examples/
│   └── imageviewer/
├── wayland/
│   ├── cursor/
│   └── cursor/xcursor/
├── .gitattributes
├── .gitignore
├── AUTHORS
├── LICENSE
├── README.md
├── generate
├── go.work
└── go.work.sum

目录结构介绍

• cmd/: 包含命令行工具的源代码，例如 go-wayland-scanner。
• examples/: 包含示例应用程序的源代码，例如 imageviewer。
• wayland/: 包含 Wayland 协议的 Go 实现代码，包括 cursor 和 xcursor 的纯 Go 实现。
• .gitattributes: Git 属性文件，用于指定文件的属性。
• .gitignore: Git 忽略文件，用于指定不需要版本控制的文件。
• AUTHORS: 项目作者列表。
• LICENSE: 项目许可证文件。
• README.md: 项目介绍和使用说明。
• generate: 生成 Wayland 协议代码的脚本或工具。
• go.work: Go 工作区文件，用于多模块项目。
• go.work.sum: Go 工作区校验和文件。

2. 项目启动文件介绍

启动文件

• examples/imageviewer/main.go: 这是 imageviewer 示例应用程序的启动文件。它展示了如何使用 go-wayland 模块创建一个简单的图像查看器，包括窗口的创建、调整大小、光标主题、指针和键盘的支持。

启动步骤

1. 确保 Go 环境已正确配置。
2. 使用以下命令安装 imageviewer 示例应用程序：

   CGO_ENABLED=0 go install github.com/rajveermalviya/go-wayland/examples/imageviewer@latest
   

3. 运行 imageviewer 应用程序：

   imageviewer file.jpg
   

3. 项目的配置文件介绍

配置文件

• go.work: 这是 Go 工作区文件，用于管理多模块项目。它指定了项目的工作区路径和依赖模块。
• go.work.sum: 这是 Go 工作区校验和文件，用于验证工作区中的模块是否被篡改。

配置文件内容

• go.work:

  go 1.18
  
  use (
      ./cmd/go-wayland-scanner
      ./examples/imageviewer
      ./wayland
  )
  

• go.work.sum:

  github.com/rajveermalviya/go-wayland v0.0.0-20230101000000-abcdef123456
  

配置文件说明

• go.work: 指定了项目的工作区路径，包括 cmd/go-wayland-scanner、examples/imageviewer 和 wayland 模块。
• go.work.sum: 记录了项目依赖模块的校验和，确保模块的完整性和安全性。

通过以上步骤，您可以了解 go-wayland 项目的目录结构、启动文件和配置文件，并能够顺利启动和运行示例应用程序。