Godot Launcher 安装与使用指南
1. 项目目录结构及介绍
Godot Launcher 是一个专为 GameShell 设计并旨在提升窗口管理、多任务处理和可自定义性的游戏启动器。以下是其主要的目录结构及其简介:
/home/<user>/godot-launcher/
├── apps # 存放应用和游戏的目录,包括定制的启动脚本和二进制文件。
│ ├── emulators # 模拟器相关应用程序
│ └── Menu # 实际的应用程序和游戏入口
│ ├── godot-launcher # 启动器本身的位置
│ ...
├── project.godot # Godot 工程文件,用于编辑和调整启动器
├── godot # Godot 引擎执行文件,用于运行启动器
├── compton # 组成部分之一,作为 compositor 以支持图形渲染
├── settings.conf # 启动器的设置配置文件
├── modules # 包含模块化组件,如默认主题和小部件
│ ├── default # 核心模块,实现了基本的界面元素、应用列表等
│ └── ... # 空白处意指你可以添加自己的模块
├── system # 系统文件和基础架构
├── library # 用于构建窗口管理器的本地库文件
└── ... # 其他支持文件和配置
每个子目录或文件都在启动器的运行中扮演着特定角色,从应用程序的存储到引擎的执行,再到用户界面的自定义。
2. 项目启动文件介绍
项目的核心在于 project.godot
文件,这是一个上帝视角编辑器(Godot Engine Editor)项目文件。通过它,开发者可以打开、编辑和重新导入启动器项目。重要的是,如果你想要进行任何修改,比如添加新功能或更改界面,你需要使用至少版本 3.2.3 的 Godot 编辑器打开这个文件。请注意,直接在 GameShell 上重导入项目目前是不支持的。
启动时实际的执行文件是 godot
,该可执行文件负责加载由 project.godot
定义的游戏启动器。
3. 项目的配置文件介绍
主配置文件:settings.conf
settings.conf
文件是启动器的关键配置所在,允许用户调整启动器的行为。虽然上述提到了一些环境特异性配置,如应用查找路径,但主要的配置细节通常包括但不限于:
- menu_directory:指定应用和游戏的查找目录,默认为
/home/cpi/apps/Menu
。修改此值可以让启动器在不同的目录寻找应用。 - 窗口管理、显示设置,以及其他可能影响用户交互和视觉体验的参数。
特殊配置与变量
启动器还假设一定的目录结构和逻辑,例如在 modules/default/launcher.launcher.gd
中有对菜单目录的硬编码引用。这意味着,对于更深层次的功能调整,你可能需要查看和修改这些脚本中的相关变量。
通过深入研究项目源码和这些配置文件,开发者能够高度定制Godot Launcher,以适应特定需求或优化用户体验。记住,对于非GameShell设备,可能需要额外的配置才能顺利运行,特别是路径和依赖项的调整。