.NET MAUI调用含Jetpack Compose的Kotlin Android Activity时出现ComposeView类未找到的运行时错误

看起来你遇到的是典型的跨平台依赖传递或版本不兼容问题，我之前在整合MAUI和原生Compose组件时也踩过类似的坑，咱们一步步来排查解决：

1. 先确认Kotlin库与Xamarin NuGet的Compose版本完全对齐 #

Xamarin的Compose NuGet包是官方Jetpack Compose版本的绑定，版本号必须严格匹配。你用的Xamarin.AndroidX.Compose.UI.Android 1.7.6.1对应官方Compose UI 1.7.6版本，所以你的Kotlin库的gradle依赖必须用完全相同的版本：

// 在Kotlin Android Library的build.gradle.kts中
dependencies {
    api("androidx.compose.ui:ui-android:1.7.6")
    api("androidx.activity:activity-compose:1.10.0") // 和你Xamarin用的1.10.0对应
    api("androidx.compose.material3:material3:1.2.1") // 如果用到Material3组件请添加
}

注意这里要用api而不是implementation，这样依赖会被包含进AAR的元数据里，Binding Library才能正确识别并传递给MAUI项目。

2. 把Compose依赖直接添加到MAUI项目中 #

Binding Library的依赖有时候不会自动传递到MAUI项目（默认PrivateAssets设置为all会阻止传递），所以你需要把那些Compose相关的NuGet包同时添加到MAUI的Android项目里，而不是只在Binding Library中配置：

<!-- 在MAUI项目的csproj中 -->
<PackageReference Include="Xamarin.AndroidX.Activity.Compose" Version="1.10.0" />
<PackageReference Include="Xamarin.AndroidX.Compose.UI.Android" Version="1.7.6.1" />
<PackageReference Include="Xamarin.AndroidX.Compose.UI.Geometry" Version="1.7.6.1" />
<!-- 其他你用到的Compose NuGet包都需要加上 -->

3. 调整Binding Library的依赖传递设置 #

在Binding Library的csproj里，把所有Compose相关的PackageReference的PrivateAssets设置为none，确保依赖能完整传递给MAUI项目：

<PackageReference Include="Xamarin.AndroidX.Activity.Compose" Version="1.10.0" PrivateAssets="none" />
<PackageReference Include="Xamarin.AndroidX.Compose.UI.Android" Version="1.7.6.1" PrivateAssets="none" />
<!-- 其他Compose包同样设置PrivateAssets="none" -->

4. 配置ProGuard/R8避免混淆Compose核心类 #

MAUI的Android Release构建默认会启用R8混淆，很可能把Compose的核心类给误删了。你需要添加自定义混淆规则：

1. 在MAUI项目的Platforms/Android目录下新建proguard.cfg文件，内容如下：

# 保留所有Compose相关类和方法
-keep class androidx.compose.** { *; }
# 保留你的Kotlin Activity所在的包
-keep class com.example.** { *; }
# Compose依赖大量注解，必须保留
-keepattributes *Annotation*
# 忽略Compose相关的无关警告
-dontwarn androidx.compose.**

2. 在MAUI项目的csproj里启用ProGuard并指定配置文件：

<PropertyGroup Condition="'$(TargetFramework)' == 'net8.0-android'">
  <AndroidEnableProguard>true</AndroidEnableProguard>
  <AndroidProguardConfiguration>proguard.cfg</AndroidProguardConfiguration>
</PropertyGroup>

如果是Debug模式测试，确保Debug模式未启用混淆（默认是关闭状态，但可以检查确认）。

5. 清理缓存并彻底重建项目 #

有时候Visual Studio的缓存会导致依赖不更新，按照以下步骤操作：

• 删除Binding Library和MAUI项目的bin、obj目录
• 清理NuGet缓存：在Visual Studio中点击「工具」→「NuGet包管理器」→「包管理器设置」→「清除所有NuGet缓存」
• 先重新构建Binding Library，再构建MAUI项目，最后部署到设备

额外排查点 #

如果以上步骤还没解决问题，可以通过以下方式进一步定位：

• 在Debug模式下运行，查看Logcat的详细错误信息，确认是否有其他Compose相关类未找到，判断是单一类缺失还是整个Compose依赖未被打包进APK
• 用Android Studio的APK Analyzer打开MAUI生成的APK，检查是否包含androidx.compose.ui.platform.ComposeView类

备注：内容来源于stack exchange，提问作者Foxan