FAQ

哪里有完整的示例?

转表功能和二进制数据读取的示例见: https://github.com/xresloader/xresloader/tree/main/sample

文本和Msgpack数据读取示例见: https://github.com/xresloader/xresloader/tree/main/loader-binding

批量转表配置的示例见: https://github.com/xresloader/xresconv-conf

为什么会读到很多空数据?

Excel里编辑过的单元格即便删除了也会留下不可见的样式配置,这时候会导致转出的数据有空行。可以通过在Excel里删除行解决

为什么Excel里填的时间,但是转出来是一个负数?

Excel里的日期时间类型转成协议里整数时会转为Unix时间戳,但是Excel的时间是以1900年1月0号为基准的,这意味着如果时间格式是 hh:mm:ss 的话,49:30:01 会被转为 1900-1-2 1:31:01 。 时间戳因为是相对于 1970-01-01 00:00:00 的秒数,所以会是一个绝对值很大的负数。

Windows下控制台里执行执行会报文件编码错误?(java.nio.charset.UnsupportedCharsetException: cp65001)

这个问题涉及的几个Exception是:

ERROR StatusLogger Unable to inject fields into builder class for plugin type class org.apache.logging.log4j.core.appender.ConsoleAppender, element Console.
java.nio.charset.UnsupportedCharsetException: cp65001
        at java.nio.charset.Charset.forName(Unknown Source)
        at org.apache.logging.log4j.util.PropertiesUtil.getCharsetProperty(PropertiesUtil.java:146)
        at org.apache.logging.log4j.util.PropertiesUtil.getCharsetProperty(PropertiesUtil.java:134)
        ...
...

ERROR StatusLogger Unable to invoke factory method in class class org.apache.logging.log4j.core.appender.ConsoleAppender for element Console.
java.lang.IllegalStateException: No factory method found for class org.apache.logging.log4j.core.appender.ConsoleAppender
        at org.apache.logging.log4j.core.config.plugins.util.PluginBuilder.findFactoryMethod(PluginBuilder.java:224)
        at org.apache.logging.log4j.core.config.plugins.util.PluginBuilder.build(PluginBuilder.java:130)
        at org.apache.logging.log4j.core.config.AbstractConfiguration.createPluginObject(AbstractConfiguration.java:952)
        ...
...

这是因为在Windows控制台中,如果编码是UTF-8,java获取编码时会获取到cp65001,而这个编码java本身是不识别的。这种情况可以按下面的方法解决:

  • 第一种: 执行xresloader之前先执行 chcp 936,切换到GBK编码

  • 第二种: 在powershell里执行

C++加载代码编译时出现xresloader符号重定义(multiple definition of org::xresloader::pb::xresloader_XXX)

pb_header.pb.cc 和 pb_header_v3.pb.cc 只能保留一个

如果系统采用的是proto v3则保留pb_header_v3.pb.cc

如果系统采用的是老版本的proto v2则保留pb_header.pb.cc

C++加载代码编译时出现xresloader版本检查错误

具体表现为编译时输出 This file was generated by an older version of protoc ...This file was generated by a newer version of protoc ...

这是因为protoc版本和目前所用的protobuf版本不一致,请尝试重新用目前所用的protoc根据配置的proto文件和header目录中的 pb_header_v3.protopb_header.proto 重新生成c++代码文件。

proto v2版本API解析repeated的整数或浮点数类型字段失败(Wire Type)

我们转表默认使用的是proto v3模式,几乎所有编码规则都是向前兼容到proto v2的,但是也有一个例外,就是repeated的数值类型。

repeated的数值类型在proto v2里默认是 [ packed = false ] 而在proto v3里是 [ packed = true ] 。解决方法是显式指定打包方式。

详见 Proto v2和Proto v3

为什么在proto里定义的是一个无符号(unsigned)类型(uint32、uint64等),实际输出的UE代码是有符号(signed)的(int32/int64)?

因为有一些语言是没有无符号(unsigned)类型的,为了统一数据类型,我们统一转换为有符号类型,转换方式和protobuf的java版SDK保持一致。如果需要使用大于int32最大值的uint32类型,请用int64代替。

为什么 UE-CsvUE-Json 输出的代码会多一个 Name 字段?

因为对 UE-Json 输出中, Name 是一个特殊字段,也用于UE中内置的接口的查找索引。所以为了统一输出的数据结构( 这样无论是 UE-Csv 还是 UE-Json 都可以用相同的代码结构来导入 ),我们对 UE-CsvUE-Json 统一自动生成 Name 字段。但是如果用户自定义了 Name 字段, 我们会使用用户自定义的 Name 字段。

要如何配置可以让Excel里的数据指向UE的类型或资源

可以使用 org.xresloader.ue.ue_type_name 插件和 org.xresloader.ue.ue_type_is_class 插件。详见: 导出为UE支持的CSV或JSON数据和代码 (可选)

为什么UE的代码输出里对 oneof 的case输出使用 FString 的字段名而不使用 UEnum()

主要是因为(当前版本4.X)UE的 UEnum() 的支持仅支持基于 uint8 的,但是protobuf的field number是 int32 。为了兼容性所以没有使用 UEnum() 。 如果输出int32的话在UE里不太好操作,所以输出了字符串类型,方便蓝图里或UE代码里通过UE内置的反射机制访问。

提示 Can not reserve enough space for XXX objecct heap

在转换很大的Excel文件时(上万行数据),会需要很高的内存(>=1GB)。所以为了方便我们在批量转表sample的xml中配置了 <java_option desc="java选项-最大内存限制2GB">-Xmx2048m</java_option> 。 如果出现这个提示可能是32位jre无法分配这么多地址空间导致的,可以在xml里删除这个配置。但是还是建议使用64位jre。

在 v2.10.0 版本以后,可以通过使用 --disable-excel-formular 关闭公式实时计算,这时候会使用内部的索引器,能够大幅降低内存和CPU开销。

> 关闭公式实时计算并不是指不支持公式。Excel在保存时会保存一份公式计算结果的缓存,关闭公式实时计算后会使用这个缓存。