.NET MAUI中HCE后台运行时弹窗不显示问题求助

问题根源 #

HCE服务属于后台组件，当应用处于后台时：

1. Application.Current.MainPage可能为null，无法通过导航栈弹出弹窗
2. Android系统限制后台组件直接显示UI弹窗，必须先将应用切换到前台，或通过通知引导用户打开应用

解决方案一：将应用切换到前台后弹窗 #

1. 修改HCE服务的弹窗逻辑 #

确保UI操作在主线程执行，并在后台时启动应用到前台：

public class MyHostApduService : HostApduService
{
    public override void OnDeactivated([GeneratedEnum] DeactivationReason reason) { }

    public override byte[]? ProcessCommandApdu(byte[]? commandApdu, Bundle? extras)
    {
        // 同步获取SecureStorage（避免异步死锁）
        var result = SecureStorage.GetAsync("text").GetAwaiter().GetResult();
        byte[] bytes = Encoding.ASCII.GetBytes(result);
        
        // 主线程执行弹窗操作
        _ = MainThread.InvokeOnMainThreadAsync(ShowPopup);
        
        return bytes;
    }

    public async Task ShowPopup()
    {
        bool isAppForeground = Application.Current?.MainPage != null;

        if (!isAppForeground)
        {
#if ANDROID
            // 启动应用到前台
            var context = Android.App.Application.Context;
            var launchIntent = context.PackageManager.GetLaunchIntentForPackage(context.PackageName);
            launchIntent.AddFlags(Android.Content.ActivityFlags.ClearTop | Android.Content.ActivityFlags.NewTask);
            context.StartActivity(launchIntent);
            // 等待应用完成前台切换
            await Task.Delay(1000);
#endif
        }

        // 显示弹窗
        var confirmationPopup = new ConfirmationPopUpPage { Title = "Sent" };
        await PopupAction.DisplayPopup(confirmationPopup);
        await Task.Delay(1000);
        PopupAction.ClosePopup();
    }
}

2. 修复PopupAction的关闭逻辑 #

避免依赖Shell，直接使用导航栈关闭弹窗：

public static async Task ClosePopup(object returnValue = null)
{
    if (Application.Current?.MainPage != null && Application.Current.MainPage.Navigation.ModalStack.Count > 0)
    {
        try
        {
            var currentPopup = Application.Current.MainPage.Navigation.ModalStack.LastOrDefault() as PopUpBasePage;
            currentPopup?.returnResultTask.TrySetResult(returnValue);
        }
        catch { }
        await Application.Current.MainPage.Navigation.PopModalAsync();
    }
}

3. 添加Android权限 #

在Platforms/Android/AndroidManifest.xml中添加：

<uses-permission android:name="android.permission.POST_NOTIFICATIONS" />

解决方案二：后台用通知引导，前台直接弹窗 #

如果不想强制唤醒应用到前台，可采用更合规的通知方案：

1. 修改HCE服务的弹窗逻辑 #

public async Task ShowPopup()
{
    bool isAppForeground = Application.Current?.MainPage != null;

    if (!isAppForeground)
    {
#if ANDROID
        // 创建通知渠道（Android 8.0+必填）
        var notificationManager = Android.App.Application.Context.GetSystemService(Android.Content.Context.NotificationService) as Android.App.NotificationManager;
        const string channelId = "hce_notify_channel";
        
        if (Android.OS.Build.VERSION.SdkInt >= Android.OS.BuildVersionCodes.O)
        {
            var channel = new Android.App.NotificationChannel(channelId, "HCE操作通知", Android.App.NotificationImportance.Default)
            {
                Description = "HCE数据发送完成提示"
            };
            notificationManager.CreateNotificationChannel(channel);
        }

        // 点击通知打开弹窗的Intent
        var intent = new Android.Content.Intent(Android.App.Application.Context, typeof(MainActivity));
        intent.PutExtra("TriggerPopup", true);
        intent.AddFlags(Android.Content.ActivityFlags.ClearTop | Android.Content.ActivityFlags.SingleTop);
        var pendingIntent = Android.App.PendingIntent.GetActivity(Android.App.Application.Context, 0, intent, Android.App.PendingIntentFlags.UpdateCurrent | Android.App.PendingIntentFlags.Immutable);

        // 构建并发送通知
        var notification = new Android.App.Notification.Builder(Android.App.Application.Context, channelId)
            .SetContentTitle("数据发送完成")
            .SetContentText("点击查看详情")
            .SetSmallIcon(Resource.Drawable.ic_notification) // 替换为你的通知图标
            .SetContentIntent(pendingIntent)
            .SetAutoCancel(true)
            .Build();
        
        notificationManager.Notify(1, notification);
#endif
        return;
    }

    // 前台直接弹窗
    var confirmationPopup = new ConfirmationPopUpPage { Title = "Sent" };
    await PopupAction.DisplayPopup(confirmationPopup);
    await Task.Delay(1000);
    PopupAction.ClosePopup();
}

2. 在MainActivity中处理通知跳转 #

protected override void OnResume()
{
    base.OnResume();
    if (Intent?.GetBooleanExtra("TriggerPopup", false) == true)
    {
        _ = MainThread.InvokeOnMainThreadAsync(async () =>
        {
            var confirmationPopup = new ConfirmationPopUpPage { Title = "Sent" };
            await PopupAction.DisplayPopup(confirmationPopup);
            await Task.Delay(1000);
            PopupAction.ClosePopup();
        });
        // 清除Extra，防止重复触发
        Intent.RemoveExtra("TriggerPopup");
    }
}

关键注意事项 #

• 所有UI操作必须通过MainThread.InvokeOnMainThreadAsync执行，避免跨线程异常
• Android 10+对后台唤醒应用限制严格，方案一可能在部分设备上被系统拦截，方案二更合规
• 替换通知图标时，需在Android资源中添加对应图标

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