项目管理

ENERGY Designer 使用 .egp 文件作为项目配置文件，存储在项目根目录。项目管理涵盖创建、打开、加载和历史记录等功能。

新建项目

通过 文件 > 新建 > 新建项目（快捷键 Ctrl+P / macOS Cmd+P）打开新建项目对话框。

配置项

配置项	说明	输入类型	默认值/提示
项目名称	应用的名称，用于生成项目名和配置	文本输入	-
项目路径	项目存放的根目录	文本输入 + 目录选择器	-
Go 版本	系统中检测到的 Go 版本	自动检测	Go 1.20+ 为必需
GUI 渲染框架	选择 UI 渲染引擎	下拉选择框	见下方选项表

GUI 渲染框架选项

选项值	说明
LCL (Native - Lazarus Component Library)	原生桌面 UI 控件库，90+ 原生控件，9 个分类
WV (Web - WebView2, WebKit2)	基于系统 WebView 组件，支持 Web 内容嵌入
CEF (Web - Chromium Embedded Framework)	基于 Chromium 内核，完整 Web 渲染能力

项目创建过程

1. 填写项目名称和选择项目路径
2. 选择 GUI 渲染框架
3. 点击"创建"按钮
4. 设计器自动完成：
   • 创建项目目录结构（app/、layouts/、resources/ 等）
   • 生成 go.mod 和 go.sum 文件及依赖
   • 生成 main.go 入口文件（根据 GUI 框架选择不同的初始化方式）
   • 生成窗体列表文件 app/app.go（包含平台特定初始化代码）
   • 生成 UI 布局文件 layouts/form1.ui
   • 生成用户代码文件 app/form1.go
   • 生成 UI 代码文件 app/form1.ui.go
   • 生成资源文件（图标、平台元数据等）

Go 版本检测

创建项目时，设计器会自动检测系统中安装的 Go 版本。Go 1.20 或更高版本为必需。

打开项目

通过以下方式打开已有项目：

• 文件 > 打开（快捷键 Ctrl+O / macOS Cmd+O）
• 工具栏 点击"打开"按钮
• 文件 > 历史项目 直接点击历史记录

支持打开的文件类型：

• .egp - ENERGY Designer 项目文件

历史项目

设计器自动记录最近打开的项目，通过 文件 > 历史项目 菜单可快速访问。点击历史项目路径即可重新打开该项目。

项目配置文件 (.egp)

.egp 是 JSON 格式的项目配置文件，包含：

• 项目基本信息（名称、版本等）
• 窗体信息列表
• 应用配置（图标、元数据等）
• 构建配置

窗体信息

每个窗体记录：

• 窗体 ID（唯一标识）
• 窗体名称
• UI 布局文件路径
• 用户代码文件路径

新建窗体

通过 文件 > 新建 > 新建窗体（快捷键 Ctrl+N / macOS Cmd+N）在当前项目中创建新窗体。

创建新窗体时：

1. 自动生成唯一窗体名称（如 Form1、Form2）
2. 创建设计标签页
3. 生成对应的 UI 布局文件和 Go 代码文件
4. 添加到项目管理器的组件树中

关闭窗体

在设计器标签页上点击窗体标签的关闭按钮可关闭窗体。关闭后窗体从设计器中移除，但仍保留在项目中可重新打开并设计。

保存

设计器支持实时自动保存：UI 设计时属性变更会自动同步到 UI 布局文件。

手动保存通过 文件 > 保存（快捷键 Ctrl+S / macOS Cmd+S）执行。