dotnet / dotnet/docs-maui

Splash screen docs confusing / out of date

Open
#1,106 0 comments 0 reactions 0 assignees View on GitHub
:watch: Not Triaged doc-bug dotnet-maui/tech dotnet-mobile/prod okr-freshness okr-quality Pri1
Dominant language
No language data
Stars
282
Forks
265
Avg merge
2d 2h
Merged PRs (30d)
19

Description

The splash screen docs were a bit confusing for me to follow, bu I think mostly because some of the information is out of date.

https://learn.microsoft.com/en-us/dotnet/maui/user-interface/images/splashscreen?view=net-maui-7.0&tabs=android

It was unclear when the IDE was expected to auto-generate some of the properties vs. when they should be manually included and this led to some confusion and wrangling.

For Android, I believe the process has changed in later versions so a general review would be good. For example, the doc references `Resourcs/values/maui_colors.xml` and `Resources/drawable/maui_splash_image.xml`; the former still exists as just `Resourcs/values/colors.xml` but AFAICT the latter does not seem to exist whatsoever.

I also ended up adding a png and referencing it as png in the csproj as well (instead of svg as the docs seemed to suggest)

---
#### Document Details

⚠ *Do not edit this section. It is required for learn.microsoft.com ➟ GitHub issue linking.*

* ID: 44323c6e-d65c-b254-ee3c-cd9415bdf3bc
* Version Independent ID: 44323c6e-d65c-b254-ee3c-cd9415bdf3bc
* Content: [Add a splash screen to a .NET MAUI app project - .NET MAUI](https://learn.microsoft.com/en-us/dotnet/maui/user-interface/images/splashscreen?view=net-maui-7.0&tabs=android)
* Content Source: [docs/user-interface/images/splashscreen.md](https://github.com/dotnet/docs-maui/blob/main/docs/user-interface/images/splashscreen.md)
* Product: **dotnet-mobile**
* Technology: **dotnet-maui**
* GitHub Login: @davidbritch
* Microsoft Alias: **dabritch**

Contributor guide

Open the contributing guide

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.