Zagadnienia dotyczące korzystania z przeglądarki systemu Xamarin Dla systemu Android dotyczące korzystania z MSAL.NET
W tym artykule omówiono, co należy wziąć pod uwagę podczas korzystania z przeglądarki systemowej na platformie Xamarin Android z biblioteką Microsoft Authentication Library for .NET (MSAL.NET).
Uwaga
MSAL.NET w wersji 4.61.0 lub nowszej nie zapewniają obsługi platforma uniwersalna systemu Windows (UWP), Xamarin Android i Xamarin iOS. Zalecamy migrację aplikacji platformy Xamarin do nowoczesnych struktur, takich jak MAUI. Przeczytaj więcej o wycofaniu w temacie Ogłaszanie nadchodzącego wycofania MSAL.NET dla platform Xamarin i platformy UWP.
Począwszy od wersji zapoznawczej MSAL.NET 2.4.0, MSAL.NET obsługuje przeglądarki inne niż Chrome. Na urządzeniu z systemem Android nie trzeba już instalować przeglądarki Chrome na potrzeby uwierzytelniania.
Zalecamy używanie przeglądarek obsługujących karty niestandardowe. Oto kilka przykładów tych przeglądarek:
| Przeglądarki z obsługą kart niestandardowych | Nazwa pakietu |
|---|---|
| Chrome | com.android.chrome |
| Microsoft Edge | com.microsoft.emmx |
| Firefox | org.mozilla.firefox |
| Ecosia | com.ecosia.android |
| Kiwi | com.kiwibrowser.browser |
| Odważny | com.brave.browser |
Oprócz identyfikowania przeglądarek, które oferują obsługę kart niestandardowych, nasze testy wskazują, że kilka przeglądarek, które nie obsługują kart niestandardowych, również działają na potrzeby uwierzytelniania. Te przeglądarki obejmują Opera, Opera Mini, InBrowser i Maxthon.
Przetestowane urządzenia i przeglądarki
W poniższej tabeli wymieniono urządzenia i przeglądarki, które zostały przetestowane pod kątem zgodności uwierzytelniania.
| Urządzenie | Przeglądarka | Result |
|---|---|---|
| Huawei/One+ | Chrom* | Zdane |
| Huawei/One+ | Brzeg* | Zdane |
| Huawei/One+ | Firefox* | Zdane |
| Huawei/One+ | Odważny* | Zdane |
| Jeden+ | Ecosia* | Zdane |
| Jeden+ | Kiwi* | Zdane |
| Huawei/One+ | Opera | Zdane |
| Huawei | OperaMini | Zdane |
| Huawei/One+ | InBrowser | Zdane |
| Jeden+ | Maxthon | Zdane |
| Huawei/One+ | DuckDuckGo | Użytkownik anulował uwierzytelnianie |
| Huawei/One+ | Przeglądarka UC | Użytkownik anulował uwierzytelnianie |
| Jeden+ | Delfin | Użytkownik anulował uwierzytelnianie |
| Jeden+ | Przeglądarka CM | Użytkownik anulował uwierzytelnianie |
| Huawei/One+ | Brak zainstalowanych | Wyjątek AndroidActivityNotFound |
* Obsługuje karty niestandardowe
Znane problemy
Jeśli użytkownik nie ma włączonej przeglądarki na urządzeniu, MSAL.NET zgłosi wyjątek AndroidActivityNotFound .
- Środki zaradcze: poproś użytkownika o włączenie przeglądarki na swoim urządzeniu. Zalecamy przeglądarkę, która obsługuje karty niestandardowe.
Jeśli uwierzytelnianie zakończy się niepowodzeniem (na przykład jeśli uwierzytelnianie zostanie uruchomione z usługą DuckDuckGo), MSAL.NET zwróci wartość AuthenticationCanceled MsalClientException.
- Główny problem: przeglądarka obsługująca karty niestandardowe nie została włączona na urządzeniu. Uwierzytelnianie zostało uruchomione przy użyciu przeglądarki, która nie mogła ukończyć uwierzytelniania.
- Środki zaradcze: poproś użytkownika o włączenie przeglądarki na swoim urządzeniu. Zalecamy przeglądarkę, która obsługuje karty niestandardowe.
Następne kroki
Aby uzyskać więcej informacji i przykładów kodu, zobacz Wybieranie między osadzoną przeglądarką internetową a przeglądarką systemową na platformie Xamarin Android i osadzonym a systemowym internetowym interfejsem użytkownika.