App Center功能启用失败及Xamarin.Forms安卓端Azure AD认证异常问询

我碰到过不少开发者遇到类似的场景，结合你用的AppCenter版本和Xamarin.Forms Android环境，咱们一步步拆解问题、解决掉：

1. 先排查初始化顺序冲突 #

AppCenter 1.5.0的启动逻辑如果跑在AAD认证之前，很可能会干扰Android WebView的缓存或认证会话状态。你可以调整下代码顺序：

• 先检查AAD的本地令牌缓存，确认有有效令牌后再初始化AppCenter
• 示例代码：

// 优先尝试静默获取缓存的AAD令牌
try
{
    var accounts = await _authClient.GetAccountsAsync();
    if (accounts.Any())
    {
        var authResult = await _authClient.AcquireTokenSilent(scopes, accounts.First())
            .ExecuteAsync();
        // 确认令牌有效后，再启动AppCenter
        AppCenter.Start("android={你的Android应用Secret};", typeof(Analytics), typeof(Crashes));
    }
}
catch (MsalUiRequiredException)
{
    // 无缓存令牌时再触发交互式认证，之后再启动AppCenter
    var result = await _authClient.AcquireTokenInteractive(scopes).ExecuteAsync();
    AppCenter.Start("android={你的Android应用Secret};", typeof(Analytics), typeof(Crashes));
}

2. 修复WebView Cookie持久化问题 #

AAD认证的会话依赖WebView的Cookie存储，旧版本AppCenter的部分组件可能会重置WebView的Cookie策略。你可以手动配置AAD认证的WebView：

• 在Android项目的MainActivity里，给AAD客户端指定自定义WebUi并确保Cookie持久化：

var aadBuilder = PublicClientApplicationBuilder
    .Create(你的ClientId)
    .WithRedirectUri($"msal{你的ClientId}://auth")
    .WithAndroidRedirectUri($"msal{你的ClientId}://auth");
// 配置自定义WebUi保证Cookie不丢失
aadBuilder.WithCustomWebUi(new AndroidCustomWebUi(this));
var _authClient = aadBuilder.Build();

同时检查AndroidManifest.xml里的权限配置，确保网络和Cookie存储权限正常：

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

3. 升级AppCenter到稳定版本 #

1.5.0是比较老旧的版本了，这个版本和MSAL（AAD认证库）存在已知的兼容性bug。建议直接升级到最新的稳定版（比如4.x系列），很多旧版本的冲突问题都已经被修复：

• 打开NuGet包管理器，找到Microsoft.AppCenter、Microsoft.AppCenter.Analytics、Microsoft.AppCenter.Crashes，选择更新到最新稳定版即可。

4. 解决认证完成后的错误网页问题 #

这个错误网页是因为重定向URL没有被App正确捕获，导致WebView加载了无效页面。你需要确认两个配置：

• 在Azure AD应用注册后台，已经把msal{你的ClientId}://auth添加为有效的重定向URI
• Android项目的AndroidManifest.xml里配置了对应的intent-filter，用来捕获重定向：

<intent-filter>
    <action android:name="android.intent.action.VIEW" />
    <category android:name="android.intent.category.DEFAULT" />
    <category android:name="android.intent.category.BROWSABLE" />
    <data android:scheme="msal{你的ClientId}" />
</intent-filter>

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