一些配置參數(shù)需要在瀏覽器環(huán)境創(chuàng)建之前進(jìn)行處理，或者是需要傳給瀏覽器對(duì)象進(jìn)行初始化。所以參考 Chrome 擴(kuò)展的模式，heX 中也引入了清單文件。清單文件為一個(gè)名為 manifest.json 的 JSON 格式文本文件，里面包含了眾多配置項(xiàng)。

heX 的主程序 - hexclient 在啟動(dòng)時(shí)讀入并解析清單文件，若讀取或解析出錯(cuò)，主程序都將退出。

簡(jiǎn)要說(shuō)明

{
    "first_page": "chrome://version",       // 首頁(yè)，可以是 URL 或者一個(gè)本地文件路徑
    "application_title": "Hello heX!",      // 程序默認(rèn)標(biāo)題，alert 等窗口使用
    "application_shortname": "test",        // 應(yīng)用程序別名
    "use_grit_package": true,               // 使用打包資源
    "icon_path": "",                        // 程序默認(rèn)圖標(biāo)路徑
    "use_node": true,                       // 是否開(kāi)啟 Node.js
    "version": "1.0",                       // 程序版本信息
    "locale": "zh-CN",                      // 瀏覽器區(qū)域設(shè)置
    "multiple_process": false,              // 是否為多進(jìn)程模式
    "launch_node_in_all_pages": false,      // 在打開(kāi)的所有頁(yè)面中使用 Node.JS
    "load_node_manually": false,            // 是否手動(dòng)加載 Node.js
    "disable_async_node_apis": false,       // 是否禁用 Node.JS 異步 API
    "remote_debugging_port": 65432,         // 遠(yuǎn)程調(diào)試端口
    "disable_debug_log": true,              // 是否禁止生成 Chromium 調(diào)試信息
    "quit_after_main_window_closed": false, // 是否在主窗口關(guān)閉后退出
    "cache_path": "data",                   // 緩存路徑
    "npapi_plugin_directory": "",           // NPAPI 插件路徑
    "disable_ime_composition": false,       // 禁用 IME composition
    "extensions": [                         // heX 擴(kuò)展名稱列表
      "hex_dialog",
      "hex_sleep",
      "hex_shortcut"
    ],
    "extension_path": "",                   // heX 擴(kuò)展的路徑
    "single_instance": true,                // 是否為單一實(shí)例模式
    "window_class_name": "A_HEXCLIENT",     // 主窗口類名
    "form": {
        "style": "captionless",             // 窗口類型：標(biāo)準(zhǔn)、無(wú)標(biāo)題、桌面 Widget
        "plain": false,                     // 是否為扁平窗口
        "system_buttons": true,             // 是否顯示默認(rèn)的系統(tǒng)控制按鈕
        "transmission_color": "none",       // 穿透顏色
        "transparent_browser": true,        // 是否為透明瀏覽器
        "fixed": false,                     // 窗體是否可以調(diào)整大小
        "disable_form_apis": false,         // 是否禁用所有窗口相關(guān) API
        "opacity": "none",                  // 窗口透明度
        "hook_system_command": false,       // 是否攔截窗口的系統(tǒng)命令
        "launch_state": "normal",           // 啟動(dòng)初始狀態(tài)
        "launch_width": 800,                // 啟動(dòng)初始寬度
        "launch_height": 600,               // 啟動(dòng)初始高度
        "launch_x": "screen_centered",      // 啟動(dòng)初始 X 軸位置
        "launch_y": "screen_centered",      //  啟動(dòng)初始 Y 軸位置
        "min_width": 0,                     // 最小寬度
        "min_height": 0,                    // 最小高度
        "max_width": 0,                     // 最大寬度
        "max_height": 0,                    // 最大高度
        "border_width": 5                   // 模擬邊框區(qū)域?qū)挾?    },
    "browser": {
        "no_proxy_server": false,
        "winhttp-proxy-resolver": false,
        "disable_gpu": true,
        "disable_3d_apis": false,
        "disable_databases": false,
        "disable_experimental_webgl": false,
        "disable_file_system": false,
        "disable_geolocation": false,
        "disable_gpu_process_prelaunch": true,
        "disable_java": false,
        "disable_javascript": false,
        "disable_javascript_i18n_api": false,
        "disable_local_storage": false,
        "disable_logging": false,
        "disable_plugins": false,
        "disable_renderer_accessibility": false,
        "disable_session_storage": false,
        "disable_speech_input": false,
        "disable_web_sockets": false,
        "in_process_gpu": false,
        "in_process_plugins": false,
        "enable_media_stream": true,
        "web_security_disabled": true,
        "file_access_from_file_urls_allowed": true,
        "universal_access_from_file_urls_allowed": true
    }
}

詳細(xì)說(shuō)明

• first_page：$(AppDir) 代表當(dāng)前程序路徑（包含“/”），也可以是 file 協(xié)議 URL 或者本地路徑。
• application_shortname：應(yīng)用程序別名，將會(huì)影響到使用打包資源時(shí)讀取的資源包 PAK 文件名及 URL。
• use_grit_package：使用 PAK 格式的資源包。參見(jiàn)：heX 打包生成工具說(shuō)明。
• icon_path：程序默認(rèn)圖標(biāo)路徑，必須是一個(gè)本地路徑。
• use_node：設(shè)置為 true 則開(kāi)啟 Node.js，與移除 node 動(dòng)態(tài)庫(kù)效果一樣。
• launch_node_in_pages：默認(rèn)情況下，通過(guò) window.open() 彈出的子窗口中將不會(huì)啟動(dòng) Node.js，開(kāi)啟此配置項(xiàng)后則始終在彈出的子窗口中啟動(dòng) Node.js。
• load_node_manually：當(dāng)需要自定義 Node.js 啟動(dòng)時(shí)機(jī)的時(shí)候開(kāi)啟此配置項(xiàng)，這時(shí)需要在頁(yè)面中通過(guò)加入 <script></script> 標(biāo)簽或者用 JavaScript 動(dòng)態(tài)插入 node.js 文件。
• disable_async_node_apis：此時(shí) Node.js 的 event loop 將停止運(yùn)行。
• disable_debug_log：此時(shí)將不會(huì)再生成 debug.log 文件。
• quit_after_main_window_closed：默認(rèn)情況下，只有所有的瀏覽器窗口都關(guān)閉后，程序才會(huì)退出。
• npapi_plugin_directory：當(dāng)此項(xiàng)為空時(shí)會(huì)默認(rèn)使用當(dāng)前工作路徑作為 NPAPI 插件加載路徑。
• disable_ime_composition：開(kāi)啟后將禁用輸入法輸入時(shí)的 Composition String，參見(jiàn)：http://msdn.microsoft.com/en-us/library/windows/desktop/dd317765(v=vs.85).aspx。
• extensions：列出當(dāng)前程序想要加載的 heX 擴(kuò)展名稱，以逗號(hào)分隔。若擴(kuò)展不存在或者加載錯(cuò)誤則自動(dòng)跳過(guò)。
• extension_path：指定需要加載的 heX 擴(kuò)展的路徑，若為空則使用當(dāng)前工作路徑。
• single_instance：開(kāi)啟單一實(shí)例模式后，啟動(dòng)新的實(shí)例之后會(huì)自動(dòng)激活當(dāng)前已經(jīng)啟動(dòng)的實(shí)例，并且觸發(fā) instanceCreated 事件，此配置要求 window_class_name 不為空，并且為單進(jìn)程模式。
• window_class_name：自定義主窗口的窗口類名。

• form 對(duì)象

  • style：有三種取值，不區(qū)分大小寫(xiě)：
    
    • standard：標(biāo)準(zhǔn)窗口，與系統(tǒng)主題一致。
    • captionless：無(wú)標(biāo)題欄的窗口，可以自繪標(biāo)題欄。
    • desktop_widget：桌面 Widget 窗口，將會(huì)固定在桌面上，不會(huì)隨著顯示桌面而最小化。
  • plain：開(kāi)啟此配置后窗口將以扁平化狀態(tài)呈現(xiàn)，此配置只針對(duì)非標(biāo)準(zhǔn)型窗口。對(duì)于 Windows XP，則不會(huì)顯示窗口陰影；對(duì)于 Windows Vista 及更新的系統(tǒng)，則不會(huì)顯示 Aero 效果（再系統(tǒng)支持及開(kāi)啟 Aero 的情況下）。
  • system_button：對(duì)于支持 Aero 的 Windows，開(kāi)啟此配置項(xiàng)后，將會(huì)始終顯示 Aero 框架所帶的最小化、最大化、關(guān)閉控制按鈕。此配置項(xiàng)僅在支持 Aero 的 Windows、開(kāi)啟了 transparent_browser 及 style 不為 standard 的情況下可以看到效果。
  • transmission_color：穿透顏色可能有兩類取值，none 表示關(guān)閉，#RRGGBB 表示一個(gè) HTML 的顏色值，如 #0000FF，也支持簡(jiǎn)寫(xiě) #666，屬性值不區(qū)分大小寫(xiě)。瀏覽器窗口中遇到穿透顏色所指的顏色值時(shí)將不再響應(yīng)鼠標(biāo)事件，直接穿透到其下方的窗口，并且在視覺(jué)上可以直接看到下方的窗口。此配置項(xiàng)可以制作不規(guī)則窗口。
  • transparent_browser：對(duì)于支持并且開(kāi)啟了 Aero 的 Windows 系統(tǒng)，開(kāi)啟此配置項(xiàng)后，整個(gè)瀏覽器區(qū)域?qū)⒆優(yōu)橥该?。但需?HTML 元素的背景色為透明時(shí)才能看到效果。
  • fixed：開(kāi)啟此配置項(xiàng)后窗口將不能被調(diào)整大小。
  • opacity：透明度可能有兩類取值，none 表示關(guān)閉，0-255 的整數(shù)值表示 透明 到 不透明。
  • launch_state：?jiǎn)?dòng)的初始狀態(tài)可能有下面幾種取值：
    
    • normal 表示默認(rèn)
    • minimized 表示最小化狀態(tài)
    • maximized 表示最大化狀態(tài)
    • hidden 表示隱藏狀態(tài)
    • fullscreen 表示全屏狀態(tài)
  • launch_width：?jiǎn)?dòng)的初始寬度值可能有下面兩種取值：
    
    • system_default 表示采用系統(tǒng)默認(rèn)的寬度
    • 整數(shù)值 表示像素為單位的寬度值
  • launch_height：?jiǎn)?dòng)的初始高度值可能有下面兩種取值：
    
    • system_default 表示采用系統(tǒng)默認(rèn)的高度
    • 整數(shù)值 表示像素為單位的高度值
  • launch_x：?jiǎn)?dòng)的初始 X 軸位置可能有下面幾種取值：
    
    • system_default 表示采用系統(tǒng)默認(rèn)的 X 軸位置
    • parent_centered 表示相對(duì)父窗口水平居中
    • screen_centered 表示相對(duì)屏幕水平居中
    • 整數(shù)值 表示像素為單位的 X 軸位置
  • launch_y：?jiǎn)?dòng)的初始 Y 軸位置可能有下面幾種取值：
    
    • system_default 表示采用系統(tǒng)默認(rèn)的 Y 軸位置
    • parent_centered 表示相對(duì)父窗口垂直居中
    • screen_centered 表示相對(duì)屏幕垂直居中
    • 整數(shù)值 表示像素為單位的 Y 軸位置
  • min_width：窗口的最小寬度，單位為像素，0 代表無(wú)限制
  • min_height：窗口的最小高度，單位為像素，0 代表無(wú)限制
  • max_width：窗口的最大寬度，單位為像素，0 代表無(wú)限制
  • max_height：窗口的最大高度，單位為像素，0 代表無(wú)限制
  • border_width：在為標(biāo)準(zhǔn)窗口模式下，模擬出來(lái)的邊框區(qū)域?qū)挾龋诖藢挾戎畠?nèi)可以調(diào)整窗口的大小

• browser 對(duì)象

  • browser 對(duì)象中的各項(xiàng)與 Chromium 以及 Blink 的開(kāi)關(guān)保持一致，true 表示使用開(kāi)關(guān)。請(qǐng)參見(jiàn)：http://peter.sh/experiments/chromium-command-line-switches/。