NuGet 패키지 발행 가이드

• 4/15/2025
• 4 minutes to read

이 강좌는 다음 순서로 진행되는 시리즈 강좌 중 하나입니다.

1. GitHub 저장소 생성 및 첫 커밋 따라하기
2. 클래스 라이브러리 및 테스트 프로젝트 생성
3. NuGet 패키지 발행 가이드 (현재 문서)

NuGet 패키지 발행 가이드

이 문서는 이전에 작성한 Azunt 클래스 라이브러리 프로젝트를 기반으로, NuGet 패키지로 빌드하고 배포하는 전체 과정을 설명합니다.

작성한 유틸리티 코드를 NuGet 패키지로 배포하여 프로젝트 간 재사용성을 높이고, 오픈소스 또는 내부 배포용으로 활용할 수 있습니다.

🧩 사전 준비

다음 항목들을 준비합니다.

• NuGet.org 계정 (무료 Microsoft 계정)
• Visual Studio 또는 dotnet CLI
• 이전에 작성한 Azunt 프로젝트 (src/Azunt)

참고: 패키지 업로드를 위해서는 NuGet.org 계정이 필요합니다.

🔖 프로젝트 속성 설정

1. Visual Studio 에서 Azunt 프로젝트를 엽니다.
2. 프로젝트 > 속성 메뉴로 이동합니다.
3. 패키지 탭에서 다음 항목들을 입력합니다.

4. 저장합니다.

위 정보는 NuGet.org 에서 패키지 상세 페이지에 표시됩니다.

⚙️ NuGet 패키지 생성

패키지는 Visual Studio 또는 dotnet CLI 를 통해 생성할 수 있습니다.

Visual Studio 를 사용하는 경우

1. 빌드 > 패키지 생성 메뉴를 선택합니다.
2. 프로젝트가 성공적으로 빌드되면, bin/Debug/ 또는 bin/Release/ 폴더 안에 .nupkg 파일이 생성됩니다.

dotnet CLI 를 사용하는 경우

Visual Studio Code 나 터미널에서 다음 명령어를 실행합니다.

cd src/Azunt
dotnet pack --configuration Release

✅ 결과: src/Azunt/bin/Release/Azunt.1.0.0.nupkg 파일이 생성됩니다.

🌐 NuGet.org 에 패키지 업로드

1. NuGet.org 에 로그인합니다.
2. 상단 메뉴에서 Upload Package 를 선택합니다.
3. 생성한 .nupkg 파일을 업로드합니다.
4. 패키지 메타데이터를 검토하고, Submit 버튼을 클릭합니다.

업로드 후 패키지가 승인되면 전 세계에서 사용할 수 있습니다.

그림: 패키지 승인 완료 메시지

그림: NuGet 갤러리에 등록 완료

✅ 패키지 설치 및 사용

패키지 배포가 완료되면, 원하는 프로젝트에서 다음 명령어로 설치할 수 있습니다.

dotnet add package Azunt

또는 Visual Studio 에서 NuGet 패키지 관리를 통해 설치합니다.

📂 프로젝트 구성 결과

최종적으로 생성된 파일들은 다음과 같습니다.

Azunt/
└── src/
    └── Azunt/
        ├── bin/
        │   └── Release/
        │       └── Azunt.1.0.0.nupkg
        ├── Networking/
        │   └── IpAddressUtility.cs
        └── Azunt.csproj

📝 마무리

이 가이드를 따라 Azunt 프로젝트를 NuGet 패키지로 성공적으로 배포할 수 있습니다.

패키지가 배포되면 누구나 NuGet 을 통해 설치하여 사용할 수 있으며,
향후 버전 업데이트를 통해 새로운 기능이나 개선 사항을 쉽게 배포할 수 있습니다.