01. CommunityToolkit.Mvvm 개요

 

📦 CommunityToolkit.Mvvm 이란?

• Microsoft 공식 경량 MVVM 라이브러리
  - WPF, WinUI, MAUI, UWP 등의 .NET 기반 App에서 MVVM 구조 구현을 도와줌
• C# Source Generator(소스 생성기)
  • df

 

1. df
   - MVVM 구현에 필요한 반복되는 소스 코드를 자동 완성해줌 

 

1️⃣ CommunityToolkit.Mvvm 개요

📦 CommunityToolkit.Mvvm 이란?

• Microsoft 공식 경량 MVVM 라이브러리
  - WPF, WinUI, MAUI, UWP 등의 .NET 기반 App에서 MVVM 구조 구현을 도와줌 
• C# Source Generator(소스 생성기)
  - MVVM 구현에 필요한 반복되는 소스 코드를 자동 완성해줌 

 

 📚 공식 문서

- CommunityToolkit dotnet Git: GitHub Repository

 

 

- Microsoft Docs: Microsoft Learn / Learn / .NET / MVVM

 

 

✔️ 학습 주요 목차

기능	설명
[ObservableProperty]	속성 자동 구현 (prop + OnPropertyChanged)
[RelayCommand]	명령 구현 자동 생성 (ICommand + Execute/CanExecute 자동화)
ObservableObject	INotifyPropertyChanged 구현을 쉽게 만드는 기본 클래스
WeakReferenceMessenger	ViewModel 간 느슨한 메시지 통신 시스템
Ioc.Default	DI 컨테이너 통합 지원 (Microsoft.Extensions.DependencyInjection 기반)

---

 

2️⃣ "NuGet 패키지 관리자"에서, CommunityToolkit.Mvvm 설치하는 방법

① 솔루션 탐색기에서 프로젝트 우클릭  ② Nuget 패키지 관리자 실행

 

 

③ Nuget 패키지 관리자는 설치된 패키지 리스트를 보여주는 탭이 최초로 보여진다.

 

 

④ "찾기" 탭으로 이동하여, ⑤ CommunityToolkit.Mvvm 검색어 입력 후, ⑦ 최신 안정 버전으로 설치한다.

---

 

3️⃣ 설치된 패키지 확인 방법

✔️  방법1.  프로젝트의 Dependencies >> Packages 에서 설치된 패키지 확인할 수 있다.

 

 

 

✔️  방법2.  .csproj 파일 내부 ItemGroup에 Package 항목이 추가됩니다:

---

 

4️⃣ (추천) "NuGet 패키지 관리자 Console"에서, CommunityToolkit.Mvvm 설치하는 방법

✔️ 1. Visual Studio 에서 패키지 관리자 콘솔 실행

 

방법1. Visual Studio 상단 메뉴에서 도구 → NuGet 패키지 관리자 → 패키지 관리자 콘솔 열기

방법2.  (추천) Visual Studio에서 ctrl + q 단축키 → Package Manager Console 검색

 

 

✔️ 2. 패키지 설치 명령어 실행

Install-Package CommunityToolkit.Mvvm

---

 

5️⃣ 프로젝트 파일 패키지 참조로, 빌드시 자동 설치

  <ItemGroup>
	<PackageReference Include="CommunityToolkit.Mvvm" Version="8.1.0" />
	<PackageReference Include="Microsoft.Extensions.DependencyInjection" Version="7.0.0" />
  </ItemGroup>

 

프로젝트 파일에 추가하면, 빌드시 자동 설치된다.

빌드하지 않으면, 사용할 수 없다.

소스코드에 라이브러리를 사용하려면, 위 명령어를 입력하고 빌드한 뒤 사용 가능하다.