.NET MAUI项目中平台特定服务引用失败的问题求助

核心排查与修复步骤 #

1. 确保平台实现类的访问修饰符为public #

平台专属的FirebaseAuthService_Android和FirebaseAuthService_iOS类必须标记为public，否则主项目无法访问（C#类默认访问级别为internal，仅限当前程序集可见）。示例代码：

// Platforms/Android/Services/FirebaseAuthService_Android.cs
namespace DisApp24.Services
{
    public class FirebaseAuthService_Android : IFirebaseAuthService
    {
        // 接口方法实现逻辑
    }
}

2. 验证命名空间完全一致 #

平台实现类的命名空间必须和主项目中IFirebaseAuthService的命名空间完全匹配（即DisApp24.Services），不要因文件夹结构额外添加层级。

3. 恢复平台文件的默认编译配置 #

.NET MAUI会自动识别Platforms文件夹下的平台专属代码，无需手动在主项目.csproj中添加引用，手动添加反而可能引发冲突：

• 打开主项目.csproj文件，移除之前手动添加的平台项目引用
• 确认平台文件的Build Action为Compile，且带有正确的平台条件属性（默认创建的文件会自动配置，示例如下）：

<!-- Android文件的默认配置 -->
<ItemGroup>
  <Compile Include="Platforms\Android\Services\FirebaseAuthService_Android.cs" Condition="$([MSBuild]::GetTargetPlatformIdentifier('$(TargetFramework)')) == 'android'" />
</ItemGroup>

4. 优化服务注册代码（可选） #

可以使用.NET MAUI推荐的简洁条件编译符号（ANDROID/IOS，与__ANDROID__/__IOS__等效）简化注册逻辑：

using DisApp24.Services;
using Microsoft.Extensions.DependencyInjection;

namespace DisApp24
{
    public static class MauiProgram
    {
        public static MauiApp CreateMauiApp()
        {
            var builder = MauiApp.CreateBuilder();

#if ANDROID
            builder.Services.AddSingleton<IFirebaseAuthService, FirebaseAuthService_Android>();
#elif IOS
            builder.Services.AddSingleton<IFirebaseAuthService, FirebaseAuthService_iOS>();
#endif

            // ...其他配置代码...

            return builder.Build();
        }
    }
}

5. 清理重建项目 #

完成上述修改后，执行以下操作确保编译环境干净：

• 右键解决方案选择「清理」
• 手动删除主项目及平台项目的bin、obj文件夹
• 重新生成解决方案

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