Puerts在Unity安卓平台导出类获取问题的分析与解决

问题背景

Puerts作为Unity与TypeScript/JavaScript之间的桥梁，在游戏开发中扮演着重要角色。近期在Puerts 2.2.0版本中发现了一个特定于Android平台的问题：当使用ExecuteModule<JSObject>方法尝试获取导出类时，在Android打包后无法正常获取，而在Windows平台和编辑器环境下则表现正常。

问题现象

开发者在使用Puerts 2.2.0版本时发现，在TS脚本中通过export导出的类，在Android平台打包后无法通过以下两种方式获取：

1. jsEnv.ExecuteModule<JSObject>(ModuleName, "ClassName");
2. jsEnv.ExecuteModule(ModuleName).Get<JSObject>("ClassName");

这个问题在2.2.0版本之前的版本中不存在，且在2.2.0版本的Windows平台和编辑器环境下也能正常工作。

技术分析

模块系统工作原理

Puerts的模块系统基于ES6模块规范实现。当使用ExecuteModule方法执行一个模块时，实际上是在JavaScript环境中创建了一个模块作用域，所有通过export导出的内容都应该可以通过模块对象访问。

Android平台特殊性

Android平台与Windows平台在JavaScript引擎实现上存在差异，特别是在模块加载和解析机制上。可能的原因包括：

1. 模块缓存机制：Android平台可能对模块缓存处理不同，导致导出内容未被正确注册
2. 名称解析策略：导出类的名称解析在Android平台可能采用了不同的策略
3. 执行环境差异：Android的JavaScript执行环境可能与标准实现存在细微差别

版本变更影响

从2.2.0版本开始，Puerts对模块系统进行了优化和重构，可能引入了对Android平台支持不完善的新特性或改变了某些底层实现方式。

解决方案

针对这一问题，Puerts团队在后续版本中进行了修复。开发者可以采取以下解决方案：

1. 升级Puerts版本：使用最新版本的Puerts，该问题已在后续版本中得到修复
2. 临时解决方案：如果需要继续使用2.2.0版本，可以考虑以下替代方案：
   • 将导出类改为全局变量
   • 使用回调函数方式传递类引用
   • 通过Puerts的其他API间接获取类实例

最佳实践建议

为避免类似问题，建议开发者在跨平台开发时：

1. 充分测试各平台：特别是在移动平台上的表现
2. 关注版本变更日志：了解各版本间的兼容性变化
3. 模块化设计：采用更健壮的模块组织方式
4. 错误处理：增加对模块加载失败的检测和处理逻辑

总结

Puerts在Unity开发中提供了强大的TypeScript/JavaScript支持能力，但在跨平台实现上仍可能遇到特定问题。通过理解模块系统的工作原理和平台差异，开发者可以更好地规避和解决这类问题。对于Android平台特有的导出类获取问题，及时更新到修复版本是最推荐的解决方案。