SOUI资源导入工具¶

UIResImporter 简介¶

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

工具功能¶

主要功能¶

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

支持的皮肤类型¶

1. imglist：图片列表类型
2. 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. 扩展参数¶

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

最佳实践¶

1. 文件组织¶

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

2. 命名规范¶

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

3. 资源管理¶

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

常见问题¶

1. 资源导入失败¶

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

2. 皮肤生成错误¶

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

3. 更新问题¶

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

注意事项¶

1. 命名规范
2. 严格按照规定格式命名
3. 注意参数的顺序和格式

4. 使用英文字符和数字

5. 资源编译

6. 导入后需要重新生成.rc2文件
7. 使用uiresbuilder更新资源

8. 检查资源是否正确编译

9. 参数使用

10. ImgFrame参数顺序固定
11. 扩展参数在基本参数后
12. 注意参数值的有效范围

进阶用法¶

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. 持续集成¶

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

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

3. 自定义扩展¶

根据项目需求扩展功能：

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