Custom fonts not working when uploading Maui Android project to Play Store

Mujtaba Ali Panjwani 25

I have added custom fonts in the font directory of my Maui project's Resources directory and updated the MauiProgram.cs file accordingly. The fonts work fine when I deploy the application using Visual Studio, but when I publish the app and upload it to Play Store, the custom fonts are not working at all. Can someone please help me with this issue?

Thank you.

Yonglun Liu (Shanghai Wicresoft Co,.Ltd.) 47,281 Reputation points Microsoft Vendor

2024-05-22T02:58:41.25+00:00

Did you change the properties of the font file to MauiFont?

If the properties of the font file have been modified to MauiFont, please check whether font file packaging is disabled in the project file.

Please refer to Disable font packaging for more details.
Anton Moroder 0 Reputation points

2024-05-24T15:56:16.6733333+00:00

i have the same problem (publish the app and upload it to Play Store) after upgrade from net7 to net8. On iOS and WinUI work fine but on android not work.

anton
Olen Kirkland 0 Reputation points

2024-06-25T15:36:12.8333333+00:00

I'm experiencing the same issue. When deployed from the IDE to the Android emulator, the custom font icons display correctly. In published release versions, the icons are missing ([X] is shown instead).

I have verified that font file packaging is not disabled in the project file. This is an issue with Android releases only.

Norman Mackay 5

I can confirm this this issue still persists in VS2022 Pro 17.11.1, Android API 34.

Font icons are lost (happens randomly in debug too although several clean and rebuilds eventually fix this)

Splashscreen image gets removed and color defaults to colorPrimary
Font icons are lost an an X is shown

Tested with AOT disabled and enabled and get the same results regardless.

It's basically unusable.

Current release config


<PropertyGroup Condition="'$(Configuration)|$(TargetFramework)|$(Platform)'=='Release|net8.0-android|AnyCPU'">
  <MtouchLink>SdkOnly</MtouchLink>
  <AndroidPackageFormat>apk</AndroidPackageFormat>
  <AndroidUseAapt2>True</AndroidUseAapt2>
  <AndroidEnableProfiledAot>True</AndroidEnableProfiledAot>
  <AndroidCreatePackagePerAbi>False</AndroidCreatePackagePerAbi>
  <EnableLLVM>False</EnableLLVM>
  <AndroidKeyStore>False</AndroidKeyStore>
  <AndroidEnableMultiDex>True</AndroidEnableMultiDex>
</PropertyGroup>

ZI 0 Reputation points

2024-09-06T07:51:48.1133333+00:00

I still have same problem, I think reason is: - build in release mode don't copy custom fonts (fa-solid.ttf) inside .aab file

4 answers

Joaquín Salas 20 Reputation points

2024-11-09T06:46:44.04+00:00

Good evening! I had the same issue, and after hours of trying different things (haha), I finally managed to fix it by updating the .csproj file in the main project. Initially, I had:

 <MauiFont Include="Resources\Fonts*" />

But what worked for me was specifying each font individually like this:

<ItemGroup>

<MauiFont Include="Resources/Fonts/LexendDeca-Black.ttf" Alias="Black" />

<MauiFont Include="Resources/Fonts/LexendDeca-Bold.ttf" Alias="Bold" />

<MauiFont Include="Resources/Fonts/LexendDeca-ExtraBold.ttf" Alias="ExtraBold" />

<MauiFont Include="Resources/Fonts/LexendDeca-ExtraLight.ttf" Alias="ExtraLight" />

<MauiFont Include="Resources/Fonts/LexendDeca-Light.ttf" Alias="Light" />

<MauiFont Include="Resources/Fonts/LexendDeca-Medium.ttf" Alias="Medium" />

<MauiFont Include="Resources/Fonts/LexendDeca-Regular.ttf" Alias="Regular" />

<MauiFont Include="Resources/Fonts/LexendDeca-SemiBold.ttf" Alias="SemiBold" />

<MauiFont Include="Resources/Fonts/LexendDeca-Thin.ttf" Alias="Thin" />

<MauiFont Include="Resources/Fonts/MaterialIcons.ttf" Alias="MaterialIcons" />

</ItemGroup>

After making this change, the icons finally displayed correctly in Release mode, and I got rid of the issue where only an "X" would appear instead of the icon. I hope this helps someone else! Best regards.
Please sign in to rate this answer.

4 people found this answer helpful.
Stefan Cuypers 0 Reputation points

2024-11-09T09:19:45.2566667+00:00

Thanks a lot for sharing this. Indeed works for me too!

Soran Sobhani Rad 0 Reputation points

2024-11-12T05:47:04.1266667+00:00

Thanks for the sharing. it works for me too!

Cristina 0 Reputation points

2024-11-15T09:13:34.4466667+00:00

Thanks a lot for sharing. worked for me too

Leonard Harris 6 Reputation points

2024-12-12T22:32:27.9433333+00:00

Excellent, thanks for sharing but where is the documentation for this sort of thing? Or is there a bug regarding Alias Registration on Android Releases for this part:

fonts.AddFont("Lobster-Regular.ttf", "Lobster");

namespace MyMauiApp { public static class MauiProgram { public static MauiApp CreateMauiApp() { var builder = MauiApp.CreateBuilder(); builder .UseMauiApp<App>() .ConfigureFonts(fonts => { fonts.AddFont("Lobster-Regular.ttf", "Lobster"); }); return builder.Build(); } } }

JamesInSC 0 Reputation points

2025-01-17T20:08:47.53+00:00

Thanks!! This is the only thing that worked for me also.
Sign in to comment

Use comments to ask for clarification, additional information, or improvements to the question.
Anton Moroder 0 Reputation points

2024-05-29T12:34:47.2866667+00:00

I solved the problem by publishing with visual studio version 17.10.0.
Please sign in to rate this answer.

0 comments No comments
Sign in to comment

Use comments to ask for clarification, additional information, or improvements to the question.
Dave 0 Reputation points

2024-09-15T15:02:16.3433333+00:00

@Norman Mackay "(happens randomly in debug too although several clean and rebuilds eventually fix this)." Unfortunate, but it works. Thank you.
Please sign in to rate this answer.

0 comments No comments
Sign in to comment

Use comments to ask for clarification, additional information, or improvements to the question.
Stefan Cuypers 0 Reputation points

2024-10-03T11:45:39.02+00:00

I'm experiencing the same issue in VS 17.11.4.

Fonts work fine in debug mode, but when running in release mode they do not work.
Please sign in to rate this answer.

0 comments No comments
Sign in to comment

Use comments to ask for clarification, additional information, or improvements to the question.

Share via

Custom fonts not working when uploading Maui Android project to Play Store

4 answers

Your answer