SOUI资源导入工具¶

UIResImporter 简介¶

UIResImporter是SOUI框架提供的一个命令行工具，用于自动化资源导入和管理。它可以自动生成uires.idx文件和skin.xml文件，大大简化了SOUI项目的资源管理工作。

工具功能¶

主要功能¶

自动导入资源文件到uires.idx
自动生成skin.xml中的皮肤定义
支持多种图片资源格式定义
提供资源文件的自动备份

支持的皮肤类型¶

imglist：图片列表类型
imgframe：九宫格类型

使用指南¶

命令行参数¶

uiresImporter.exe -p <uires目录> -s <更新目录> -i <图片目录> -b <是否备份> -c <是否着色>

参数说明： - -p：指定uires目录位置 - -s：指定需要在uires.idx中自动更新的文件夹，多个目录用"|"分隔 - -i：指定支持自动生成skin的图片目录 - -b：yes表示自动备份原有XML，no表示不备份 - -c：yes表示皮肤默认支持着色，no表示默认禁止着色

命令示例¶

%SOUIPATH%\tools\uiresImporter.exe -p uires -s "layout|icon|imgx" -i image -b yes -c no

文件命名规则¶

1. ImgList类型¶

格式：filename[count].png - count：子图数量 - 示例：btn_login[3].png表示按钮有3种状态

2. ImgFrame类型（九宫格）¶

完整格式¶

格式：filename[state{left,top,right,bottom}].png - state：状态数 - left,top,right,bottom：九宫格的切分尺寸 - 示例：bg_login[1{2,40,2,10}].png

简化格式¶

格式：filename[state{width,height}].png - 适用于上下及左右大小相同的情况 - 示例：bg_login[1{2,5}].png

3. 扩展参数¶

在基本格式后可添加以下可选参数：

参数	格式	说明
ec	{ec=0/1}	是否支持皮肤着色
fit	{fit=0/1}	自适应绘图标志
tile	{tile=0/1}	平铦标志
filter	{filter=0/½/3}	插值滤镜类型
vert	{vert=0/1}	子图垂直排列标志

最佳实践¶

1. 文件组织¶

按功能分类组织资源文件
使用清晰的命名规则
保持资源目录结构整洁

2. 命名规范¶

使用有意义的文件名
清晰标注状态数量和切分尺寸
合理使用扩展参数

3. 资源管理¶

定期备份资源文件
合理规划资源目录结构
及时清理未使用的资源

常见问题¶

1. 资源导入失败¶

检查文件命名格式是否正确
验证目录路径是否存在
确认文件权限设置

2. 皮肤生成错误¶

检查九宫格参数是否合理
确认图片文件格式正确
验证状态数量设置

3. 更新问题¶

使用备份功能防止意外
检查XML文件的正确性
注意资源编译更新

注意事项¶

命名规范
严格按照规定格式命名
注意参数的顺序和格式
使用英文字符和数字
资源编译
导入后需要重新生成.rc2文件
使用uiresbuilder更新资源
检查资源是否正确编译
参数使用
ImgFrame参数顺序固定
扩展参数在基本参数后
注意参数值的有效范围

进阶用法¶

1. 批处理脚本¶

创建批处理文件简化操作：

@echo off
set SOUIPATH=D:\SOUI
echo 开始导入资源...
%SOUIPATH%\tools\uiresImporter.exe -p uires -s "layout|icon|imgx" -i image -b yes -c no
if errorlevel 1 (
    echo 资源导入失败！
    pause
    exit /b 1
)
echo 资源导入完成！
pause

2. 持续集成¶

在构建流程中集成资源导入：

设置资源导入为构建前置步骤
自动化资源的备份和更新
添加资源完整性检查

3. 自定义扩展¶

根据项目需求扩展功能：

创建自定义的命名规则
添加特殊的处理逻辑
集成其他工具链