NW.js应用对象(App)全面解析：从命令行参数到系统热键

NW.js应用对象(App)全面解析：从命令行参数到系统热键

nw.js Call all Node.js modules directly from DOM/WebWorker and enable a new way of writing applications with all Web technologies. 项目地址: https://gitcode.com/gh_mirrors/nw/nw.js

前言

在NW.js开发桌面应用时，App对象是一个核心API，它提供了对应用程序生命周期的全面控制能力。本文将深入解析App对象的各项功能，帮助开发者更好地掌握NW.js应用的底层控制。

命令行参数处理

获取过滤后的参数(App.argv)

当用户启动NW.js应用时，可能会附带各种命令行参数。其中部分参数是NW.js自身使用的(如--nwapp)，开发者通常不需要关心这些参数。

App.argv会智能过滤掉这些内部参数，只返回与应用业务逻辑相关的参数。例如：

// 假设启动命令是：nw.exe --nwapp=./app --width=800 --height=600
console.log(App.argv); 
// 可能输出：['--width=800', '--height=600']

获取完整参数(App.fullArgv)

如果需要获取完整的命令行参数(包括NW.js内部使用的参数)，可以使用App.fullArgv。

自定义过滤规则(App.filteredArgv)

NW.js默认会过滤掉以下模式的参数：

[
  /^--url=/,
  /^--remote-debugging-port=/,
  /^--renderer-cmd-prefix=/,
  /^--nwapp=/
]

开发者可以修改这个数组来自定义过滤规则。

应用路径管理

启动路径(App.startPath)

App.startPath返回应用启动时的目录路径。值得注意的是，NW.js启动后会自动将当前工作目录切换到应用包文件所在的目录。

数据存储路径(App.dataPath)

App.dataPath返回应用在用户目录中的数据存储路径，这个路径在不同操作系统中有不同表现：

• Windows: %LOCALAPPDATA%/<应用名称>
• Linux: ~/.config/<应用名称>
• macOS: ~/Library/Application Support/<应用名称>/Default

这里的<应用名称>取自package.json中的name字段。

应用缓存管理

清除HTTP缓存(App.clearCache)

App.clearCache();

这个方法会同步清除内存和磁盘中的HTTP缓存，适用于需要强制刷新网络资源的场景。

清除应用缓存(App.clearAppCache)

App.clearAppCache(manifest_url);

通过指定manifest文件的URL，可以将对应的应用缓存标记为过期状态。

应用生命周期控制

优雅关闭应用(App.closeAllWindows)

与直接退出不同，closeAllWindows会向所有窗口发送close事件，给窗口机会执行清理工作(如保存数据)。只有当所有窗口都完成关闭操作后，应用才会真正退出。

强制退出应用(App.quit)

App.quit();

这个方法会立即终止应用，不会触发任何关闭事件，适用于需要强制退出的场景。

进程崩溃测试

NW.js提供了两个特殊方法来测试崩溃处理机制：

App.crashBrowser();  // 使浏览器进程崩溃
App.crashRenderer(); // 使渲染进程崩溃

这些方法主要用于开发和测试阶段，验证应用的崩溃恢复能力。

组件管理(实验性功能)

NW.js支持动态加载组件，目前主要支持Widevine组件：

// 启用组件
App.enableComponent('WIDEVINE', function(version) {
  console.log('组件版本:', version);
});

// 更新组件
App.updateComponent('WIDEVINE', function(success) {
  if(success) console.log('更新成功');
});

代理设置

查询代理(App.getProxyForURL)

const proxy = App.getProxyForURL('https://example.com');
// 可能返回："PROXY proxy.example.com:8080"

配置代理(App.setProxyConfig)

NW.js支持两种代理配置方式：

1. 直接指定代理规则：

App.setProxyConfig("http=foopy:80;ftp=foopy2");

2. 使用PAC脚本自动检测：

App.setProxyConfig("", "http://example.com/proxy.pac");

代理规则语法非常灵活，支持多种配置方式，包括故障转移和协议特定代理等高级功能。

跨域访问控制

NW.js提供了细粒度的跨域访问控制：

// 允许github.com访问应用资源
App.addOriginAccessWhitelistEntry(
  'http://github.com/', 
  'chrome-extension', 
  location.host, 
  true
);

// 移除访问权限
App.removeOriginAccessWhitelistEntry(
  'http://github.com/', 
  'chrome-extension', 
  location.host, 
  true
);

全局热键管理

NW.js允许注册系统级全局热键：

// 创建快捷键对象
const shortcut = new nw.Shortcut({
  key: "Ctrl+Shift+A",
  active: function() {
    console.log("快捷键触发");
  }
});

// 注册全局热键
App.registerGlobalHotKey(shortcut);

// 注销热键
App.unregisterGlobalHotKey(shortcut);

事件处理

文件关联打开事件(open)

当应用与特定文件类型关联，用户双击文件时会触发：

App.on('open', function(args) {
  console.log('打开文件:', args);
});

macOS专属事件(reopen)

在macOS上，当用户点击已在运行的应用的Dock图标时触发：

App.on('reopen', function() {
  console.log('用户点击了Dock图标');
});

总结

NW.js的App对象提供了对应用程序全方位的控制能力，从基本的命令行参数处理到高级的系统热键管理。掌握这些API可以帮助开发者构建更专业、更稳定的桌面应用。需要注意的是，部分功能(如组件管理)仍处于实验阶段，使用时需谨慎评估稳定性。

nw.js Call all Node.js modules directly from DOM/WebWorker and enable a new way of writing applications with all Web technologies. 项目地址: https://gitcode.com/gh_mirrors/nw/nw.js