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.proto 或 pb_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-Csv` 和 `UE-Json` 输出的代码会多一个 `Name` 字段?

因为对 UE-Json 输出中， Name 是一个特殊字段，也用于UE中内置的接口的查找索引。所以为了统一输出的数据结构（这样无论是 UE-Csv 还是 UE-Json 都可以用相同的代码结构来导入），我们对 UE-Csv 和 UE-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在保存时会保存一份公式计算结果的缓存，关闭公式实时计算后会使用这个缓存。