MAUI应用如何恢复至视觉顶层？跨平台处理及原位置还原方法

MAUI没有内置的跨平台API直接实现应用置顶/还原，需通过**依赖服务（Dependency Service）**调用各平台原生代码完成。以下是针对紧急事件触发场景的完整实现步骤：

一、核心思路 #

1. 定义跨平台接口统一操作入口
2. 针对Android、iOS、Windows分别编写原生实现
3. 紧急事件触发时：先记录应用原状态/位置，再将应用置顶
4. 用户响应完成后：根据记录的原信息还原应用位置/状态

二、跨平台操作步骤 #

1. 定义共享接口（Shared项目） #

先在共享项目中定义统一的窗口管理接口，封装置顶、保存状态、还原操作：

public interface IAppWindowManager
{
    // 将应用移至视觉顶层
    void BringToFront();
    // 保存当前应用窗口的位置/状态
    void SaveCurrentPosition();
    // 还原至之前的位置/状态
    void RestoreOriginalPosition();
}

2. Android平台实现 #

在Platforms/Android目录下创建实现类：

[assembly: Dependency(typeof(AppWindowManager_Android))]
namespace YourAppNamespace.Platforms.Android;

public class AppWindowManager_Android : IAppWindowManager
{
    private bool _wasInBackground;

    public void BringToFront()
    {
        var currentActivity = Platform.CurrentActivity;
        if (currentActivity == null) return;

        // 记录应用是否原本处于后台
        _wasInBackground = !currentActivity.IsTaskRoot;
        // 将应用任务移至前台
        currentActivity.MoveTaskToFront();
        // 锁屏时强制唤醒并显示（可选，根据需求添加）
        currentActivity.Window.AddFlags(Android.Views.WindowManagerFlags.ShowWhenLocked | Android.Views.WindowManagerFlags.TurnScreenOn);
    }

    public void SaveCurrentPosition()
    {
        // Android系统自动管理窗口位置，无需额外记录
    }

    public void RestoreOriginalPosition()
    {
        // 如果应用原本在后台，将其移回后台
        if (_wasInBackground)
        {
            Platform.CurrentActivity?.MoveTaskToBack(true);
        }
    }
}

3. iOS平台实现 #

在Platforms/iOS目录下创建实现类：

[assembly: Dependency(typeof(AppWindowManager_iOS))]
namespace YourAppNamespace.Platforms.iOS;

public class AppWindowManager_iOS : IAppWindowManager
{
    private bool _wasInBackground;

    public void BringToFront()
    {
        // 获取处于后台的场景会话（iOS 13+推荐使用场景管理）
        var backgroundScene = UIApplication.SharedApplication.ConnectedScenes
            .FirstOrDefault(s => s.ActivationState == UISceneActivationState.Background) as UIWindowScene;
        
        _wasInBackground = backgroundScene != null;

        if (backgroundScene != null)
        {
            UIApplication.SharedApplication.ActivateSceneSession(backgroundScene.Session);
        }
        else
        {
            // 针对旧版本iOS，直接激活应用
            UIApplication.SharedApplication.BecomeActive();
        }
    }

    public void SaveCurrentPosition()
    {
        // iOS系统管理窗口层级，无需手动记录位置
    }

    public void RestoreOriginalPosition()
    {
        // 如果应用原本在后台，让其退至后台
        if (_wasInBackground)
        {
            UIApplication.SharedApplication.ResignActive();
        }
    }
}

4. Windows平台实现 #

在Platforms/Windows目录下创建实现类，需调用Win32 API操作窗口：

[assembly: Dependency(typeof(AppWindowManager_Windows))]
namespace YourAppNamespace.Platforms.Windows;

public class AppWindowManager_Windows : IAppWindowManager
{
    private RECT _originalWindowRect;
    private bool _hasSavedPosition;

    // Win32 API所需的矩形结构体
    [StructLayout(LayoutKind.Sequential)]
    private struct RECT
    {
        public int Left;
        public int Top;
        public int Right;
        public int Bottom;
    }

    // 导入Win32 API
    [DllImport("user32.dll")]
    private static extern bool SetForegroundWindow(IntPtr hWnd);

    [DllImport("user32.dll")]
    private static extern bool GetWindowRect(IntPtr hWnd, out RECT lpRect);

    [DllImport("user32.dll")]
    private static extern bool SetWindowPos(IntPtr hWnd, IntPtr hWndInsertAfter, int X, int Y, int cx, int cy, uint uFlags);

    private const uint SWP_NOZORDER = 0x0004; // 不改变窗口层级

    public void BringToFront()
    {
        var mainWindow = Microsoft.Maui.Controls.Application.Current.Windows.FirstOrDefault()?.Handler?.NativeView as Microsoft.UI.Xaml.Window;
        if (mainWindow == null) return;

        SaveCurrentPosition();
        // 将窗口置为前台
        SetForegroundWindow(mainWindow.WindowHandle);
    }

    public void SaveCurrentPosition()
    {
        var mainWindow = Microsoft.Maui.Controls.Application.Current.Windows.FirstOrDefault()?.Handler?.NativeView as Microsoft.UI.Xaml.Window;
        if (mainWindow != null && GetWindowRect(mainWindow.WindowHandle, out _originalWindowRect))
        {
            _hasSavedPosition = true;
        }
    }

    public void RestoreOriginalPosition()
    {
        if (!_hasSavedPosition) return;

        var mainWindow = Microsoft.Maui.Controls.Application.Current.Windows.FirstOrDefault()?.Handler?.NativeView as Microsoft.UI.Xaml.Window;
        if (mainWindow == null) return;

        // 还原窗口到之前的位置
        SetWindowPos(
            mainWindow.WindowHandle,
            IntPtr.Zero,
            _originalWindowRect.Left,
            _originalWindowRect.Top,
            _originalWindowRect.Right - _originalWindowRect.Left,
            _originalWindowRect.Bottom - _originalWindowRect.Top,
            SWP_NOZORDER
        );
    }
}

三、使用示例 #

在紧急事件触发时调用，用户完成响应后还原：

// 触发紧急事件时：保存状态并置顶
var windowManager = DependencyService.Get<IAppWindowManager>();
windowManager.SaveCurrentPosition();
windowManager.BringToFront();

// 用户完成响应后：还原至原位置/状态
windowManager.RestoreOriginalPosition();

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