빠른 시작: Visual Studio에서 NuGet 패키지 설치 및 사용(Windows에만 해당)
NuGet 패키지 은 다른 개발자가 제공하여 프로젝트에서 사용할 수 있도록 만든 재사용 가능한 코드를 포함하고 있습니다.
NuGet 패키지 관리자, 패키지 관리자 콘솔또는 .NET CLI사용하여 Microsoft Visual Studio 프로젝트에 NuGet 패키지를 설치할 수 있습니다. 이 문서에서는 인기 있는 Newtonsoft.Json 패키지를 사용하여 WPF(Windows Presentation Foundation) 프로젝트를 만드는 방법을 보여 줍니다. 다른 .NET 또는 .NET Core 프로젝트에도 동일한 프로세스가 적용됩니다.
NuGet 패키지를 설치한 후 using <namespace> 문을 사용하여 코드에서 참조할 수 있습니다. 여기서 <네임스페이스> 사용 중인 패키지의 이름입니다. 참조를 만든 후 해당 API를 통해 패키지를 호출할 수 있습니다.
이 문서는 Windows 사용자만을 위한 것입니다. Mac용 Visual Studio를 사용하는 경우 Mac용 Visual Studio에서 패키지 설치 및 사용을 참조하세요.
팁
NuGet 패키지를 찾으려면 nuget.org시작합니다. nuget.org 검색은 .NET 개발자가 일반적으로 자체 애플리케이션에서 다시 사용할 수 있는 구성 요소를 찾는 방법입니다. 이 문서에 표시된 것처럼 nuget.org 직접 검색하거나 Visual Studio 내에서 패키지를 찾아 설치할 수 있습니다. 자세한 내용은 NuGet 패키지 찾기 및 평가참조하세요.
필수 구성 요소
.NET 데스크톱 개발 워크로드를 사용하여 Windows용 Visual Studio 2022를 설치합니다.
visualstudio.microsoft.com2022 Community Edition을 무료로 설치하거나 Professional 또는 Enterprise 버전을 사용할 수 있습니다.
프로젝트 만들기
해당 패키지가 프로젝트와 동일한 대상 프레임워크를 지원하는 경우 모든 .NET 프로젝트에 NuGet 패키지를 설치할 수 있습니다. 그러나 이 빠른 시작에서는 WPF(Windows Presentation Foundation) 애플리케이션 프로젝트를 만듭니다.
다음 단계를 수행합니다.
Visual Studio에서 파일>새>프로젝트선택합니다.
새 프로젝트 만들기 창의 검색 상자에 WPF를 입력하고, 드롭다운 목록에서 C#과 Windows를 선택합니다. 결과 프로젝트 템플릿 목록에서 WPF 애플리케이션을 선택한 다음 다음을 선택합니다.
새 프로젝트 구성 창에서 필요에 따라 프로젝트 이름 및 솔루션 이름업데이트한 다음 다음선택합니다.
추가 정보 창에서 .NET 6.0(또는 최신 버전)를 Framework로 선택한 다음, 만들기를 선택합니다.
Visual Studio는 프로젝트를 만들고 솔루션 탐색기나타납니다.
Newtonsoft.Json NuGet 패키지 추가
이 빠른 시작에서 NuGet 패키지를 설치하려면 NuGet 패키지 관리자 또는 패키지 관리자 콘솔을 사용할 수 있습니다. 프로젝트 형식에 따라 NuGet 패키지를 설치하면 프로젝트 파일 또는 packages.config 파일에 종속성이 기록됩니다. 자세한 내용은 패키지 사용 워크플로참조하세요.
NuGet 패키지 관리자
NuGet 패키지 관리자 사용하여 Visual Studio에서 Newtonsoft.Json 패키지를 설치하려면 다음 단계를 수행합니다.
프로젝트>NuGet 패키지 관리선택합니다.
NuGet 패키지 관리자 페이지에서 패키지 원본nuget.org 선택합니다.
찾아보기 탭에서 Newtonsoft.Json을 검색하고, 목록에서 Newtonsoft.Json 을 선택한 다음, 설치를 선택합니다.
Newtonsoft.Json 패키지가 선택된 NuGet 패키지 관리자 창을 보여 주는
설치 확인 메시지가 표시되면 확인을 선택합니다.
패키지 관리자 콘솔
또는 Visual Studio에서 패키지 관리자 콘솔 사용하여 Newtonsoft.Json 패키지를 설치하려면 다음 단계를 수행합니다.
Visual Studio에서 Tools>NuGet 패키지 관리자>패키지 관리자 콘솔선택합니다.
패키지 관리자 콘솔 창이 열리면 기본 프로젝트 드롭다운 목록에 패키지를 설치하려는 프로젝트가 표시되는지 확인합니다. 솔루션에 단일 프로젝트가 있는 경우 미리 선택됩니다.
콘솔 프롬프트에서
Install-Package Newtonsoft.Json명령을 입력합니다. 이 명령에 대한 자세한 내용은 Install-Package참조하세요.콘솔 창에는 명령에 대한 출력이 표시됩니다. 오류는 일반적으로 패키지가 프로젝트의 대상 프레임워크와 호환되지 않음을 나타냅니다.
앱에서 Newtonsoft.Json API 사용
프로젝트의 Newtonsoft.Json 패키지를 사용하여 JsonConvert.SerializeObject 메서드를 호출하여 개체를 사람이 읽을 수 있는 문자열로 변환합니다.
솔루션 탐색기에서 MainWindow.xaml 을 열고 기존
<Grid>요소를 다음 코드로 바꿉니다.<Grid Background="White"> <StackPanel VerticalAlignment="Center"> <Button Click="Button_Click" Width="100px" HorizontalAlignment="Center" Content="Click Me" Margin="10"/> <TextBlock Name="TextBlock" HorizontalAlignment="Center" Text="TextBlock" Margin="10"/> </StackPanel> </Grid>MainWindow.xaml 노드에서 MainWindow.xaml.cs 파일을 열고 생성자 뒤에
MainWindow클래스 내에 다음 코드를 삽입합니다.public class Account { public string Name { get; set; } public string Email { get; set; } public DateTime DOB { get; set; } } private void Button_Click(object sender, RoutedEventArgs e) { Account account = new Account { Name = "John Doe", Email = "john@microsoft.com", DOB = new DateTime(1980, 2, 20, 0, 0, 0, DateTimeKind.Utc), }; string json = JsonConvert.SerializeObject(account, Newtonsoft.Json.Formatting.Indented); TextBlock.Text = json; }코드에서
JsonConvert개체에 대한 오류를 방지하려면(빨간색 물결선이 표시됨) 코드 파일의 시작 부분에 다음 문을 추가합니다.using Newtonsoft.Json;앱을 빌드하고 실행하려면 F5 키를 누르거나 디버그>디버깅 시작선택합니다.
다음 창이 나타납니다.
Click Me 버튼을 선택하여
TextBlock개체의 내용이 JSON 텍스트로 바뀌었음을 확인합니다.
관련 비디오
참고 항목
NuGet에 대한 자세한 내용은 다음 문서를 참조하세요.
- NuGet이란?
- 패키지 사용 워크플로우
- 패키지 찾기 및 선택
- 프로젝트 파일에서 패키지 참조
- .NET CLI을 사용하여 패키지를 설치하고 사용하기.
- Newtonsoft.Json 패키지
다음 단계
첫 번째 NuGet 패키지를 설치하고 사용하는 것을 축하합니다. NuGet 패키지 설치 및 관리에 대해 자세히 알아보려면 다음 문서로 진행하세요.
NuGet 패키지 관리자 사용하여 패키지 설치 및 관리
패키지 관리자 콘솔 사용하여 패키지 설치 및 관리