Xamarin.Forms应用初始化时调用异步方法的问题求助

我之前在做Xamarin.Forms+UWP项目时，也踩过async/await线程死锁和异步单例初始化的坑，结合你的场景，给你一套可行的解决方案：

一、先搞定UWP异步依赖服务的正确实现 #

因为UWP的Storage API全是异步的，所以首先要把文件夹扫描的逻辑封装成异步依赖服务，避免直接在共享代码里写平台特定代码：

1. 定义共享接口 #

在共享项目里创建扫描服务的接口，注意方法要返回Task<T>：

public enum AppState
{
    FirstRun,
    HasExistingData
}

public interface IDataFolderScanner
{
    Task<AppState> ScanDataFolderAsync();
}

2. UWP平台实现 #

在UWP项目里实现这个接口，并用Dependency特性标记：

[assembly: Dependency(typeof(UwpDataFolderScanner))]
namespace YourAppNamespace.UWP
{
    public class UwpDataFolderScanner : IDataFolderScanner
    {
        public async Task<AppState> ScanDataFolderAsync()
        {
            // 异步获取Data文件夹，注意处理文件夹不存在的情况
            StorageFolder dataFolder;
            try
            {
                dataFolder = await Windows.Storage.ApplicationData.Current.LocalFolder.GetFolderAsync("Data");
            }
            catch (FileNotFoundException)
            {
                // 如果Data文件夹不存在，说明是首次运行
                return AppState.FirstRun;
            }

            // 扫描文件夹内容，判断状态
            var files = await dataFolder.GetFilesAsync();
            return files.Count > 0 ? AppState.HasExistingData : AppState.FirstRun;
        }
    }
}

二、重构单例AppManager的异步初始化 #

你之前用单例模式遇到调用难题，大概率是因为在构造函数里做了异步操作，或者用了.Result/.Wait()导致死锁。正确的做法是把单例的初始化做成异步延迟加载，保证线程安全：

public class AppManager
{
    // 用Lazy<Task<AppManager>>实现线程安全的异步延迟初始化
    private static readonly Lazy<Task<AppManager>> _lazyInstance = 
        new Lazy<Task<AppManager>>(InitializeAppManagerAsync);

    public AppState CurrentAppState { get; private set; }

    // 私有构造函数，避免外部直接实例化
    private AppManager(AppState initialState)
    {
        CurrentAppState = initialState;
    }

    // 异步初始化逻辑，这里注入依赖服务并扫描文件夹
    private static async Task<AppManager> InitializeAppManagerAsync()
    {
        var scanner = DependencyService.Get<IDataFolderScanner>();
        var appState = await scanner.ScanDataFolderAsync();
        return new AppManager(appState);
    }

    // 对外提供异步获取单例的方法
    public static async Task<AppManager> GetInstanceAsync()
    {
        return await _lazyInstance.Value;
    }

    // 根据状态返回对应页面的方法
    public Page GetInitialPage()
    {
        return CurrentAppState switch
        {
            AppState.FirstRun => new OnboardingPage(),
            AppState.HasExistingData => new MainPage(),
            _ => throw new InvalidOperationException("无法识别的应用状态")
        };
    }
}

三、在App启动时异步加载页面 #

最后在App.xaml.cs的启动事件里，全程用async/await调用，绝对不要用.Result或者.Wait()，否则会导致UI线程死锁：

protected override async void OnStart()
{
    base.OnStart();
    
    // 异步获取AppManager实例
    var appManager = await AppManager.GetInstanceAsync();
    // 根据状态设置初始页面
    MainPage = new NavigationPage(appManager.GetInitialPage());
}

关键注意点 #

• 全程遵循异步优先原则：从依赖服务到单例初始化，再到页面加载，所有涉及IO的操作都用async/await，不要阻塞线程。
• 避免在构造函数里做异步操作：构造函数是同步的，强行在里面做异步操作会导致各种线程问题，改用异步初始化方法是最佳实践。
• UWP Storage API的线程安全：UWP的Storage API可以在后台线程调用，但await会自动回到调用时的上下文（这里是UI线程），所以不需要额外处理线程切换。

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