imported>TechCorner-Redaktion: Neufassung von "Xamarin:Benutzerdefinierte Schriftart in App": MauiFont, ConfigureFonts, Icon-Fonts

2026-10-14T00:00:00Z

Neufassung von "Xamarin:Benutzerdefinierte Schriftart in App": MauiFont, ConfigureFonts, Icon-Fonts

Neue Seite

{{Steckbrief
| gilt_fuer = .NET MAUI 8 bis 10 auf Android, iOS, macOS und Windows
| bereich = Softwareentwicklung
| dauer = ca. 10 Minuten
| rechte = Entwicklungsumgebung; Lizenz der Schriftart für App-Einbettung
| stand = Oktober 2026
}}
'''Eigene Schriftarten in .NET MAUI einbinden''' ist deutlich einfacher als früher unter Xamarin: Statt die Schrift je Plattform als Asset bzw. Bundle-Ressource zu hinterlegen und in der <code>Info.plist</code> zu registrieren, legen Sie die Datei einmal in den Ordner <code>Resources/Fonts</code> und registrieren sie in <code>MauiProgram.cs</code>. Danach steht sie auf allen Plattformen unter einem Alias zur Verfügung.

[[Datei:NET-MAUI-Schriftarten.png|thumb|center|750px|Eigene Schriftarten in .NET MAUI: Datei in Resources/Fonts ablegen, in MauiProgram.cs mit Alias registrieren und per FontFamily verwenden.]]

== Problem ==
* Eine eigene Schrift (z. B. die Hausschrift) wird in der App nicht angezeigt; Android, iOS oder Windows fallen auf die Systemschrift zurück.
* In migrierten Xamarin-Apps funktionieren die alten Verfahren (<code>Typeface.CreateFromAsset</code>, <code>UIAppFonts</code>) nicht mehr wie gewohnt.

== Lösung ==
=== Schritt 1: Schriftdatei ablegen ===
Die Datei (<code>.ttf</code> oder <code>.otf</code>) in den Projektordner '''<code>Resources/Fonts</code>''' kopieren. Die Projektvorlage enthält bereits den passenden Eintrag, der alle Dateien dort automatisch als <code>MauiFont</code> einbindet:
<syntaxhighlight lang="xml">
<ItemGroup>
<MauiFont Include="Resources\Fonts\*" />
</ItemGroup>
</syntaxhighlight>
In Visual Studio muss die Buildaktion der Datei '''MauiFont''' lauten.

=== Schritt 2: Schrift registrieren ===
In <code>MauiProgram.cs</code>:
<syntaxhighlight lang="csharp">
builder
.UseMauiApp<App>()
.ConfigureFonts(fonts =>
{
fonts.AddFont("OpenSans-Regular.ttf", "OpenSansRegular");
fonts.AddFont("Exo-SemiBoldItalic.ttf", "ExoHeadline"); // eigener Alias
});
</syntaxhighlight>
Der erste Parameter ist der '''Dateiname''', der zweite ein frei wählbarer '''Alias'''.

=== Schritt 3: Schrift verwenden ===
In XAML:
<syntaxhighlight lang="xml">
<Label Text="Willkommen" FontFamily="ExoHeadline" FontSize="24" />
</syntaxhighlight>
Oder app-weit als Stil in <code>Resources/Styles/Styles.xaml</code>:
<syntaxhighlight lang="xml">
<Style TargetType="Label">
<Setter Property="FontFamily" Value="OpenSansRegular" />
</Style>
</syntaxhighlight>
Im C#-Code: <code>label.FontFamily = "ExoHeadline";</code>

=== Icon-Fonts nutzen ===
Icon-Schriften wie Font Awesome oder Fluent UI System Icons werden genauso registriert und über eine <code>FontImageSource</code> als Symbol verwendet:
<syntaxhighlight lang="xml">
<Button Text="Speichern">
<Button.ImageSource>
<FontImageSource FontFamily="FluentIcons" Glyph="" Size="20" />
</Button.ImageSource>
</Button>
</syntaxhighlight>

== Hinweise ==
* '''Alias statt Dateiname:''' Für <code>FontFamily</code> immer den Alias aus <code>AddFont</code> verwenden. Der früher unter iOS nötige interne Schriftname entfällt.
* '''Schriftschnitte:''' Fett und Kursiv werden nicht künstlich erzeugt – jede Variante (Regular, Bold, Italic) als eigene Datei mit eigenem Alias registrieren.
* '''Lizenz prüfen:''' Viele Desktop-Schriftlizenzen erlauben das Einbetten in Apps nicht. Frei nutzbar sind z. B. Schriften unter der SIL Open Font License (Google Fonts).
* '''Neu bauen:''' Nach dem Hinzufügen einer Schrift die App vollständig neu bauen; bei Problemen die Ordner <code>bin</code> und <code>obj</code> löschen.
* Bei der Umsetzung Ihres Corporate Designs in Apps unterstützt Sie die [https://www.max-it.de/development/individuelle-softwareentwicklung/ individuelle Softwareentwicklung von m.a.x. it].

== Siehe auch ==
* [[Von Xamarin zu .NET MAUI migrieren]]
* [[.NET MAUI: Ladeanzeige mit ActivityIndicator]]

== Links und Quellen ==
* [https://learn.microsoft.com/de-de/dotnet/maui/user-interface/fonts Microsoft Learn: Schriftarten in .NET MAUI]
* [https://www.max-it.de/development/individuelle-softwareentwicklung/ Individuelle Softwareentwicklung und App-Entwicklung von m.a.x. it]

{{Uebermax}}
[[Kategorie:Softwareentwicklung]]

.NET MAUI: Eigene Schriftarten einbinden - Versionsgeschichte

imported>TechCorner-Redaktion: Neufassung von "Xamarin:Benutzerdefinierte Schriftart in App": MauiFont, ConfigureFonts, Icon-Fonts