如何将含依赖的自制C++ .so库集成到Xamarin.Android应用

1. 准备Android NDK交叉编译环境 #

• 下载Android NDK LTS版本（如r25c），在WSL2中配置交叉编译工具链（以arm64-v8a架构为例）：

  export NDK_PATH=/path/to/your/ndk
  export TOOLCHAIN=$NDK_PATH/toolchains/llvm/prebuilt/linux-x86_64
  export CC=$TOOLCHAIN/bin/aarch64-linux-android24-clang
  export CXX=$TOOLCHAIN/bin/aarch64-linux-android24-clang++
  export AR=$TOOLCHAIN/bin/aarch64-linux-android-ar
  export LD=$TOOLCHAIN/bin/aarch64-linux-android-ld
  export STRIP=$TOOLCHAIN/bin/aarch64-linux-android-strip
  

  注：24为最低支持的Android API级别，可根据你的Xamarin项目需求调整。

2. 替换厂商预编译库为Android版本 #

厂商提供的libcard.so、libutils.so是桌面平台版本，无法直接在Android上运行，必须向厂商索要对应Android架构（arm64-v8a/armeabi-v7a/x86_64）的预编译库。拿到后将库文件放入libs/[abi]/目录，头文件card.h、utils.h放入include/目录。

3. 编译wfb.cpp为Android共享库 #

执行以下编译命令，指定头文件路径、依赖库路径并链接所需库：

$CXX -shared -fPIC -I./include -L./libs/arm64-v8a -lcard -lutils wfb.cpp -o libwfb.so

参数说明：

• -shared：生成共享库格式
• -fPIC：生成位置无关代码（Android共享库强制要求）
• -I./include：指定头文件搜索目录
• -L./libs/arm64-v8a：指定依赖库搜索目录
• -lcard -lutils：链接对应的依赖共享库

编译完成后，用$STRIP libwfb.so精简库文件，减少体积。

4. 验证依赖关系 #

用NDK自带工具检查生成的库是否正确链接依赖：

$TOOLCHAIN/bin/aarch64-linux-android-readelf -d libwfb.so | grep NEEDED

输出需包含libcard.so和libutils.so，确认架构与路径匹配。

5. 集成到Xamarin.Android项目 #

• 在Xamarin项目中创建libs/arm64-v8a/目录，将libwfb.so、libcard.so、libutils.so全部放入该目录。
• 修改项目.csproj文件，添加以下配置确保库被正确打包：

  <ItemGroup>
    <AndroidNativeLibrary Include="libs\arm64-v8a\libwfb.so">
      <Abi>arm64-v8a</Abi>
    </AndroidNativeLibrary>
    <AndroidNativeLibrary Include="libs\arm64-v8a\libcard.so">
      <Abi>arm64-v8a</Abi>
    </AndroidNativeLibrary>
    <AndroidNativeLibrary Include="libs\arm64-v8a\libutils.so">
      <Abi>arm64-v8a</Abi>
    </AndroidNativeLibrary>
  </ItemGroup>
  

• 通过DllImport调用库中函数：

  [DllImport("wfb", CallingConvention = CallingConvention.Cdecl)]
  public static extern int YourSensorDataFunction();
  

常见问题排查 #

• 编译时找不到头文件：检查-I参数指定的路径是否正确，头文件是否存在。
• 链接时找不到依赖库：确认依赖库为Android架构版本，且-L路径正确。
• 运行时库加载失败：确保所有依赖库都放入对应Abi目录，设备架构与库的架构匹配，.csproj配置无误。

内容的提问来源于stack exchange，提问作者CppPyMan.me