如何在.NET MAUI项目中正确引用IKVM生成的D2XX.dll？

问题1：如何让using D2XX;生效？ #

• 立刻移除手动添加的<Reference>节点，<IkvmReference>已经负责自动生成并引入程序集，两者共存会导致Visual Studio引用冲突。
• 检查生成的D2XX.dll的实际命名空间：IKVM会将原Java包名直接转为.NET命名空间，比如原SDK的com.ftdi.j2xx包，转成.NET后还是com.ftdi.j2xx，而非你设置的AssemblyName（D2XX）。你需要用using com.ftdi.j2xx;（对应实际包名）而非using D2XX;。可以用ILSpy等反编译工具打开D2XX.dll确认命名空间。

问题2：D2XX.dll应放置在哪个目录？ #

• 无需手动复制D2XX.dll到任何目录，IKVM在构建过程中会自动在输出目录（bin/Debug/net8.0-android/）生成程序集，并负责将其纳入MAUI项目的引用链。手动移动文件会破坏构建流程，导致引用失效。

问题3：MAUI引用IKVM生成程序集有特定方式吗？ #

• 必须将IKVM配置隔离在Android平台专属条件组中，避免影响iOS、Windows等其他平台的构建。修改csproj配置如下：

<ItemGroup Condition="$([MSBuild]::GetTargetPlatformIdentifier('$(TargetFramework)')) == 'android'">
    <IkvmReference Include="Platforms/Android/libs/d2xx.jar">
        <AssemblyName>D2XX</AssemblyName>
        <AssemblyVersion>1.0.0.0</AssemblyVersion>
        <Debug>portable</Debug>
    </IkvmReference>
</ItemGroup>

• 确保IKVM NuGet包版本与MAUI目标框架（如.NET 8）完全兼容，避免版本不匹配导致的转换或引用错误。

IKVM与.NET MAUI集成最佳实践 #

1. 平台代码隔离：将所有D2XX相关的USB通信代码放在Platforms/Android/目录下的类中，或通过依赖注入封装接口（如IUsbCommunication），Android项目实现具体逻辑，其他平台提供空实现或模拟逻辑，避免跨平台编译报错。
2. 清理冗余配置：只保留<IkvmReference>配置，删除所有手动添加的<Reference>节点，让IKVM全权负责程序集的生成、引用和打包。
3. 验证native库部署：FTDI的D2XX SDK依赖native库（libftd2xx.so），需将对应ABI版本的库放在Platforms/Android/libs/[abi]/目录（如arm64-v8a、armeabi-v7a），并在csproj中添加以下配置确保打包：

<ItemGroup Condition="$([MSBuild]::GetTargetPlatformIdentifier('$(TargetFramework)')) == 'android'">
    <AndroidNativeLibrary Include="Platforms/Android/libs/**/*.so" />
</ItemGroup>

4. 构建日志排查：若仍有问题，查看Visual Studio的构建日志（输出窗口→构建→详细级别），搜索IKVM相关日志，排查转换失败、引用缺失等具体错误。

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