API 参考

逻辑型 初始化 (
    调试模式,     // 逻辑型，默认 假——是否启用 DevTools、调试快捷键等开发向能力
    日志路径,     // 文本型，默认 ""——日志文件路径；空 = 不写日志
    数据目录,     // 文本型，默认 ""——数据根目录；空 = 自动选择
    应用名,       // 文本型——应用显示名称（关于对话框、通知等使用）
    应用标识,     // 文本型——唯一标识，建议 ≥6 字符反域名格式；
                  // 用于数据目录、单实例管道，JAPK 模式下是 JADE:// 主机名
    单实例        // 逻辑型，默认 真——再次启动会把命令行转发给首实例（触发 第二实例 事件）
)

整数 运行消息循环 ()

逻辑型 退出程序 ()

文本型 取版本 ()         // JadeView 版本字符串（含构建号），静态方法
文本型 取WebView版本 ()   // WebView2 运行时版本号

整数 创建窗口 (
    地址,        // 文本型——初始地址（http(s):// 或协议服务返回的本地地址）
    父窗口ID,    // 整数，默认 0——0 = 顶层窗口
    窗口选项,    // JadeWindowOptions，默认 空对象
    视图设置     // JadeViewOptions，默认 空对象
)
// 返回 window_id（>0 成功，0 失败——如在 应用就绪 之前调用）

整数 创建无边框窗口 (地址, 视图设置)

文本型 置协议服务目录 (
    根目录,     // 文本型，默认 ""——前端目录 / .japk 路径；空 = 服务已从内存加载的 JAPK
    热载模式    // 逻辑型，默认 假——仅文件系统模式有效：改文件即时刷新页面（150ms 防抖）
)
// 返回可直接传给 创建窗口 的本地资源地址

文本型 注册安全资源 (窗口ID, 本地目录, 过期时长)
// 窗口ID：0 = 全局；过期时长：秒，0 = 永不过期。成功返回 jade:// 地址，失败返回空文本
逻辑型 注销安全资源 (令牌或路径)

整数   订阅事件 (事件名称)     // 返回回调 id；重复订阅返回已有 id
逻辑型 注销订阅事件 (事件名称)  // 仅影响当前对象的订阅

Jade.订阅事件 (订阅_视图事件.请求新窗口)
Jade.订阅事件 (订阅_视图事件.文件拖放)

逻辑型 置IPC频道回调 (对象实例, 方法)
// 对象实例：填 本对象；方法：回调方法的输出名（立即数或常量）
逻辑型 注册IPC通道 (通道名)    // 重复注册同一通道直接返回真
逻辑型 注销IPC通道 (通道名)
逻辑型 清除IPC频道回调 ()

方法 IPC频道消息 <公开 类型 = 文本型 @强制输出 = 真 @输出名 = "ipcChannelMessageCallback">
参数 通道名 <类型 = 文本型>
参数 窗口ID <类型 = 整数>
参数 数据 <类型 = 文本型>
{
    返回 ("")   // 空文本 = 不回传；非空 = 应答给前端 jade.invoke 的 Promise
}

整数 发送IPC消息 (窗口ID, 事件名称, 消息内容)
// 前端 jade.on('事件名称', payload => ...) 接收

文本型 打开文件对话框 (窗口ID, 标题, 默认路径, 按钮文本, 过滤器, 属性文本)
文本型 保存文件对话框 (窗口ID, 标题, 默认路径, 按钮文本, 过滤器)
文本型 消息框 (窗口ID, 标题, 正文, 详情, 按钮列表, 默认按钮索引, 取消按钮索引, 类型名)
整数   显示错误框 (窗口ID, 标题, 内容)
逻辑型 打开关于对话框 (窗口ID)   // 应用名取自 初始化，图标取窗口当前图标

逻辑型 显示打开文件对话框_异步 (窗口ID, 标题, 默认路径, 按钮文本, 过滤器, 属性文本, 对象实例, 方法)
逻辑型 显示保存文件对话框_异步 (窗口ID, 标题, 默认路径, 按钮文本, 过滤器, 对象实例, 方法)
逻辑型 显示消息框_异步 (窗口ID, 标题, 正文, 详情, 按钮列表, 默认按钮索引, 取消按钮索引, 类型名, 对象实例, 方法)

方法 对话框结果 <公开 类型 = 整数 @强制输出 = 真 @输出名 = "dialogBoxCallback">
参数 数据文本 <类型 = 文本型>
{
    调试输出 (数据文本)
    返回 (0)
}

逻辑型 显示通知 (参数对象)   // JadeNotificationOptions

整数   注册全局热键 (修饰键, 键码)   // 成功返回热键 id（>0），失败 0
逻辑型 注销全局热键 (热键ID)

逻辑型 创建 ()                       // 已创建过直接返回真
逻辑型 销毁 ()
逻辑型 置可见 (可见)
逻辑型 置提示 (提示内容)              // 鼠标悬停提示
逻辑型 置图标 (图标路径)              // .ico 文件
逻辑型 置图标2 (图标数据)             // 字节集（ICO/PNG 内容），无需临时文件

整数   添加菜单项 (菜单类型, 键名称, 显示名称, 父键名称, 禁止, 风险项目)
// 菜单类型：托盘菜单项类型.普通项 / .子菜单 / .分隔线 / .分组
// 键名称：业务主键，整表唯一（分隔线也要唯一 key），点击经 托盘菜单命令事件 按它分派
逻辑型 置菜单禁止 (键名称, 是否禁止)
逻辑型 置菜单危险 (键名称, 是否危险)   // 风险项（如「退出」标红）
逻辑型 置菜单标题 (键名称, 显示标题)
逻辑型 删除菜单 (键名称)
逻辑型 清空菜单 ()

整数   创建 (显示名称, 菜单类型, 父菜单ID, 菜单ID)
// 菜单类型：菜单类型.命令 / .复选框 / .单选 / .分隔线 / .子菜单 / .默认菜单项
// 默认菜单项（kind=5）：显示名称填 原生菜单项 常量（如 原生菜单项.复制），
//   由 WebView2 执行原生操作，不触发 自定义菜单事件
// 菜单ID：自定义 id，点击经 自定义菜单事件 回传（默认菜单项忽略）
// 返回 menu_id（0 = 失败）
逻辑型 置启用 (菜单ID, 是否启用)
逻辑型 置选中 (菜单ID, 是否选中)      // 复选框 / 单选项
逻辑型 置显示 (窗口ID, 菜单ID数组)    // 在 菜单事件回调 中调用，参数为整数数组类
逻辑型 销毁 (菜单ID)                 // 销毁菜单项及其子项

变量 数据解构 <类型 = json_object>
如果真 (数据解构.创建自文本 (数据))
{
    变量 名字 <类型 = 文本型>
    名字 = 数据解构.取文本 ("user.name", "")        // 也支持 "/user/name" JSON Pointer

    变量 应答 <类型 = json_object>
    应答.置逻辑 ("success", 真)
    应答.置文本 ("echo", 名字)
    返回 (应答.到文本 ())
}