扩展字段

控制NW.js应提供的功能及如何打开主窗口.

nodejs

属性:是否支持Node

  • Boolean - false时将禁用Node.

node-main

属性:指定Node.js脚本文件路径 . 并且它将在加载DOM窗口之前启动Node环境时执行

  • String - Node.js脚本文件路径

domain

属性:指定主机域名

  • String - 在 chrome-extension://协议URL指定主机域名 . WEB引擎将是应用和同一域名的网站之间共享cookie

single-instance

属性:是否以单实例运行

  • Boolean - true即单实例运行, false则允许应用多开,默认 true

bg-script

属性:后台脚本

  • String - 应用启动时执行的后台脚本 .

window

属性:窗体样式控制

webkit

属性:WebKit特性控制

user-agent

属性:重写应用请求页面中的 User-Agent信息

  • String - 重写的 User-Agent信息

以下变量内容可以动态设置 User-Agent内容:

  • %name: 替换配置文件中的name字段 .
  • %ver: 替换配置文件中的version字段 .
  • %nwver: 替换NW.js版本 .
  • %webkit_ver: 替换WebKit引擎版本 .
  • %osinfo: 替换系统以及CPU信息 .

node-remote

属性:从远程页面启用Node

  • Array 或 String - 数组中的各项均需遵循在Chrome扩展中使用的匹配模式

匹配模式本质上为URL , 由 http, https, file , ftp或者 '*'开始 . 其中 '*'代表匹配所有URL . 每个匹配模式由三部分组成:

基础语法:

  1. <url-pattern> := <scheme>://<host><path>
  2. <scheme> := '*' | 'http' | 'https' | 'file' | 'ftp'
  3. <host> := '*' | '*.' <any char except '/' and '*'>+
  4. <path> := '/' <any chars>

chromium-args

属性:分发应用时自定义chromium命令行参数至应用

  • String - 指定的chromium命令行参数

例如:想要禁用GPU加速视频显示,只需添加添加参数 "chromium-args" : "--disable-accelerated-video".

如果添加多个参数,则使用空格进行分割,该字段也可使用单引号括起标记.命令行详细信息,请参阅 Command-Line-Options

crash_report_url

属性:应用崩溃时,崩溃转存报告将被发送到设定的服务器

  • String - 崩溃报告服务器的URL

与Chromium浏览器发送方式相同,发送具有 multipart/form-data内容的HTTP POST请求. 理论上来讲, 任意 breakpad/crashpad 都可以处理该请求,因为 breakpad/crashpad 与NW相仿,. 请参阅 简单服务器的小案例或使用现有的simple-breakpad-server.

该请求至少包含以下字段:

  • prod - 配置文件中的 name 属性
  • ver - 配置文件中的 version 属性
  • upload_file_minidump - minidump文件的二进制内容
  • switch-n - 崩溃过程的命令行切换开关,每个切换有多个字段,其中 n从1起始.

js-flags

属性:指定JS引擎(V8)可用特性

  • String - 可用特性如打开协调代理( Harmony Proxies)以及集合( Collections):
  1. {
  2.   "name": "nw-demo",
  3.   "main": "index.html",
  4.   "js-flags": "--harmony_proxies --harmony_collections"
  5. }

inject_js_start

inject_js_end

属性:执行JavaScript代码

  • String -相对于应用程序路径的本地文件名，期望执行的JavaScript文件

inject_js_start: CSS文件执行之后 , 其他DOM或脚本运行之前 , 执行的JavaScript代码 .

inject_js_end: 页面document对象加载之后 , 触发 onload之前 , 执行的JavaScript代码 . 主要作为新窗口中 Window.open()的参数执行JavaScript代码 .

additional_trust_anchors

属性:证书作为附加可用的根证书使用 , 允许连接自签名证书或者CA签发机构颁发证书的服务

  • Array - 数多个PEM编码的证书组成的数组 , 例如 "-----BEGIN CERTIFICATE-----\n...certificate data...\n-----END CERTIFICATE-----\n"

dom_storage_quota

属性:Mb为单位的DOM存数限制数量

  • Integer - 建议设置为期望值的两倍