Přidání úvodní obrazovky do projektu aplikace .NET MAUI

  • Článek
  • 2 min ke čtení

V systémech Android a iOS můžou aplikace .NET Multi-platform App UI (.NET MAUI) během inicializace zobrazovat úvodní obrazovku. Úvodní obrazovka se zobrazí okamžitě po spuštění aplikace a poskytne uživatelům okamžitou zpětnou vazbu, zatímco se inicializují prostředky aplikace:

Snímek obrazovky úvodní obrazovky .NET MAUI

Jakmile je aplikace připravená na interakci, úvodní obrazovka se zavře.

V projektu aplikace .NET MAUI je možné úvodní obrazovku zadat v jednom umístění projektu aplikace a v době sestavení se dá automaticky změnit na správné rozlišení cílové platformy a zařízení a přidat je do balíčku aplikace. Tím se nemusíte ručně duplikovat a pojmenovat úvodní obrazovku na jednotlivých platformách. Ve výchozím nastavení nejsou rastrové obrázky (bez vektoru) automaticky změněny pomocí rozhraní .NET MAUI.

Úvodní obrazovka .NET MAUI může používat některý ze standardních formátů obrázků platformy, včetně souborů SVG (Scalable Vector Graphics).

Důležité

.NET MAUI převádí soubory SVG na soubory PNG. Proto při přidávání souboru SVG do projektu aplikace .NET MAUI by se měl odkazovat z XAML nebo C# s příponou .png. Jediný odkaz na soubor SVG by měl být v souboru projektu.

Úvodní obrazovku můžete do projektu aplikace přidat přetažením obrázku do složky Resources\Splash projektu, kde se akce sestavení automaticky nastaví na MauiSplashScreen. Tím se vytvoří odpovídající položka v souboru projektu:

<ItemGroup>
  <MauiSplashScreen Include="Resources\Splash\splashscreen.svg" />
</ItemGroup>

Poznámka

Úvodní obrazovku můžete přidat také do dalších složek projektu aplikace. V tomto scénáři však musí být akce sestavení ručně nastavena na MauiSplashScreen v okně Vlastnosti .

Aby bylo možné dodržovat pravidla pojmenování prostředků Androidu, musí mít názvy souborů úvodní obrazovky malá písmena, začínat a končit písmenem a obsahovat pouze alfanumerické znaky nebo podtržítka. Další informace najdete v tématu Přehled prostředků aplikací na developer.android.com.

Základní velikost úvodní obrazovky lze určit nastavením atributu BaseSize na hodnoty, které jsou dělitelné hodnotou 8:

<MauiSplashScreen Include="Resources\Splash\splashscreen.jpg" BaseSize="128,128" />

Hodnota atributu BaseSize představuje základní hustotu úvodní obrazovky a je efektivně faktor měřítka 1,0 pro úvodní obrazovku, ze které jsou odvozeny všechny ostatní velikosti hustoty. Tato hodnota se použije k zajištění správné velikosti úvodních obrazovek na různé hustoty zobrazení. Pokud neurčíte BaseSize úvodní obrazovku založenou na rastrovém obrázku, obrázek se nedá změnit. Pokud nezadáte BaseSize hodnotu pro úvodní obrazovku založenou na vektoru, předpokládá se, že rozměry zadané ve formátu SVG budou základní velikostí. Pokud chcete zastavit změnu velikosti vektorových obrázků, nastavte Resize atribut na false:

<MauiSplashScreen Include="Resources\Splash\splashscreen.svg" Resize="false" />

Pokud chcete přidat barevný nádech na úvodní obrazovku, což je užitečné, když máte jednoduchý obrázek, který chcete pro zdroj vykreslit jinou barvou, nastavte TintColor atribut:

<MauiSplashScreen Include="Resources\Splash\splashscreen.svg" TintColor="#66B3FF" />

Můžete také zadat barvu pozadí úvodní obrazovky:

<MauiSplashScreen Include="Resources\Splash\splashscreen.svg" Color="#512BD4" />

Hodnoty barev lze zadat v šestnáctkové nebo jako barva .NET MAUI. Je například Color="Red" platný.

V době sestavení můžete změnit velikost úvodní obrazovky na správné rozlišení cílové platformy a zařízení. Výsledná úvodní obrazovka se pak přidá do balíčku aplikace.

Na Androidu se úvodní obrazovka přidá do balíčku aplikace jako Resourcs/values/maui_colors.xml a Resources/drawable/maui_splash_image.xml. Aplikace .NET MAUI používají Maui.SplashTheme ve výchozím nastavení, což zajišťuje, že se v případě přítomnosti zobrazí úvodní obrazovka. Proto byste neměli v souboru manifestu ani ve třídě MainActivity zadávat jiný motiv:

using Android.App;
using Android.Content.PM;

namespace MyMauiApp
{
      [Activity(Theme = "@style/Maui.SplashTheme", MainLauncher = true, ConfigurationChanges = ConfigChanges.ScreenSize | ConfigChanges.Orientation | ConfigChanges.UiMode | ConfigChanges.ScreenLayout | ConfigChanges.SmallestScreenSize)]
      public class MainActivity : MauiAppCompatActivity
      {
      }
}

Pro pokročilejší scénáře úvodní obrazovky platí přístupy pro jednotlivé platformy.