다음을 통해 공유

빠른 시작: 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.com 2022 Community Edition을 무료로 설치하거나 Professional 또는 Enterprise 버전을 사용할 수 있습니다.

프로젝트 만들기

해당 패키지가 프로젝트와 동일한 대상 프레임워크를 지원하는 경우 모든 .NET 프로젝트에 NuGet 패키지를 설치할 수 있습니다. 그러나 이 빠른 시작에서는 WPF(Windows Presentation Foundation) 애플리케이션 프로젝트를 만듭니다.

다음 단계를 수행합니다.

  1. Visual Studio에서 파일>새로 만들기>프로젝트를 선택합니다.

  2. 새 프로젝트 만들기 창의 검색 상자에 WPF를 입력하고 드롭다운 목록에서 C# 및 Windows를 선택합니다. 결과 프로젝트 템플릿 목록에서 WPF 애플리케이션을 선택한 다음, 다음을 선택합니다.

  3. 새 프로젝트 구성 창에서 필요에 따라 프로젝트 이름 및 솔루션 이름을 업데이트한 다음, 다음을 선택합니다.

  4. 추가 정보 창에서 Framework용 .NET 6.0(또는 최신 버전)을 선택한 다음 만들기를 선택합니다.

    Visual Studio에서 프로젝트를 만들고 솔루션 탐색기 나타납니다.

Newtonsoft.Json NuGet 패키지 추가

이 빠른 시작에서 NuGet 패키지를 설치하려면 NuGet 패키지 관리자 또는 패키지 관리자 콘솔을 사용할 수 있습니다. 프로젝트 형식에 따라 NuGet 패키지 설치는 프로젝트 파일 또는 packages.config 파일에 종속성을 기록합니다. 자세한 내용은 패키지 사용 워크플로를 참조 하세요.

NuGet 패키지 관리자

NuGet 패키지 관리자 사용하여 Visual Studio에 패키지를 설치 Newtonsoft.Json 하려면 다음 단계를 수행합니다.

  1. NuGet 패키지 관리 프로젝트를>선택합니다.

  2. NuGet 패키지 관리자 페이지에서 패키지 원본으로 nuget.org 선택합니다.

  3. 찾아보기 탭에서 Newtonsoft.Json을 검색하고 목록에서 Newtonsoft.Json을 선택한 다음 설치를 선택합니다.

    Screenshot showing the NuGet Package Manager window with the Newtonsoft.Json package selected.

  4. 설치를 확인하라는 메시지가 표시되면 확인을 선택합니다.

패키지 관리자 콘솔

또는 Visual Studio에서 패키지 관리자 콘솔을 사용하여 패키지를 설치 Newtonsoft.Json 하려면 다음 단계를 수행합니다.

  1. Visual Studio에서 도구>NuGet 패키지 관리자>패키지 관리자 콘솔을 선택합니다.

  2. 패키지 관리자 콘솔 창이 열리면 기본 프로젝트 드롭다운 목록에 패키지를 설치하려는 프로젝트가 표시되는지 확인합니다. 솔루션에 단일 프로젝트가 있는 경우 미리 선택됩니다.

    Screenshot showing the Package Manage Console window with Default project highlighted.

  3. 콘솔 프롬프트에서 명령을 Install-Package Newtonsoft.Json입력합니다. 이 명령에 대한 자세한 내용은 Install-Package를 참조하세요.

    콘솔 창에는 명령에 대한 출력이 표시됩니다. 일반적으로 오류는 패키지가 프로젝트의 대상 프레임워크와 호환되지 않음을 나타냅니다.

앱에서 Newtonsoft.Json API 사용

Newtonsoft.Json 프로젝트의 패키지를 사용하여 메서드 JsonConvert.SerializeObject 를 호출하여 개체를 사람이 읽을 수 있는 문자열로 변환합니다.

  1. 솔루션 탐색기 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>

  2. 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;
}

  3. 코드에서 개체에 JsonConvert 대한 오류를 방지하려면(빨간색 물결선이 표시됨) 코드 파일의 시작 부분에 다음 문을 추가합니다.

    using Newtonsoft.Json;

  4. 앱을 빌드하고 실행하려면 F5 키를 누르거나 디버그>시작 디버깅을 선택합니다.

    다음과 같은 창이 나타납니다.

    Screenshot showing the initial output of the WPF app.

  5. [나를 클릭] 단추를 선택하여 개체의 TextBlock 내용을 JSON 텍스트로 바꿉니다.

    Screenshot showing the output of the WPF app after selecting the button.

참고 항목

NuGet에 대한 자세한 내용은 다음 문서를 참조하세요.

다음 단계

첫 번째 NuGet 패키지를 설치하고 사용하는 것을 축하합니다. NuGet 패키지 설치 및 관리에 대해 자세히 알아보려면 다음 문서로 진행하세요.

NuGet 패키지 관리자 사용하여 패키지 설치 및 관리

패키지 관리자 콘솔을 사용하여 패키지 설치 및 관리