.NET 다중 플랫폼 앱 UI(.NET MAUI) 커뮤니티 도구 키트 시작

  • 아티클

이 문서에서는 .NET MAUI 커뮤니티 도구 키트 프로젝트의 일부로 제공된 패키지를 사용하여 시작하는 방법을 설명합니다.

NuGet 패키지 추가

도구 키트는 Visual Studio를 사용하여 기존 또는 새 프로젝트에 추가할 수 있는 NuGet 패키지 집합으로 사용할 수 있습니다.

  1. 기존 프로젝트를 열거나 .NET MAUI 설치 설명서에 따라 새 프로젝트를 만듭니다.

  2. 솔루션 탐색기 창에서 마우스 오른쪽 단추로 프로젝트 이름을 클릭하고, NuGet 패키지 관리를 선택합니다. CommunityToolkit.Maui를 검색하고 목록에서 원하는 NuGet 패키지를 선택합니다.

    NuGet 패키지 관리...

  3. 아래 옵션에서 요구 사항에 가장 적합한 도구 키트를 선택합니다.

이 패키지는 .NET MAUI를 사용한 개발을 위한 애니메이션, 동작, 변환기 및 사용자 지정 보기의 컬렉션입니다. .NET MAUI를 사용하여 iOS, Android, macOS 및 Windows 앱을 빌드하는 일반적인 개발자 작업을 간소화하고 보여 줍니다.

패키지 이름:CommunityToolkit.Maui

패키지 URL:https://www.nuget.org/packages/CommunityToolkit.Maui

패키지 초기화

먼저 using 문을 MauiProgram.cs 파일의 맨 위에 추가해야 합니다.

using CommunityToolkit.Maui;

도구 키트를 올바르게 사용하려면 애플리케이션에서 UseMauiCommunityToolkit MauiProgram.cs 파일을 부트스트래핑할 때 클래스에서 MauiAppBuilder 메서드를 호출해야 합니다. 다음 예제에서는 이 작업을 수행하는 방법을 보여줍니다.

var builder = MauiApp.CreateBuilder();
builder
    .UseMauiApp<App>()
    .UseMauiCommunityToolkit()

도구 키트의 기능을 사용하려면 각 특정 기능에 대한 설명서 페이지를 참조하세요.

NuGet 패키지 사용

  1. 다음에서 도구 키트를 사용하도록 설정합니다.MauiProgram.cs
var builder = MauiApp.CreateBuilder();
builder.UseMauiApp<App>();
builder.UseMauiCommunityToolkit();

4.1. 고급 설정의 경우 CommunityToolkit.Maui.Options를 설정합니다.

builder.UseMauiCommunityToolkit(options =>
{
    options.SetShouldSuppressExceptionsInConverters(false);
    options.SetShouldSuppressExceptionsInBehaviors(false);
    options.SetShouldSuppressExceptionsInAnimations(false);
});
  1. 특정 기능 구현에 대한 자세한 내용은 설명서의 나머지 부분을 확인하세요.

다른 리소스

.NET MAUI Community Toolkit GitHub 리포지토리에는 도구 키트를 사용하여 .NET MAUI 애플리케이션을 빌드하는 방법을 보여 주도록 설계된 샘플 애플리케이션의 소스 코드가 포함되어 있습니다. 샘플 애플리케이션을 실행하려면 리포지토리를 복제하거나 다운로드하고 소스 코드를 컴파일해야 합니다.

.NET MAUI를 접하는 개발자는 .NET MAUI 설명서를 방문하는 것이 좋습니다.

.NET MAUI 커뮤니티 도구 키트 GitHub 리포지토리를 방문하여 현재 소스 코드, 다음에 제공될 내용을 확인하고 리포지토리를 복제합니다. 커뮤니티 기여 환영!