Поделиться через


Рекомендации по использованию MSAL.NET в системном браузере Xamarin Android

В этой статье рассматриваются вопросы, которые следует учитывать при использовании системного браузера Xamarin Android с библиотекой проверки подлинности Майкрософт для .NET (MSAL.NET).

Примечание.

MSAL.NET версии 4.61.0 и выше не поддерживают универсальную платформу Windows (UWP), Xamarin Android и Xamarin iOS. Мы рекомендуем перенести приложения Xamarin в современные платформы, такие как MAUI. Подробнее об устаревании в объявлении о предстоящем устаревании MSAL.NET для Xamarin и UWP.

Начиная с MSAL.NET 2.4.0 Preview, эта библиотека поддерживает не только Chrome, но и другие браузеры. Теперь не требуется устанавливать Chrome для проверки подлинности на устройстве Android.

Мы рекомендуем использовать браузеры, которые поддерживают настраиваемые вкладки. Вот несколько примеров таких браузеров:

Браузеры с поддержкой настраиваемых вкладок Имя пакета
Chrome com.android.chrome
Microsoft Edge com.microsoft.emmx
Firefox org.mozilla.firefox
Экосия com.ecosia.android
Киви com.kiwibrowser.browser
Смелый com.brave.browser

Наше тестирование показало, что помимо браузеров, поддерживающих настраиваемые вкладки, для аутентификации также работают некоторые браузеры, которые не поддерживают настраиваемые вкладки. К ним относятся Opera, Opera Mini, InBrowser и Maxthon.

Протестированные устройства и браузеры

В следующей таблице перечислены устройства и браузеры, для которых подтверждена совместимость с проверкой подлинности.

Устройство Браузер Результат
Huawei/One+ Хром* Пройдено
Huawei/One+ Край* Пройдено
Huawei/One+ Firefox* Допуск
Huawei/One+ Браво* Пассат
One+ Экосия* Пройдено
One+ Киви* Пройдено
Huawei/One+ Опера Пройдено
Хуавей ОпераМини Пропуск
Huawei/One+ InBrowser Пройдено
One+ Макстон Пропустить
Huawei/One+ DuckDuckGo Пользователь отменил проверку подлинности.
Huawei/One+ Браузер UC Пользователь отменил проверку подлинности.
One+ Дельфин Пользователь отменил проверку подлинности.
One+ Браузер CM Пользователь отменил проверку подлинности.
Huawei/One+ Не установлено Исключение AndroidActivityNotFound

* Поддерживает настраиваемые вкладки

Известные проблемы

Если на устройстве не включен ни один браузер, MSAL.NET создаст исключение AndroidActivityNotFound.

  • Решение: предложите пользователю включить браузер на этом устройстве. Порекомендуйте выбрать браузер, поддерживающий настраиваемые вкладки.

Если проверка подлинности завершается сбоем (например, при аутентификации с использованием DuckDuckGo), MSAL.NET вернет AuthenticationCanceled MsalClientException.

  • Причина проблемы: на устройстве не включен ни один браузер, поддерживающий настраиваемые вкладки. Проверка подлинности запущена в браузере, который не может ее выполнить.
  • Решение: предложите пользователю включить браузер на этом устройстве. Порекомендуйте выбрать браузер, поддерживающий настраиваемые вкладки.

Следующие шаги

Дополнительные сведения и примеры кода см. в разделах Выбор между встроенным веб-браузером и системным браузером Xamarin Android или Встроенный и системный веб-интерфейс.