.NET MAUI 앱 프로젝트에 시작 화면 추가

Android 및 iOS에서 .NET 다중 플랫폼 앱 UI(.NET MAUI) 앱은 초기화 프로세스가 완료되는 동안 시작 화면을 표시할 수 있습니다. 시작 화면은 앱이 시작될 때 즉시 표시되어 앱 리소스가 초기화되는 동안 사용자에게 즉각적인 피드백을 제공합니다.

.NET MAUI 시작 화면 스크린샷

앱이 상호 작용할 준비가 되면 시작 화면이 해제됩니다.

.NET MAUI 앱 프로젝트에서 시작 화면을 앱 프로젝트의 단일 위치에 지정할 수 있으며 빌드 시 대상 플랫폼 및 디바이스에 대한 올바른 해상도로 자동으로 크기를 조정하고 앱 패키지에 추가할 수 있습니다. 이렇게 하면 플랫폼별로 시작 화면을 수동으로 복제하고 이름을 지정할 필요가 없습니다. 기본적으로 비트맵(비벡터) 이미지 형식은 .NET MAUI에 의해 자동으로 크기가 조정되지 않습니다.

.NET MAUI 시작 화면은 SVG(확장 가능한 벡터 그래픽) 파일을 포함하여 표준 플랫폼 이미지 형식을 사용할 수 있습니다.

중요

.NET MAUI는 SVG 파일을 PNG 파일로 변환합니다. 따라서 .NET MAUI 앱 프로젝트에 SVG 파일을 추가할 때 확장명 .png XAML 또는 C#에서 참조해야 합니다. SVG 파일에 대한 유일한 참조는 프로젝트 파일에 있어야 합니다.

이미지를 프로젝트의 Resources\Splash 폴더로 끌어 앱 프로젝트에 시작 화면을 추가할 수 있습니다. 여기서 빌드 작업은 자동으로 MauiSplashScreen으로 설정됩니다. 그러면 프로젝트 파일에 해당 항목이 만들어집니다.

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

참고

시작 화면을 앱 프로젝트의 다른 폴더에 추가할 수도 있습니다. 그러나 이 시나리오에서는 속성 창에서 빌드 작업을 MauiSplashScreen으로 수동으로 설정해야 합니다.

Android 리소스 명명 규칙을 준수하려면 시작 화면 파일 이름은 소문자여야 하고 문자 문자로 시작하고 끝나야 하며 영숫자 또는 밑줄만 포함해야 합니다. 자세한 내용은 developer.android.com 앱 리소스 개요를 참조하세요.

시작 화면의 기본 크기는 특성을 8로 나눌 수 있는 값으로 설정 BaseSize 하여 지정할 수 있습니다.

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

특성 값은 시작 화면의 BaseSize 기준 밀도를 나타내며 다른 모든 밀도 크기가 파생되는 시작 화면의 1.0 배율 요소입니다. 이 값은 시작 화면의 크기를 다른 디스플레이 밀도로 올바르게 조정하는 데 사용됩니다. 비트맵 기반 시작 화면에 대해 를 BaseSize 지정하지 않으면 이미지의 크기가 조정되지 않습니다. 벡터 기반 시작 화면의 값을 지정 BaseSize 하지 않으면 SVG에 지정된 차원이 기본 크기로 간주됩니다. 벡터 이미지의 크기 조정을 중지하려면 특성을 false로 설정합니다Resize.

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

시작 화면에 색조를 추가하려면 원본에 다른 색으로 렌더링하려는 간단한 이미지가 있는 경우에 유용합니다. 특성을 설정합니다 TintColor .

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

시작 화면의 배경색을 지정할 수도 있습니다.

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

색 값은 16진수 또는 .NET MAUI 색으로 지정할 수 있습니다. 예를 들어 는 Color="Red" 유효합니다.

빌드 시 시작 화면의 크기를 대상 플랫폼 및 디바이스에 대한 올바른 해상도로 조정할 수 있습니다. 그러면 결과 시작 화면이 앱 패키지에 추가됩니다.

Android에서 시작 화면은 앱 패키지에 Resources/values/maui_colors.xmlResources/drawable/maui_splash_image.xml로 추가됩니다. .NET MAUI 앱은 기본적으로 를 Maui.SplashTheme 사용하며, 이 경우 시작 화면이 표시됩니다. 따라서 매니페스트 파일 또는 클래스에서 다른 테마를 지정해서는 안 됩니다 MainActivity .

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
      {
      }
}

고급 시작 화면 시나리오의 경우 플랫폼별 접근 방식이 적용됩니다.