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
});

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
- Xamarin. Essentials /browser "data-LINKTYPE =" external ">zdrojového kódu prohlížeče
- Dokumentace k rozhraní API prohlížeče