Neutralinojs v6.1.0 发布：原生窗口菜单与全局变量增强

Neutralinojs 是一个轻量级的跨平台桌面应用开发框架，它允许开发者使用 HTML、CSS 和 JavaScript 等 Web 技术构建原生应用。与 Electron 不同，Neutralinojs 不需要捆绑完整的浏览器引擎，而是使用操作系统的原生 Web 视图控件，这使得应用体积更小、启动更快。

原生窗口主菜单功能

本次发布的 v6.1.0 版本带来了备受期待的原生窗口主菜单功能。开发者现在可以通过 window.setMainMenu(menu) API 在 GNU/Linux 和 Windows 上创建原生窗口菜单，在 macOS 上创建应用菜单。

基本用法

菜单结构通过 JavaScript 数组定义，支持多级嵌套：

const menu = [
  {
    id: 'file', 
    text: '文件',
    menuItems: [
      {id: 'open', text: '打开'},
      {text: '-'},  // 分隔符
      {id: 'quit', text: '退出'}
    ]
  },
  {
    id: 'edit',
    text: '编辑',
    menuItems: [
      {id: 'cut', text: '剪切'},
      {id: 'copy', text: '复制'},
      {id: 'paste', text: '粘贴'}
    ]
  }
];

await Neutralino.window.setMainMenu(menu);

事件处理

当用户点击菜单项时，框架会触发 mainMenuItemClicked 事件，开发者可以通过监听此事件来处理菜单操作：

Neutralino.events.on('mainMenuItemClicked', (data) => {
  console.log('点击的菜单项:', data);
});

平台特性差异

1. macOS 特有功能：

   • 支持预定义动作（如 cut:、copy:、paste:）
   • 支持快捷键绑定（如 shortcut: 'x'）
   • 应用菜单显示在屏幕顶部

2. Windows/Linux：

   • 目前仅显示快捷键提示（如 shortcut: 'Ctrl+C'）
   • 菜单附加到窗口顶部

注意：GNU/Linux 和 Windows 平台的全局快捷键支持将在未来版本中添加。

新增全局变量

v6.1.0 引入了两个实用的全局变量：

1. NL_LOCALE：

   • 获取用户区域设置（如 zh_CN.UTF-8）
   • 可用于国际化适配

2. NL_COMPDATA：

   • 支持在编译时嵌入自定义数据
   • 通过 BuildZri 配置注入
   • 典型用途：构建编号、编译器信息等

"definitions": {
    "*": [
        "NEU_COMPILATION_DATA=\\\"build_number=${BZ_BUILDNUMBER};compiler_name=${BZ_COMPILERNAME}\\\""
    ]
}

升级指南

现有项目升级非常简单：

1. 修改配置文件中的 cli.binaryVersion 为 6.1.0
2. 运行 neu update 命令获取新版本

技术价值分析

本次更新为 Neutralinojs 带来了更接近原生应用的体验：

1. 菜单系统填补了框架在桌面应用传统交互方式上的空白
2. 跨平台一致性处理得当，尊重各平台UI规范
3. 编译时数据注入为持续集成/部署流程提供了更多可能性
4. 轻量化优势保持良好，新增功能不会显著增加包体积

对于需要开发轻量级跨平台桌面应用的前端开发者，Neutralinojs v6.1.0 提供了更完善的解决方案，特别是在需要系统菜单和构建信息管理的场景下表现出色。