Рекомендации по использованию 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 |
| Ecosia | com.ecosia.android |
| Kiwi | com.kiwibrowser.browser |
| Brave | com.brave.browser |
Результаты нашего тестирования показали, что помимо браузеров с поддержкой настраиваемых вкладок с проверкой подлинности могут работать и некоторые другие браузеры. К ним относятся Opera, Opera Mini, InBrowser и Maxthon.
Протестированные устройства и браузеры
В следующей таблице перечислены устройства и браузеры, для которых подтверждена совместимость с проверкой подлинности.
| Устройство | Браузер | Результат |
|---|---|---|
| Huawei/One+ | Chrome* | Пройдено |
| Huawei/One+ | Edge* | Пройдено |
| Huawei/One+ | Firefox* | Пройдено |
| Huawei/One+ | Brave* | Пройдено |
| One+ | Ecosia* | Пройдено |
| One+ | Kiwi* | Пройдено |
| Huawei/One+ | Opera | Пройдено |
| Huawei | OperaMini | Пройдено |
| Huawei/One+ | InBrowser | Пройдено |
| One+ | Maxthon | Пройдено |
| Huawei/One+ | DuckDuckGo | Пользователь отменил проверку подлинности. |
| Huawei/One+ | UC Browser | Пользователь отменил проверку подлинности. |
| One+ | Dolphin | Пользователь отменил проверку подлинности. |
| One+ | CM Browser | Пользователь отменил проверку подлинности. |
| Huawei/One+ | Не установлено | Исключение AndroidActivityNotFound |
* Поддерживает настраиваемые вкладки
Известные проблемы
Если на устройстве не включен ни один браузер, MSAL.NET создаст исключение AndroidActivityNotFound.
- Решение: предложите пользователю включить браузер на этом устройстве. Порекомендуйте выбрать браузер, поддерживающий настраиваемые вкладки.
Если проверка подлинности завершается сбоем (например, при запуске с сайта DuckDuckGo), MSAL.NET создаст исключение AuthenticationCanceled MsalClientException.
- Причина проблемы: на устройстве не включен ни один браузер, поддерживающий настраиваемые вкладки. Проверка подлинности запущена в браузере, который не может ее выполнить.
- Решение: предложите пользователю включить браузер на этом устройстве. Порекомендуйте выбрать браузер, поддерживающий настраиваемые вкладки.
Следующие шаги
Дополнительные сведения и примеры кода см. в разделах Выбор между встроенным веб-браузером и системным браузером Xamarin Android или Встроенный и системный веб-интерфейс.