如何在MAUI项目中按平台引入现有C++库？及问题排查

原问题场景 #

我们有一套分平台编译的C++库：Windows对应.dll、Android对应.so、iOS对应.a。在Android平台尝试引入.so文件时，执行了以下步骤：

• 将文件放入Platforms -> Android -> lib -> arm64-v8a目录
• 设置文件属性：Build Action = AndroidNativeLibrary
• 调用JavaSystem.LoadLibrary(lib name);
• 实现常规的PInvoke类

但运行时抛出UnsatisfiedLinkError异常，提示“dlopen failed: library "lib name.so" not found”，VS输出窗口显示“Shared library 'lib name' not loaded, p/invoke 'method name' may fail”，调整目录位置也无效。

问题解决（更新内容） #

Android平台.so文件的正确存放路径应为<project root>\Resources\lib\arm64-v8a\。补充说明：放入<project root>\Resources\Raw的文件会直接被复制到Android资源目录。

疑问解答 #

1. 原操作遗漏点 #

核心问题是路径不符合MAUI Android的资源打包规则：MAUI要求原生库放在Resources\lib\<abi>目录下，而非Platforms\Android\lib\<abi>，后者的文件不会被正确打包到APK的对应lib目录，导致运行时无法找到库文件。

2. MAUI使用现有C++库的实现要点 #

• 分平台放置库文件：
  • Windows：将.dll放入Platforms\Windows目录，设置Build Action = Content，确保库的架构（x86/x64/ARM）与项目目标架构一致
  • Android：按上述正确路径放置.so，设置Build Action = AndroidNativeLibrary
  • iOS：将.a文件放入Platforms\iOS目录，设置Build Action = NativeReference
• PInvoke适配：使用[DllImport]特性，注意平台差异：Android库名需去掉前缀lib和后缀.so，直接写核心名称；Windows直接写.dll文件名
• 加载时机：Android可在MainActivity的OnCreate方法中调用JavaSystem.LoadLibrary；Windows无需显式调用加载方法，PInvoke会自动触发加载

3. 生产环境适用性 #

该方案完全适用于生产环境，MAUI原生支持跨平台原生库调用，只需确保：

• 库文件架构与目标平台匹配（如Android的arm64-v8a/x86_64，Windows的x64/ARM64等）
• 库文件无依赖缺失（Android的.so若依赖其他系统或第三方库，需一并打包；Windows的.dll需确保依赖项存在）
• 严格遵循MAUI资源打包规则，避免路径错误导致库未被打包

当前新问题 #

MAUI Windows应用默认采用64位架构，无法加载32位.dll，该问题将另行提问。

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