Unity Excel Importer 使用教程

Unity Excel Importer 使用教程

1. 项目介绍

Unity-Excel-Importer 是一个用于Unity编辑器的插件，它允许你在不编写任何代码的情况下，将Excel数据自动导入到自定义的ScriptableObject中。这个工具支持.xls和.xlsx文件格式，简化了在Unity项目中管理和使用结构化数据的过程。

2. 项目快速启动

安装

1. 在你的 Packages/manifest.json 文件中添加以下依赖项：

   {
       "dependencies": {
           "net.mikinya.unity-excel-importer": "https://github.com/mikito/unity-excel-importer.git?path=Assets/ExcelImporter#v0.1.1/upm"
       }
   }
   

2. 保存并刷新Unity的Package Manager界面，等待安装完成。

导入数据

1. 创建Excel文件：制作Excel文件，第一行为列名，从第二行开始输入数据。
2. 将Excel文件导入Unity项目中的Project视图。

设置Entity类

1. 在Unity项目中创建一个新的C#脚本，例如名为MyEntity.
2. 使用 [ExcelAsset] 属性标记你的类，并指定Excel工作表的名字：

   [ExcelAsset("SheetName")]
   public class MyEntity : ScriptableObject
   

3. 定义和Excel列对应的公共字段，比如：

   public string Parameter1;
   public int Parameter2;
   

自动生成导入器

1. 运行Unity-Excel-Importer Maker工具（如果有），选择你的Excel文件，创建XLS Importer。
2. 点击“创建”按钮，工具将在 Terasurware/Classes/Editor 目录下生成导入器。
3. 再次导入Excel文件，Unity将会自动生成与Excel数据对应的ScriptableObject。

3. 应用案例和最佳实践

• 游戏数据管理：用于存储角色属性、道具描述、地图数据等静态游戏数据。
• 动态排序：结合自定义排序算法，可以按需对导入的数据进行排序处理。
• 版本控制：当Excel表格作为版本控制的数据源时，更容易跟踪和合并更改。

最佳实践：

• 始终保持Excel列名简洁且有意义，以便于映射到C#字段。
• 对于大量数据，考虑优化加载方式，如异步加载或按需加载。

4. 典型生态项目

除了Unity-Excel-Importer，还有一些其他的Excel集成解决方案：

• Excel4Unity：提供读写功能的Excel插件：https://github.com/joexi/Excel4Unity
• Unity-QuickSheet：轻量级的Excel导入选项：https://github.com/kimsama/Unity-QuickSheet

通常，CSV也是常见的数据交换格式，易于手动或自动排序，并且有更多的库支持。

---

记得在实际使用中检查最新的官方文档以获取更新的信息和示例。祝你在Unity项目中愉快地导入Excel数据！