VirtualView Tools 使用手册

1. 项目目录结构及介绍

VirtualView Tools 是阿里巴巴开发的一个用于编译XML模板成二进制数据的工具库，适用于提升Android应用UI的动态化和性能。以下是该项目的基本目录结构概述：

.
├── config.properties              # 配置文件，定义了控件ID和属性值类型
├── templatelist.properties        # 模板列表文件，列出了所有待编译的XML模板文件
├── build                          # 编译后输出的目录，包括编译成果(out文件)
├── TemplateWorkSpace               # 工作空间根目录
│   ├── template                    # 源码XML模板文件夹
│   ├── compiler.jar                # 执行编译任务的可执行jar文件
│   └── buildTemplate.sh            # 执行编译脚本，用于运行编译任务
├── README.md                       # 项目的主要说明文档，包含了快速开始的指引
└── LICENSE                         # 项目的MIT开源许可证文件

• config.properties 和 templatelist.properties 是核心配置文件，分别控制着控件属性配置以及需要编译的XML模板文件列表。
• compiler.jar 是核心编译器，通过这个jar文件可以执行XML模板到二进制的转换过程。
• buildTemplate.sh 是bash脚本，用于简化编译过程，一键编译所有的XML模板。

2. 项目的启动文件介绍

buildTemplate.sh

该脚本是项目的核心启动文件，位于TemplateWorkSpace目录下，主要用于执行编译逻辑。通过运行此脚本，开发者无需手动调用Java命令或指定复杂参数，即可完成从XML模板到二进制文件(.out)的转换。执行方式很简单，在终端中切换到脚本所在目录并执行以下命令：

sh buildTemplate.sh

脚本会自动调用compiler.jar对所有列出的XML模板进行编译，并将结果保存到build目录下。

3. 项目的配置文件介绍

config.properties

包含关键的配置项，用于指定各个控件的ID与对应的属性值类型。每一行通常格式为<widget_id>=<value_type>，这一步是确保编译器在处理XML时能正确识别和处理控件属性的关键。

templatelist.properties

这个文件列举了所有待编译的XML模板文件名，每行一个文件名，不需要扩展名。项目在编译时会依据这些列出的文件来执行编译任务。例如：

splash_screen.xml
product_detail.xml

以上就是关于VirtualView Tools项目的基本目录介绍、启动文件及配置文件的简要说明。通过理解这些基础元素，开发者能够更顺利地集成和利用该工具进行高效的UI模板编译工作。