API 参考

jadeview.Init(
    enableDevmod bool,     // 是否启用开发者工具
    logPath string,        // 日志文件路径（可空字符串）
    dataDir string,        // 数据根目录（可空字符串）
    appName string,        // 应用显示名称，必填、非纯空白
    appSignature string,   // 应用唯一标识，trim 后 ≥6 个 Unicode 字符；
                           // 建议反域名格式（如 com.example.myapp）——
                           // JAPK 模式下它会成为 JADE:// URL 的主机名
    singleInstance bool,   // 是否单实例模式
) bool

jadeview.CreateWindow(
    url string,                    // 初始地址（http(s):// 或 jade:// 等自定义协议）
    parentID uint32,               // 父窗口 ID，0 = 顶级窗口
    opts *jadeview.WindowOptions,  // 窗口选项，nil = DefaultWindowOptions()
    settings *jadeview.WebViewSettings, // WebView 设置，nil = 库内部默认
) uint32  // window_id（>0 成功，0 失败）

jadeview.CreateBorderlessWindow(url string, settings *WebViewSettings) uint32

jadeview.On(
    event string,                  // 事件名（见下方事件常量表）
    handler jadeview.EventHandler, // func(windowID uint32, data string) string
) (uint32, bool)  // (callback_id, 是否成功)；callback_id 用于 Off

jadeview.Off(event string, cbID uint32) bool

jadeview.RegisterIPCHandler(channel string, handler jadeview.EventHandler) bool

jadeview.SendIPCMessage(windowID uint32, messageType, messageContent string) bool

// type PermissionHandler func(windowID uint32, data string) bool   // 返回 true = 允许
jadeview.SetWebviewPermissionHandler(handler jadeview.PermissionHandler) bool
jadeview.ClearWebviewPermissionHandler() bool   // 对 SetWebviewPermissionHandler 传 nil 等价于注销

// 打开 / 保存文件对话框，返回结果 JSON（取消时通常为空/null）
jadeview.ShowOpenDialog(p jadeview.FileDialogParams) string
jadeview.ShowSaveDialog(p jadeview.FileDialogParams) string

// FileDialogParams 字段
type FileDialogParams struct {
    WindowID    uint32
    Title       string
    DefaultPath string
    ButtonLabel string
    Filters     string // JSON，如 `[{"name":"图片","extensions":["jpg","png"]}]`
    Properties  string // JSON 数组，元素见 DialogProp 枚举
}

// 消息框，返回结果 JSON（含点击的按钮索引）
jadeview.ShowMessageBox(p jadeview.MessageBoxParams) string

type MessageBoxParams struct {
    WindowID  uint32
    Title     string
    Message   string
    Detail    string
    Buttons   string // JSON 数组，如 `["确定","取消"]`
    DefaultID int
    CancelID  int
    Type      string // 见 MsgBoxType 枚举
}

// 错误框（简单模式）
jadeview.ShowErrorBox(windowID uint32, title, content string) bool

jadeview.ShowOpenDialogAsync(p FileDialogParams, handler DialogResultHandler) bool
jadeview.ShowSaveDialogAsync(p FileDialogParams, handler DialogResultHandler) bool
jadeview.ShowMessageBoxAsync(p MessageBoxParams, handler DialogResultHandler) bool

// type DialogResultHandler func(result string)  // result 为结果 JSON

jadeview.ShowNotification(jadeview.NotificationParams{
    Summary: "通知标题",   // 必填
    Body:    "通知正文",
    Icon:    "",           // 图标文件绝对路径
    Timeout: -1,           // 毫秒，-1 = 系统默认
    Button1: "打开",       // 按钮（可选）
    Button2: "",
    Text3:   "",           // 按钮3文本（可选）
    Action:  "open",       // 经 notification-action 事件回传
})

jadeview.TrayCreate() uint32                          // 创建托盘，返回 tray_id（0=失败）
jadeview.TrayDestroy(trayID) bool
jadeview.TraySetVisible(trayID, visible) bool
jadeview.TraySetTooltip(trayID, tooltip) bool
jadeview.TraySetIconFromFile(trayID, iconPath) bool   // 图标文件（.ico）
jadeview.TraySetIconFromData(trayID, data []byte) bool // 内存图标数据
jadeview.TraySetMenu(trayID, items []TrayMenuItem) bool // 扁平表；空切片=清除菜单

items := []jadeview.TrayMenuItem{
    {Type: jadeview.TrayItem.Normal, Key: "show", Label: "显示窗口"},
    {Type: jadeview.TrayItem.Submenu, Key: "theme", Label: "主题"},
    {Type: jadeview.TrayItem.Normal, Key: "dark", Label: "暗色", ParentKey: "theme"},
    {Type: jadeview.TrayItem.Divider, Key: "sep1"},
    {Type: jadeview.TrayItem.Normal, Key: "quit", Label: "退出", Dangerous: true},
}

jadeview.MenuItemCreate(label string, kind int, parentMenuID uint32, itemID int) uint32
// kind 见 MenuKind 枚举；itemID 点击时经 menu-item-clicked 事件回传
jadeview.MenuItemSetEnabled(menuID, enabled) bool
jadeview.MenuItemSetChecked(menuID, checked) bool
jadeview.MenuItemDestroy(menuID) bool
jadeview.SetContextMenuItems(windowID uint32, menuIDs []uint32) bool
// 在 context-menu 事件回调中调用，设置本次右键要显示的顶级菜单项

jadeview.SetProtocolServicePath(rootPath string, hotReload bool) (string, bool)