首页
/ Neutralinojs v6.1.0 发布:原生窗口菜单与全局变量增强

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

2025-06-08 08:53:26作者:裴锟轩Denise

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.binaryVersion6.1.0
  2. 运行 neu update 命令获取新版本

技术价值分析

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

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

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

登录后查看全文
热门项目推荐
相关项目推荐