heX 打包生成工具说明.pdfVIP

heX 打包⽣成⼯具说明 ⾃ v 1.1.10 版本开始，heX ⽀持将 web 前端资源打包 （⾮压缩）。我们借助 Chromium 项⽬中的 GRIT ⼯具 ⾏资源打包。因此，打包过程中需要 Python 2.6 或更新版本的 ⽀持。 ⼯具位于 Release/tools ⽂件夹中，make_grd 的⼊⼜为 make_grd.py，grit 的⼊⼜为 grit/grit.py。 打包⽣成分为两部分，其中第⼀部分可以通过 heX 提供的⾃动化⼯具⽣成，也可以⼿ 动⽣成。 1. make_grd make_grd ⼯具是⼀段⽤ Python 写的脚本。它的作⽤是根据⽬标⽂件夹下的⽂件系统 结构⽣成⼀个资源列表⽂件，扩展名为 .grd，本质上为⼀个 XML ⽂件。⾥⾯包含以 下重要信息： /grit/outputs/output[filename=web_resources.j son] ：⽣成供 heX 读取的 JSO 版资源⽂件列表。此⽂件名必须为 web_resources.json，不可改变。 /grit/outputs/output[filename=*.pak] ：⽣成供 heX 读取的打包后的 PAK 格式的 资源⽂件。所有的 web 前端资源都将打包到此⽂件中。此⽂件名默认为 web_resources.json，也可以是其他⽂件名，这取决于清单⽂件中的 application_shortname 配置项。 /grit/release/includes/include ：include 元素包含了三个重要属性， file 属性指定了⽂件名以及其相对路径，此路径是相对于上⾯的⽬标⽂件 夹。 name 属性为此⽂件指定⼀个名称，不可重复。 type 属性为此⽂件类型，⼀般为扩展名，若没有扩展名则⾃动转换为 BI DATA 。 make_grd ⼯具的调⽤⽅法很简单，默认情况下必须指定 path 参数： python tools/make_grd.py --path=web 这样，⼯具就会试图遍历当前⼯作路径下的 web ⽂件夹内的所有⽂件及⼦⽂件夹，并 在当前⼯作路径下⽣成⼀个 web_resources.grd ⽂件。 也可以指定⽣成的 GRD ⽂件的⽂件名，以及 GRD ⽂件中输出的 PAK ⽂件的⽂件 名。--output 指定输出的 GRD ⽂件，--pak 指定输出的 GRD ⽂件中指定的 PAK ⽂件 名，如：python tools/make_grd.py --path=web --output=web.grd -- pak=test.pak 最终可能会⽣成如下 GRD ⽂件： ?xml version=1. encoding=utf-8? grit current_release=1 latest_public_release= outputs output filename=web_resources.json type=rc_header emit emit_type=prepend/ /output output filename=test.pak type=data_package/ /outputs release seq=1 includes include file=index .html name=INDEX_HTML type=html/ /release /grit 当然我们可以⾃⼰⼿动⽣成这个⽂件。 . grit grit ⼯具全称 Google Resource and Internationalization Tool ，是 Chromium 项⽬的⼀部 分。我们对 GRIT ⾏了轻度的改装，以使它可以⽣成出我们需要的 web_resources.j son 。调⽤⽅法： ⾸先确定要打包的⽂件夹，如 /Users/admin/dev/test，将上⼀步的 GRD ⽂件复制到这 个⽂件夹中。执⾏ python tools/grit/grit.py -i /Users/admin/dev/test/web_resources.grd build -o web 。 上⾯这段命令的意思是，读取 /Users/admin/d