Udostępnij za pośrednictwem

Xamarin.Essentials:Przeglądarka

  • Artykuł

Klasa Browser umożliwia aplikacji otwieranie linku internetowego w zoptymalizowanej przeglądarce preferowanej przez system lub w przeglądarce zewnętrznej.

Rozpocznij

Aby rozpocząć korzystanie z tego interfejsu API, przeczytaj przewodnik wprowadzający , Xamarin.Essentials aby upewnić się, że biblioteka jest prawidłowo zainstalowana i skonfigurowana w projektach.

Aby uzyskać dostęp do funkcji przeglądarki , wymagana jest następująca konfiguracja specyficzna dla platformy.

Jeśli docelowa wersja systemu Android projektu jest ustawiona na Android 11 (R API 30), musisz zaktualizować manifest systemu Android za pomocą zapytań, które są używane z nowymi wymaganiami dotyczącymi widoczności pakietu.

Otwórz plik AndroidManifest.xml w folderze Właściwości i dodaj następujące elementy w węźle manifestu:

<queries>
  <intent>
    <action android:name="android.intent.action.VIEW" />
    <data android:scheme="http"/>
  </intent>
  <intent>
    <action android:name="android.intent.action.VIEW" />
    <data android:scheme="https"/>
  </intent>
</queries>

Korzystanie z przeglądarki

Dodaj odwołanie do Xamarin.Essentials klasy:

using Xamarin.Essentials;

Funkcja Przeglądarki działa przez wywołanie OpenAsync metody za Uri pomocą metody i BrowserLaunchMode.


public class BrowserTest
{
    public async Task OpenBrowser(Uri uri)
    {
        try
        {
            await Browser.OpenAsync(uri, BrowserLaunchMode.SystemPreferred);
        }
        catch(Exception ex)
        {
            // An unexpected error occured. No browser may be installed on the device.
        }
    }
}

Ta metoda zwraca wartość po uruchomieniu przeglądarki i niekoniecznie jest zamknięta przez użytkownika.

Dostosowanie

W przypadku korzystania z preferowanej przeglądarki systemu dostępnych jest kilka opcji dostosowywania dla systemów iOS i Android. Obejmuje TitleMode to (tylko system Android) i preferowane opcje kolorów (tylko systemy Toolbar iOS i Android) i Controls (tylko system iOS).

Te opcje są określane przy użyciu podczas BrowserLaunchOptions wywoływania metody OpenAsync.

await Browser.OpenAsync(uri, new BrowserLaunchOptions
                {
                    LaunchMode = BrowserLaunchMode.SystemPreferred,
                    TitleMode = BrowserTitleMode.Show,
                    PreferredToolbarColor = Color.AliceBlue,
                    PreferredControlColor = Color.Violet
                });

Opcje przeglądarki

Specyfika implementacji platformy

Tryb uruchamiania określa sposób uruchamiania przeglądarki:

Preferowany system

Niestandardowe karty zostaną użyte do załadowania identyfikatora URI i zachowania świadomości nawigacji.

Zewnętrzne

Element Intent będzie używany do żądania otwarcia identyfikatora URI za pośrednictwem normalnej przeglądarki systemów.

interfejs API

Więcej filmów na platformie Xamarin można znaleźć w witrynach Channel 9 i YouTube.