MAUI应用如何接收回调URL的响应及传递的code参数？

一、核心原理 #

你要实现的是**深度链接（Deep Link）**功能：API通过回调URL唤起MAUI应用，并传递code参数。MAUI需要配置平台特定的URL关联规则，同时在应用内完成参数提取与业务处理。

二、Android端正确配置（解决你之前的Activity报错问题） #

无需额外创建新Activity，直接复用现有MainActivity即可，避免注册冲突：

1. 打开Platforms/Android/AndroidManifest.xml，找到主Activity节点（通常是[你的应用名].MainActivity），添加以下intent-filter：

<intent-filter android:autoVerify="true">
    <action android:name="android.intent.action.VIEW" />
    <category android:name="android.intent.category.DEFAULT" />
    <category android:name="android.intent.category.BROWSABLE" />
    <!-- 匹配你的回调URL：https://myappname -->
    <data android:scheme="https" android:host="myappname" />
</intent-filter>

• 若回调URL使用自定义scheme（如myapp://myappname），将android:scheme改为myapp即可。
• android:autoVerify="true"用于验证域名归属（https scheme必填，防止其他应用拦截回调）。

2. 确保MainActivity正确继承MauiAppCompatActivity，示例代码：

namespace YourAppName;

[Activity(Theme = "@style/Maui.SplashTheme", MainLauncher = true, ConfigurationChanges = ConfigChanges.ScreenSize | ConfigChanges.Orientation | ConfigChanges.UiMode | ConfigChanges.ScreenLayout | ConfigChanges.SmallestScreenSize | ConfigChanges.Density)]
public class MainActivity : MauiAppCompatActivity
{
}

三、MAUI应用内处理回调参数 #

在App.xaml.cs中重写OnAppLinkRequestReceived方法，该方法会在应用被深度链接唤起时触发，用于提取code参数：

using System.Web;

namespace YourAppName;

public partial class App : Application
{
    public App()
    {
        InitializeComponent();
        MainPage = new MainPage();
    }

    protected override void OnAppLinkRequestReceived(Uri uri)
    {
        base.OnAppLinkRequestReceived(uri);
        // 解析URL中的query参数
        var queryParams = HttpUtility.ParseQueryString(uri.Query);
        string code = queryParams["code"];
        
        // 处理code参数（如保存到本地、跳转业务页面等）
        if (!string.IsNullOrEmpty(code))
        {
            // 示例：传递给主页面处理
            if (MainPage is MainPage mainPage)
            {
                mainPage.HandleCallbackCode(code);
            }
        }
    }
}

• .NET 7+的MAUI项目需手动安装System.Web NuGet包（右键项目→管理NuGet包→搜索System.Web安装）。

四、排查之前的Activity报错 #

你新增Activity报错的常见原因：

1. 新Activity未继承MauiAppCompatActivity，无法兼容MAUI框架。
2. 新Activity未在AndroidManifest.xml中正确注册（缺少<activity>节点）。
3. 重复配置intent-filter，导致系统无法识别正确的唤起入口。
   直接复用MainActivity可避免上述问题。

五、测试验证 #

1. 确保API调用时的回调URL与配置完全一致（如https://myappname?code=test123）。
2. 通过Postman调用API触发回调，系统会自动唤起MAUI应用，此时OnAppLinkRequestReceived方法执行，即可获取code参数。

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