다음을 통해 공유


자습서: Visual Studio Code를 사용하여 .NET 클래스 라이브러리 만들기

이 자습서에서는 단일 문자열 처리 메서드를 포함하는 간단한 유틸리티 라이브러리를 만듭니다.

클래스 라이브러리 애플리케이션에서 호출되는 형식과 메서드를 정의합니다. 라이브러리가 .NET Standard 2.0을 대상으로 하는 경우 .NET Standard 2.0을 지원하는 모든 .NET 구현(.NET Framework 포함)에서 호출할 수 있습니다. 라이브러리가 .NET 9를 대상으로 하는 경우 .NET 9를 대상으로 하는 모든 애플리케이션에서 호출할 수 있습니다. 이 자습서에서는 .NET 9를 대상으로 하는 방법을 보여줍니다.

클래스 라이브러리를 만들 때 타사 구성 요소 또는 하나 이상의 애플리케이션이 있는 번들 구성 요소로 배포할 수 있습니다.

필수 구성 요소

클래스 라이브러리 프로젝트 만들기

먼저 "StringLibrary"라는 .NET 클래스 라이브러리 프로젝트와 연결된 솔루션을 만듭니다. 솔루션은 하나 이상의 프로젝트에 대한 컨테이너 역할을 합니다. 관련된 프로젝트를 동일한 솔루션에 추가합니다.

  1. Visual Studio Code를 시작합니다.

  2. 탐색기 보기로 이동하여 .NET 프로젝트 만들기선택합니다. 또는 Ctrl+Shift+P(MacOS의 경우 Command+Shift+P)를 사용하여 명령 팔레트를 표시한 다음 ".NET"을 입력하고 .NET: 새 프로젝트 명령을 찾아서 선택할 수 있습니다.

  3. 명령을 선택한 후 프로젝트 템플릿을 선택해야 합니다. 클래스 라이브러리를 선택합니다.

  4. 그런 다음 새 프로젝트를 만들 위치를 선택합니다.

  5. 그런 다음 새 프로젝트를 만들 위치를 선택합니다. ClassLibraryProjects 폴더를 만들고 선택합니다.

  6. 프로젝트 이름을 StringLibrary으로 지정한 후, 모든 템플릿 옵션 표시를 선택하고, .NET 9를 선택한 후, 프로젝트 만들기를 선택합니다.

  7. 프로젝트를 StringLibrary으로 지정하고 프로젝트 만들기을 선택합니다.

  8. 프롬프트에서 Enter 키를 누르면 경로프로젝트가 생성됩니다.

  9. 라이브러리가 .NET 9를 대상으로 하는지 확인합니다. 탐색기에서StringLibrary/StringLibrary.csproj을 엽니다.

    TargetFramework 요소는 프로젝트가 .NET 9.0을 대상으로 했음을 보여 줍니다.

    <Project Sdk="Microsoft.NET.Sdk">
    
      <PropertyGroup>
        <TargetFramework>net9.0</TargetFramework>
      </PropertyGroup>
    
    </Project>
    
  10. Class1.cs 열고 코드를 다음 코드로 바꿉다.

    using System;
    
    namespace UtilityLibraries
    {
        public static class StringLibrary
        {
            public static bool StartsWithUpper(this string str)
            {
                if (string.IsNullOrWhiteSpace(str))
                    return false;
    
                char ch = str[0];
                return char.IsUpper(ch);
            }
        }
    }
    

    UtilityLibraries.StringLibrary클래스 라이브러리에는 StartsWithUpper메서드가 포함되어 있습니다. 이 메서드는 현재 문자열 인스턴스가 대문자로 시작하는지 여부를 나타내는 Boolean 값을 반환합니다. 유니코드 표준은 대문자를 소문자에서 구분합니다. Char.IsUpper(Char) 메서드는 문자가 대문자이면 true 반환합니다.

    클래스의 멤버인 것처럼 호출할 수 있도록 확장 메서드로 구현됩니다.

  11. 파일을 저장합니다.

  12. 탐색기 보기 아래쪽에서 솔루션 탐색기을 확장합니다.

  13. 솔루션 탐색기 솔루션을 마우스 오른쪽 단추로 클릭하고 빌드선택하거나 명령 팔레트를 열고 .NET: 빌드 선택하여 솔루션을 빌드하고 프로젝트가 오류 없이 컴파일되는지 확인합니다.

    터미널 출력은 다음 예제와 같습니다.

    Microsoft (R) Build Engine version 17.8.0+b89cb5fde for .NET
    Copyright (C) Microsoft Corporation. All rights reserved.
      Determining projects to restore...
      All projects are up-to-date for restore.
      StringLibrary -> C:\Projects\ClassLibraryProjects\StringLibrary\bin\Debug\net9.0\StringLibrary.dll
    Build succeeded.
        0 Warning(s)
        0 Error(s)
    Time Elapsed 00:00:02.78
    

솔루션에 콘솔 앱 추가

클래스 라이브러리를 사용하는 콘솔 애플리케이션을 추가합니다. 앱은 사용자에게 문자열을 입력하라는 메시지를 표시하고 문자열이 대문자로 시작하는지 여부를 보고합니다.

  1. 솔루션 탐색기 에서 솔루션을 마우스 오른쪽 버튼으로 클릭하고, 새 프로젝트을 선택하거나, 명령 팔레트에서 .NET: 새 프로젝트을 선택합니다.

  2. 콘솔 앱을 선택합니다.

  3. 이름을 ShowCase으로 지정하고, 기본 위치를 선택한 다음 프로젝트 생성을 선택합니다.

  4. showCase/Program.cs 열고 모든 코드를 다음 코드로 바꿉니다.

    using System;
    using UtilityLibraries;
    
    class Program
    {
        static void Main(string[] args)
        {
            int row = 0;
    
            do
            {
                if (row == 0 || row >= 25)
                    ResetConsole();
    
                string? input = Console.ReadLine();
                if (string.IsNullOrEmpty(input)) break;
                Console.WriteLine($"Input: {input} {"Begins with uppercase? ",30}: " +
                                  $"{(input.StartsWithUpper() ? "Yes" : "No")}{Environment.NewLine}");
                row += 3;
            } while (true);
            return;
    
            // Declare a ResetConsole local method
            void ResetConsole()
            {
                if (row > 0)
                {
                    Console.WriteLine("Press any key to continue...");
                    Console.ReadKey();
                }
                Console.Clear();
                Console.WriteLine($"{Environment.NewLine}Press <Enter> only to exit; otherwise, enter a string and press <Enter>:{Environment.NewLine}");
                row = 3;
            }
        }
    }
    

    이 코드는 row 변수를 사용하여 콘솔 창에 기록된 데이터 행 수의 수를 유지 관리합니다. 25보다 크거나 같을 때마다 코드는 콘솔 창을 지우고 사용자에게 메시지를 표시합니다.

    프로그램에서 사용자에게 문자열을 입력하라는 메시지를 표시합니다. 문자열이 대문자로 시작하는지 여부를 나타냅니다. 사용자가 문자열을 입력하지 않고 Enter 키를 누르면 애플리케이션이 종료되고 콘솔 창이 닫힙니다.

  5. 변경 내용을 저장합니다.

프로젝트 참조 추가

처음에는 새 콘솔 앱 프로젝트에서 클래스 라이브러리에 액세스할 수 없습니다. 클래스 라이브러리에서 메서드를 호출할 수 있도록 하려면 클래스 라이브러리 프로젝트에 대한 프로젝트 참조를 만듭니다.

  1. 솔루션 탐색기에서ShowCase 프로젝트를 마우스 오른쪽 단추로 클릭하고 프로젝트 참조 추가를 선택합니다.

  2. StringLibrary를 선택합니다.

앱 실행

  1. 디버깅하지 않고 실행실행을 선택합니다.

  2. C#선택합니다.

  3. ShowCase을 선택합니다.

    C# 프로그램이 로드되지 않는다는 오류가 발생하면 열려 있는 폴더를 닫고 ShowCase 폴더를 엽니다. 그런 다음, 앱을 다시 실행해 봅니다.

  4. 문자열을 입력하고 엔터를 누른 다음 엔터 를 눌러 프로그램을 종료하려면 그렇게 하십시오.

    터미널 출력은 다음 예제와 같습니다.

    Press <Enter> only to exit; otherwise, enter a string and press <Enter>:
    
    A string that starts with an uppercase letter
    Input: A string that starts with an uppercase letter
    Begins with uppercase? : Yes
    
    a string that starts with a lowercase letter
    Input: a string that starts with a lowercase letter
    Begins with uppercase? : No
    

추가 리소스

다음 단계

이 자습서에서는 라이브러리 프로젝트를 만들고 라이브러리를 사용하는 콘솔 앱 프로젝트를 추가했습니다. 다음 자습서에서는 솔루션에 단위 테스트 프로젝트를 추가합니다.

Visual Studio Code 사용하여 .NET에서 .NET 클래스 라이브러리 테스트