Xamarin.Essentials: Prohlížeč

Třída prohlížeče umožňuje aplikaci otevřít webový odkaz v upřednostňovaném prohlížeči optimalizovaného systému nebo v externím prohlížeči.

Začínáme

Pokud chcete začít používat toto rozhraní API, přečtěte si příručku Začínáme pro, abyste měli jistotu, že je knihovna správně nainstalovaná a nastavená ve vašich projektech.

Pro přístup k funkcím prohlížeče se vyžaduje následující nastavení pro konkrétní platformu.

Pokud je cílová verze Androidu vašeho projektu nastavená na Android 11 (R API 30) , musíte aktualizovat manifest pro Android pomocí dotazů, které se používají s novými požadavky na viditelnost balíčku.

Ve složce Properties (vlastnosti ) otevřete soubor AndroidManifest.xml a přidejte následující dovnitř uzlu 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>

Použití prohlížeče

Do třídy přidejte odkaz Xamarin.Essentials :

using Xamarin.Essentials;

Funkce prohlížeče funguje zavoláním OpenAsync metody s Uri a 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.
        }
    }
}

Tato metoda se vrátí po spuštění prohlížeče a nemusí nutně být zavřena uživatelem. boolVýsledek označuje, zda bylo spuštění úspěšné nebo ne.

Přizpůsobení

Při použití preferovaného prohlížeče systému máte k dispozici několik možností přizpůsobení pro iOS a Android. To zahrnuje TitleMode (jenom Android) a preferované možnosti barev pro Toolbar (iOS a Android) a Controls (jenom iOS), které se zobrazí.

Tyto možnosti jsou určeny pomocí BrowserLaunchOptions při volání metody OpenAsync .

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

Možnosti prohlížeče

Specifické pro implementaci platformy

Režim spuštění určuje způsob, jakým se prohlížeč spouští:

Upřednostňované pro systém

Vlastní karty se pokusí použít k načtení identifikátoru URI a udržení povědomí o navigaci.

Externí

Použije se Intent k vyžádání identifikátoru URI, který se otevře v normálním prohlížeči systému.

rozhraní API

Další videa Xamarin najdete na webu Channel 9 a YouTube.