Xamarin.Essentials:Prohlížeče
Třída Browser umožňuje aplikaci otevřít webový odkaz v optimalizovaném systému preferovaném prohlížeči nebo externím prohlížeči.
Začínáme
Pokud chcete začít používat toto rozhraní API, přečtěte si úvodní příručkuXamarin.Essentials, 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í specifické pro platformu.
Pokud je cílová verze androidu vašeho projektu nastavená na Android 11 (R API 30), musíte aktualizovat manifest Androidu pomocí dotazů, které se používají s novými požadavky na viditelnost balíčku.
Otevřete soubor AndroidManifest.xml ve složce Vlastnosti a přidejte do uzlu manifestu následující kód:
<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>
Pomocí prohlížeče
Přidejte do Xamarin.Essentials předmětu odkaz:
using Xamarin.Essentials;
Funkce prohlížeče funguje volá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í být nutně uzavřena uživatelem.
Vlastní nastavení
Při použití preferovaného prohlížeče systému je pro iOS a Android k dispozici několik možností přizpůsobení. To zahrnuje TitleMode (jenom Android) a upřednostňované možnosti barev pro Toolbar (iOS a Android) a Controls (jenom iOS).
Tyto možnosti se zadají při BrowserLaunchOptions volání OpenAsync.
await Browser.OpenAsync(uri, new BrowserLaunchOptions
{
LaunchMode = BrowserLaunchMode.SystemPreferred,
TitleMode = BrowserTitleMode.Show,
PreferredToolbarColor = Color.AliceBlue,
PreferredControlColor = Color.Violet
});
Specifika implementace platformy
Režim spuštění určuje, jak se prohlížeč spustí:
Upřednostňovaný systém
Vlastní karty se pokusí použít k načtení identifikátoru URI a zachování povědomí o navigaci.
Externí
Použije Intent se k vyžádání, aby identifikátor URI byl otevřen prostřednictvím normálního prohlížeče systémů.