简介

eapp 是 ee-go 的应用生命周期管理模块，提供进程信号监听、优雅退出、事件注册和 package.json 读取能力。它监听系统信号（SIGINT、SIGTERM、SIGQUIT），触发退出流程，并支持在退出前执行用户注册的钩子函数（如关闭数据库连接）。

导入

import "github.com/wallace5303/ee-go/eapp"

API

Run()

说明：启动程序并监听系统信号。当收到 SIGINT、SIGTERM 或 SIGQUIT 信号时，自动调用 Close() 执行优雅退出流程。

参数：无

返回值：无

示例：

package main

import (
    "github.com/wallace5303/ee-go/eboot"
)

func main() {
    ego := eboot.New(staticFS)
    ego.Run() // 内部调用 eapp.Run()，阻塞等待信号
}

参见：Close()

---

Close()

说明：执行进程优雅退出。设置退出标志，触发已注册的 beforeClose 事件钩子，等待 500ms，然后恢复标志并调用 os.Exit(0) 退出进程。该方法使用互斥锁防止并发调用。

参数：无

返回值：无

示例：

eapp.Register("beforeClose", func() {
    // 退出前清理资源
    sqlitelib.CloseDatabase()
})

// 手动触发退出（通常由信号监听器自动调用）
eapp.Close()

参见：Register()

---

ReadPackage()

说明：读取 Electron 的 package.json 文件内容。根据运行环境选择不同的读取策略：开发模式下优先从项目目录读取；生产模式下根据静态资源配置决定是从嵌入文件系统还是外部文件读取。如果文件不存在，则抛出异常并退出。

参数：无

返回值：map[string]any — package.json 的完整内容，包括 name、version 等字段

示例：

pkg := eapp.ReadPackage()
appName := pkg["name"].(string)
appVersion := pkg["version"].(string)
fmt.Printf("App: %s v%s\n", appName, appVersion)

参见：econfig.GetStatic(), estatic.ReadJsonStrict()

---

Register(eventName, handler, args...)

说明：注册生命周期事件钩子函数。目前仅支持 beforeClose 事件。注册的函数在进程退出时被调用，可用于释放资源（关闭数据库、停止后台任务等）。如果注册不支持的事件名称，会输出警告日志并忽略注册。

参数：

参数	类型	必填	说明
eventName	string	是	事件名称，目前仅支持 "beforeClose"
handler	interface{}	是	钩子函数，参数类型必须与 args 匹配
args	...interface{}	否	传递给 handler 的参数，可为空

返回值：无

示例：

// 无参数注册
eapp.Register("beforeClose", func() {
    sqlitelib.CloseDatabase()
    fmt.Println("数据库已关闭")
})

// 带参数注册
eapp.Register("beforeClose", func(msg string) {
    fmt.Println("正在退出:", msg)
}, "goodbye")

参见：Close(), Staff

---

Staff

说明：事件钩子的内部数据结构，存储已注册的事件名称、反射值形式的处理函数及其参数。

字段	类型	说明
Name	string	事件名称
Handler	reflect.Value	处理函数的反射值
Args	[]interface{}	传递给处理函数的参数列表

---

Events

说明：支持的事件名称列表，目前包含 "beforeClose"。

类型：[]string

---

BeforeCloseFlag

说明：beforeClose 事件的常量标识符，值为 "beforeClose"。

类型：string