macOS下Unity2020导入gInput等DLL插件抛出DllNotFoundException如何解决

问题产生原因 #

macOS平台的原生库加载规则与Windows存在差异，出现该报错的核心原因是Unity无法定位到符合要求的gInput原生库，常见诱因包括：

• 插件仅适配Windows平台，未提供macOS对应的.dylib或.framework格式原生库
• 提供的macOS原生库架构不匹配：Apple Silicon芯片设备缺少arm64架构支持，Intel芯片设备缺少x86_64架构支持
• 原生库导入Unity时配置错误，未勾选macOS平台支持，或未放置在Assets/Plugins目录下
• DllImport写法不符合macOS规范，未适配.framework类库的路径规则
• 原生库未签名/未经过苹果公证，被macOS Gatekeeper安全机制拦截加载
• Unity未安装macOS构建支持模块，无法识别对应平台的原生库

排查解决步骤 #

• 确认插件平台兼容性
  先查看插件的Asset Store详情页或官方说明，如果明确仅支持Windows平台，需更换适配macOS的力反馈插件，或自行编译对应功能的macOS原生库。
• 检查原生库导入配置
  确保所有原生库文件存放在Assets/Plugins目录下，选中库文件在Inspector面板核对配置：
  • 「Include Platforms」选项中必须勾选macOS，无关平台可取消勾选减少冲突
  • 「CPU」选项和你的Mac芯片匹配：Apple Silicon选Arm64，Intel芯片选x86_64，也可选择Any CPU
  • 「Load on startup」保持默认勾选状态
• 修正DllImport写法
  如果使用的是.dylib格式库，确认文件名前缀为lib（即文件名为libgInput.dylib），现有写法[DllImport("gInput")]符合规则；如果是.framework格式库，需要修改为[DllImport("gInput.framework/gInput")]。
• 校验原生库架构与签名
  打开终端进入原生库所在目录，执行对应命令检查：
  查看架构：

  # .dylib格式
  lipo -info libgInput.dylib
  # .framework格式
  lipo -info gInput.framework/gInput
  

  输出结果中必须包含你的Mac对应架构（x86_64对应Intel，arm64对应Apple Silicon），缺失的话需要重新编译对应架构的库。
  检查签名：

  codesign -dv libgInput.dylib
  

  如果提示无有效签名，执行自签名命令：

  codesign -f -s - libgInput.dylib
  

• 绕过Gatekeeper安全拦截
  如果是第三方库未公证被系统拦截，右键点击原生库文件，选择「打开」，完成一次信任操作后重启Unity重新加载项目即可。
• 修复Unity环境问题
  如果所有DLL插件都出现同类报错，打开Unity Hub查看2020.3.10f1版本的安装详情，确认macOS Build Support模块已经安装，缺失的话补充安装后重启Unity。

内容的提问来源于stack exchange，提问作者Queen