Skip to main content
Version: 2022.1

全局设置

xasset 使用 Settings 文件管理管理一些全局的参数配置,如下图:

settings

提示

设置文件默认是会自动创建在这个路径:

  • Assets/xasset/Settings.asset。

另外,可以通过点击版本管理工具的Settings菜单快速定位设置文件。

属性说明

如何使用 Settings 中的各个属性?请参考这些属性的说明:

Exclude Files

采集资产的时候,需要排除的文件,默认 .cs 文件会自动被排除,不用单独配置。

Replace Bundles Names

简化包名的配置,将和 key 匹配的包名内容替换为配置的 value。例如,原始包名为:

  • assets_xasset_example_arts_textures

在这个配置的作用下,最终将简化成:

  • textures

Replace Bundle Name With Hash

是否直接将包名用包名的 hash 替换,开启后,打包输出的文件名格式是:

包名哈希_内容哈希.扩展名
提示

这个配置会导致打包输出的文件名不是很直观,但对于包含比较多的中文或特殊字符的资产路径的项目来说,可以有效避免一些非法字符导致一些平台加载失败的问题。

Bundle Extension

打包输出的资产的扩展名,团队用户建议留空。

Append Build Name To Bundle

是否将打包配置的名字添加到包名上,开启后,打包输出的文件名格式是:

打包配置名_包名哈希_内容哈希.扩展名
提示

这个配置可以强制让不同的打包配置之前的资产解除引用关系,最终输出的资产可能会冗余,但是,可以确保能够正常加载。

Split Config

当前生效的分包配置,打包安装包的时候会自动复制该配置相关的资产到安装包目录。需要了解更多,请阅读分包指南

Encryption Enabled

是否开启资产加密?Android 平台开启资产加密不仅可以防止安装包资产被 AssetStudio 之类的工具轻易破解,并且,在部分真机实测的数据上,加载性能有 10% 左右的提升。具体请参考资产加密的文档。

Script Play Mode

用来设置代码的运行模式,具体可以使用哪些模式?请参考代码运行模式