.NET MAUI文件夹选择器类库开发技术问题咨询

问题场景 #

我正在开发一个用于文件夹选择的.NET MAUI类库，参照Stack Overflow上的《Folder Picker .NET MAUI》教程推进：

1. 定义了核心接口：

public interface IAskDirectory
{
   Task<string> AskDirectory();
}

2. 在Platform\Windows目录下实现了Windows平台的具体逻辑：

public class DirectoryAsker : IAskDirectory
{
        public async Task<string> AskDirectory()
        {
            var folderPicker = new FolderPicker();
            // 兼容Windows 10的必要设置
            folderPicker.FileTypeFilter.Add("*");

            // 尝试获取当前窗口句柄，但类库无法识别App对象
            var hwnd = ((MauiWinUIWindow)App.Current.Windows[0].Handler.PlatformView).WindowHandle;

            WinRT.Interop.InitializeWithWindow.Initialize(folderPicker, hwnd);

            var result = await folderPicker.PickSingleFolderAsync();
            return result?.Path;
        }
}

遇到两个技术卡点：

1. 类库中无法访问App对象，该如何正确获取Windows窗口句柄（HWND）？
2. 接口与实现的DI注册操作，能否封装在类库内部，而非让主项目在MauiProgram.cs中手动完成？

解决方案 #

问题1：类库中获取Windows窗口句柄 #

类库不能直接依赖主项目的App实例，推荐两种可靠方案：

方案一：通过依赖注入注入当前窗口

修改DirectoryAsker的构造函数，注入IWindow实例，从窗口实例中提取句柄：

public class DirectoryAsker : IAskDirectory
{
    private readonly IWindow _currentWindow;

    public DirectoryAsker(IWindow currentWindow)
    {
        _currentWindow = currentWindow;
    }

    public async Task<string> AskDirectory()
    {
        var folderPicker = new FolderPicker();
        folderPicker.FileTypeFilter.Add("*");

        var mauiWinUIWindow = (MauiWinUIWindow)_currentWindow.Handler.PlatformView;
        var hwnd = mauiWinUIWindow.WindowHandle;

        WinRT.Interop.InitializeWithWindow.Initialize(folderPicker, hwnd);

        var pickedFolder = await folderPicker.PickSingleFolderAsync();
        return pickedFolder?.Path;
    }
}

此方案依赖MAUI的DI系统，MAUI默认已完成窗口服务的注册，直接使用即可。

方案二：通过WindowStateManager获取活跃窗口

引用Microsoft.Maui.ApplicationModel包，调用WindowStateManager获取当前活跃窗口：

public async Task<string> AskDirectory()
{
    var folderPicker = new FolderPicker();
    folderPicker.FileTypeFilter.Add("*");

    var activeWindow = WindowStateManager.Default.GetActiveWindow();
    var mauiWinUIWindow = (MauiWinUIWindow)activeWindow.Handler.PlatformView;
    var hwnd = mauiWinUIWindow.WindowHandle;

    WinRT.Interop.InitializeWithWindow.Initialize(folderPicker, hwnd);

    var pickedFolder = await folderPicker.PickSingleFolderAsync();
    return pickedFolder?.Path;
}

此方案无需注入，直接获取系统内的MAUI活跃窗口，适合无需依赖DI的场景。

问题2：类库内封装DI注册 #

可以将注册逻辑封装在类库内部，主项目只需调用扩展方法即可完成集成：

1. 在类库中创建MauiAppBuilder扩展方法：

using Microsoft.Maui.Hosting;

namespace YourLibraryNamespace
{
    public static class FolderPickerExtensions
    {
        public static MauiAppBuilder AddFolderPickerServices(this MauiAppBuilder builder)
        {
            // 注册接口与实现
            builder.Services.AddTransient<IAskDirectory, DirectoryAsker>();
            // 其他平台的实现注册也可在此添加
            return builder;
        }
    }
}

2. 主项目在MauiProgram.cs中调用扩展方法：

var builder = MauiApp.CreateBuilder();
builder
    .UseMauiApp<App>()
    .AddFolderPickerServices(); // 一行代码完成类库服务注册

这种方式将注册逻辑封装在类库内，降低主项目的集成成本，符合类库的封装原则。

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