AssetRipper 配置数据是怎么存的3 步看懂配置读取与查询全流程【免费下载链接】AssetRipperGUI application to analyze game files项目地址: https://gitcode.com/GitHub_Trending/as/AssetRipperAssetRipper 是一款 Unity 游戏资产提取工具它的背后是一套 AssetRipper 配置数据存储机制负责保存所有导出设置。本文从一个真实的配置读取场景出发把这套存储系统的原理和用法一次讲清楚。从配置窗口说起你在界面上改的设置到底存在哪启动 AssetRipper GUI 后你会先看到一个Welcome To AssetRipper的配置选项窗口里面有 Mesh 导出格式、音频导出格式、脚本反编译级别等一堆选项。这些选项背后对应一个ImportSettings对象。当你在Export菜单里真正执行导出时程序读取它的代码长这样public ImportSettings ImportSettings { get SingletonData.GetStoredValueImportSettings(nameof(ImportSettings)); set SingletonData.SetStoredValue(nameof(ImportSettings), value); }注意SingletonData——这不是一个文件路径也不是数据库连接而是一个按 key 查值的键值存储。配置读取的完整流程就是CoreConfiguration对象在内存里持有这个存储属性访问器拿 key 去查查到后拿到类型化的配置对象。相关的入口在 Source/AssetRipper.Import/Configuration/CoreConfiguration.cs。那问题来了存储里存的到底是字符串、对象还是别的什么两个容器单例数据与列表数据CoreConfiguration里其实并排放着两个存储SingletonData单例数据存储一个 key 对应一个值。像图像导出格式是 PNG 还是其他这种一对一的设置放这里最合适。ListData列表数据存储一个 key 对应一组值。比如需要记录一批文件路径、一串数字时用列表存更自然。源码里有一段 DEBUG 专用的演示数据能直观说明区别单例区存了一个叫README的纯文本说明列表区存了一个README列表、一个斐波那契数列[1, 1, 2, 3, 5, 8, 13, 21, 34, 55]甚至一个空列表。这两个存储都继承自同一个泛型基类DataStorageT内部就是一个Dictionarystring, T所以查询这件事天然就是字典查找Keys枚举所有 key索引器按 key 取值TryGetValue在取值的同时还能做一次类型校验。列表数据则通过Strings访问器把整个集合当作IReadOnlyListstring来遍历用起来和普通 List 没有区别。为什么要多包一层每个条目都能变回字符串这套设计的核心巧思在于存储里放的不是裸对象而是两种带外壳的条目——DataInstance单值和DataSet列表而它们共同的父类DataEntry只有一个要求DataInstance多一个抽象的Text字符串属性所有条目都能调用Clear()重置自己。为什么一定要能变回字符串因为内存里放的是对象落盘时只能是文本。DataInstanceT内部同时握着一个值和一个序列化器Text的 getter 负责对象 → 文本setter 负责文本 → 对象方向可以随时切换。这里的序列化器是一个极简的抽象只有三个方法public abstract class DataSerializerT { public abstract T Deserialize(string text); public abstract string Serialize(T value); public abstract T CreateNew(); }Deserialize、Serialize管双向转换CreateNew负责造一个默认值。于是重置配置就有了统一的实现调用存储的Clear()它会依次对每个条目调用Clear()而每个条目内部就是执行一次CreateNew()。CoreConfiguration.ResetToDefaultValues()正是靠这一条链把所有设置打回出厂状态而不是粗暴地清空内存。三种序列化策略字符串、可解析类型、JSON序列化器有三个现成实现覆盖了配置数据的三种常见形态策略适合的数据工作方式字符串序列化器纯文本值原样存取默认值是空字符串可解析类型序列化器实现了IParsableT的类型调用类型的TryParse从文本还原ToString转回去JSON 序列化器任意配置对象基于源生成的JsonTypeInfoT做 JSON 双向转换值得注意的是宽容解析这个设计。可解析类型和 JSON 两个序列化器在反序列化失败或拿到空文本时不会抛异常而是退回CreateNew()的默认值。翻译过来就是就算配置文件写坏了或格式变了程序读到的也是一个干净的对象而不是直接崩溃——这对读取用户本地配置这类场景非常友好。三类序列化器各自对应一个条目外壳字符串对应StringDataInstance/StringDataSet可解析类型对应ParsableDataSetTJSON 对应JsonDataInstanceT。ListDataStorage的两个Add重载就是直接帮你选好外壳存Liststring自动包成字符串数据集存实现了IParsableT的ListT自动包成可解析数据集。实践要点照着做就行的 5 条 结合上面讲的机制日常读写配置时记住这几点就够了读取不确定的键先问后拿用TryGetStoredValueT它返回false表示没有这个键或类型对不上不会抛异常适合做存在性判断。确定必须存在的值用严格版本GetStoredValueT查不到会抛KeyNotFoundException让配置错误在第一时间暴露而不是带着默认值悄悄跑下去。重置配置走Clear()链它对每个条目调用的是还原默认值而非删除所以ResetToDefaultValues()之后存储依然完整只是所有值回到了初始状态。列表数据优先用便捷重载ListDataStorage.Add(key, list)会根据元素类型自动选外壳不必手动 new 数据集。新增一种复杂配置对象走 JSON 路线——用JsonDataInstanceT包起来交给SingletonData序列化和反序列化不用自己写一行代码。整套实现的源码都在 Source/AssetRipper.Configuration/ 目录下文件按条目 / 集合 / 存储 / 序列化器命名对照本文找文件不会迷路。小结配置数据的本质是内存里放对象、磁盘上存文本Text属性是两者之间的桥。单例存储管一对一的设置列表存储管一组值两者共用同一个字典查询底座。序列化器只问三个问题怎么解、怎么编、默认值怎么造策略因此可以随意替换。宽容解析保证了坏数据不会让程序崩掉重置配置走的是还原默认而非清空。想继续深入的话建议顺着CoreConfiguration看看ImportSettings里每个字段如何被导出流程消费再翻一翻 Source/AssetRipper.Import/ 目录就能把配置从哪来、到哪去串成一条完整链路。【免费下载链接】AssetRipperGUI application to analyze game files项目地址: https://gitcode.com/GitHub_Trending/as/AssetRipper创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
AssetRipper 配置数据是怎么存的：3 步看懂配置读取与查询全流程
AssetRipper 配置数据是怎么存的3 步看懂配置读取与查询全流程【免费下载链接】AssetRipperGUI application to analyze game files项目地址: https://gitcode.com/GitHub_Trending/as/AssetRipperAssetRipper 是一款 Unity 游戏资产提取工具它的背后是一套 AssetRipper 配置数据存储机制负责保存所有导出设置。本文从一个真实的配置读取场景出发把这套存储系统的原理和用法一次讲清楚。从配置窗口说起你在界面上改的设置到底存在哪启动 AssetRipper GUI 后你会先看到一个Welcome To AssetRipper的配置选项窗口里面有 Mesh 导出格式、音频导出格式、脚本反编译级别等一堆选项。这些选项背后对应一个ImportSettings对象。当你在Export菜单里真正执行导出时程序读取它的代码长这样public ImportSettings ImportSettings { get SingletonData.GetStoredValueImportSettings(nameof(ImportSettings)); set SingletonData.SetStoredValue(nameof(ImportSettings), value); }注意SingletonData——这不是一个文件路径也不是数据库连接而是一个按 key 查值的键值存储。配置读取的完整流程就是CoreConfiguration对象在内存里持有这个存储属性访问器拿 key 去查查到后拿到类型化的配置对象。相关的入口在 Source/AssetRipper.Import/Configuration/CoreConfiguration.cs。那问题来了存储里存的到底是字符串、对象还是别的什么两个容器单例数据与列表数据CoreConfiguration里其实并排放着两个存储SingletonData单例数据存储一个 key 对应一个值。像图像导出格式是 PNG 还是其他这种一对一的设置放这里最合适。ListData列表数据存储一个 key 对应一组值。比如需要记录一批文件路径、一串数字时用列表存更自然。源码里有一段 DEBUG 专用的演示数据能直观说明区别单例区存了一个叫README的纯文本说明列表区存了一个README列表、一个斐波那契数列[1, 1, 2, 3, 5, 8, 13, 21, 34, 55]甚至一个空列表。这两个存储都继承自同一个泛型基类DataStorageT内部就是一个Dictionarystring, T所以查询这件事天然就是字典查找Keys枚举所有 key索引器按 key 取值TryGetValue在取值的同时还能做一次类型校验。列表数据则通过Strings访问器把整个集合当作IReadOnlyListstring来遍历用起来和普通 List 没有区别。为什么要多包一层每个条目都能变回字符串这套设计的核心巧思在于存储里放的不是裸对象而是两种带外壳的条目——DataInstance单值和DataSet列表而它们共同的父类DataEntry只有一个要求DataInstance多一个抽象的Text字符串属性所有条目都能调用Clear()重置自己。为什么一定要能变回字符串因为内存里放的是对象落盘时只能是文本。DataInstanceT内部同时握着一个值和一个序列化器Text的 getter 负责对象 → 文本setter 负责文本 → 对象方向可以随时切换。这里的序列化器是一个极简的抽象只有三个方法public abstract class DataSerializerT { public abstract T Deserialize(string text); public abstract string Serialize(T value); public abstract T CreateNew(); }Deserialize、Serialize管双向转换CreateNew负责造一个默认值。于是重置配置就有了统一的实现调用存储的Clear()它会依次对每个条目调用Clear()而每个条目内部就是执行一次CreateNew()。CoreConfiguration.ResetToDefaultValues()正是靠这一条链把所有设置打回出厂状态而不是粗暴地清空内存。三种序列化策略字符串、可解析类型、JSON序列化器有三个现成实现覆盖了配置数据的三种常见形态策略适合的数据工作方式字符串序列化器纯文本值原样存取默认值是空字符串可解析类型序列化器实现了IParsableT的类型调用类型的TryParse从文本还原ToString转回去JSON 序列化器任意配置对象基于源生成的JsonTypeInfoT做 JSON 双向转换值得注意的是宽容解析这个设计。可解析类型和 JSON 两个序列化器在反序列化失败或拿到空文本时不会抛异常而是退回CreateNew()的默认值。翻译过来就是就算配置文件写坏了或格式变了程序读到的也是一个干净的对象而不是直接崩溃——这对读取用户本地配置这类场景非常友好。三类序列化器各自对应一个条目外壳字符串对应StringDataInstance/StringDataSet可解析类型对应ParsableDataSetTJSON 对应JsonDataInstanceT。ListDataStorage的两个Add重载就是直接帮你选好外壳存Liststring自动包成字符串数据集存实现了IParsableT的ListT自动包成可解析数据集。实践要点照着做就行的 5 条 结合上面讲的机制日常读写配置时记住这几点就够了读取不确定的键先问后拿用TryGetStoredValueT它返回false表示没有这个键或类型对不上不会抛异常适合做存在性判断。确定必须存在的值用严格版本GetStoredValueT查不到会抛KeyNotFoundException让配置错误在第一时间暴露而不是带着默认值悄悄跑下去。重置配置走Clear()链它对每个条目调用的是还原默认值而非删除所以ResetToDefaultValues()之后存储依然完整只是所有值回到了初始状态。列表数据优先用便捷重载ListDataStorage.Add(key, list)会根据元素类型自动选外壳不必手动 new 数据集。新增一种复杂配置对象走 JSON 路线——用JsonDataInstanceT包起来交给SingletonData序列化和反序列化不用自己写一行代码。整套实现的源码都在 Source/AssetRipper.Configuration/ 目录下文件按条目 / 集合 / 存储 / 序列化器命名对照本文找文件不会迷路。小结配置数据的本质是内存里放对象、磁盘上存文本Text属性是两者之间的桥。单例存储管一对一的设置列表存储管一组值两者共用同一个字典查询底座。序列化器只问三个问题怎么解、怎么编、默认值怎么造策略因此可以随意替换。宽容解析保证了坏数据不会让程序崩掉重置配置走的是还原默认而非清空。想继续深入的话建议顺着CoreConfiguration看看ImportSettings里每个字段如何被导出流程消费再翻一翻 Source/AssetRipper.Import/ 目录就能把配置从哪来、到哪去串成一条完整链路。【免费下载链接】AssetRipperGUI application to analyze game files项目地址: https://gitcode.com/GitHub_Trending/as/AssetRipper创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
