nuget.exe CLI를 사용하여 패키지 만들기

패키지가 수행하는 작업이나 패키지에 포함된 코드에 관계없이 CLI(명령줄 인터페이스) 도구 nuget.exedotnet.exe중 하나를 사용하여 해당 기능을 다른 개발자와 공유하고 사용할 수 있는 구성 요소로 패키지합니다. NuGet CLI 도구를 설치하려면 NuGet 클라이언트 도구 설치를 참조하세요. Visual Studio CLI 도구를 자동으로 포함하지 않습니다.

SDK 스타일이 아닌 프로젝트, 일반적으로 .NET 프레임워크 프로젝트의 경우, 이 문서에서 설명된 단계에 따라 패키지를 만드십시오. Visual Studio 및 nuget.exe CLI 사용에 대한 단계별 지침을 제공하는 빠른 시작은 Quickstart: Visual Studio(.NET Framework, Windows) 사용하여 패키지 만들기 및 게시를 참조하세요.
SDK 스타일 형식 및 기타 SDK 스타일 프로젝트를 사용하는 .NET Core 및 .NET Standard 프로젝트의 경우 dotnet CLI 사용하여 NuGet 패키지 만들기를 참조하세요.
마이그레이션된 packages.config에서 PackageReference로 프로젝트의 경우 msbuild -t:pack 명령을 사용합니다.

기술적으로 NuGet 패키지는 확장명이 .nupkg 이고 콘텐츠가 특정 규칙과 일치하도록 이름이 변경된 ZIP 파일입니다. 이 문서에서는 이러한 규칙을 충족하는 패키지를 만드는 자세한 프로세스를 설명합니다.

패키징은 패키지로 배달하려는 컴파일된 코드(어셈블리), 기호 및 기타 파일로 시작합니다. 패키징 프로세스에 대한 개요는 패키지 만들기 워크플로를 참조하세요. 이 프로세스는 패키지로 이동하는 파일을 컴파일하거나 생성하지 않습니다. 그러나 프로젝트 파일의 정보를 가져와 컴파일된 어셈블리와 패키지를 동기화 상태로 유지할 수 있습니다.

중요합니다

이 문서는 일반적으로 Visual Studio 2017 이상 버전 및 NuGet 4.0 이상을 사용하는 .NET Core 및 .NET Standard 프로젝트 이외의 비 SDK 스타일 프로젝트에 적용됩니다.

어셈블리를 패키지화할지 결정하기

대부분의 범용 패키지에는 다른 개발자가 자신의 프로젝트에서 사용할 수 있는 하나 이상의 어셈블리가 포함되어 있습니다.

일반적으로 각 어셈블리가 독립적으로 유용하다면 NuGet 패키지당 하나의 어셈블리를 사용하는 것이 가장 좋습니다. 예를 들어 Utilities.dll 어셈블리가 Parser.dll 어셈블리에 의존하는 다음 사례를 고려해 보십시오.

Parser.dll이 자체적으로 유용한 경우, Utilities.dll용 패키지 하나와 Parser.dll용 패키지를 각각 만듭니다. 이렇게 하면 개발자가 Utilities.dll과 독립적으로 Parser.dll을 사용할 수 있습니다.
Parser.dll에 Utilities.dll만 사용하는 코드가 포함된 경우, Parser.dll을 동일한 패키지에 두어도 괜찮습니다. 일반적으로 라이브러리가 독립적으로 유용하지 않은 여러 어셈블리로 구성된 경우 라이브러리를 하나의 패키지로 결합하는 것이 좋습니다.
Utilities.dll이 Utilities.resources.dll에 의존한다면, 그리고 Utilities.resources.dll이 혼자서는 유용하지 않은 경우, 둘 다 동일한 패키지에 넣습니다.

이전 예제의 Utilities.resources.dll 어셈블리와 같은 리소스는 특별한 경우입니다. 패키지가 프로젝트에 설치되면 NuGet은 패키지의 DLL에 어셈블리 참조를 자동으로 추가합니다. .resources.dll로 명명된 DLL은 지역화된 위성 어셈블리로 간주되어 제외됩니다. 지역화된 라이브러리 버전에 대한 자세한 내용은 지역화된 NuGet 패키지 만들기를 참조하세요. 이러한 이유로 필수 패키지 코드가 포함된 파일에 는.resources.dll 사용하지 마세요.

라이브러리에 COM(구성 요소 개체 모델) interop 어셈블리가 포함된 경우 COM interop 어셈블리가 포함된 NuGet 패키지 만들기의 추가 지침을 따릅니다.

.nuspec 파일의 역할 및 구조

패키지하려는 파일을 알고 있는 경우 다음 단계는 .nuspec XML 파일에서 패키지 매니페스트를 만드는 것입니다.

매니페스트:

패키지의 내용을 설명하고 패키지에 포함됩니다.
패키지 만들기를 구동하고 프로젝트에 패키지를 설치하는 방법을 NuGet에 알려줍니다. 예를 들어 매니페스트는 다른 패키지 종속성을 식별하므로 주 패키지가 설치될 때 NuGet에서 해당 종속성을 설치할 수도 있습니다.
이 섹션의 나머지 부분에서 설명한 대로 필수 속성과 선택적 속성을 모두 포함합니다. 여기에 언급되지 않은 다른 속성을 비롯한 자세한 내용은 .nuspec 참조를 참조하세요.

매니페스트에는 다음 속성이 필요합니다.

패키지를 호스트하는 갤러리에서 고유해야 하는 패키지 식별자입니다.
Major.Minor.Patch[-Suffix] 형식의 특정 버전 번호입니다. 여기서 -Suffix는 시험판 버전을 식별합니다.
호스트에 표시되는 패키지 제목(예: nuget.org)
작성자 정보
패키지에 대한 긴 설명

다음 속성은 일반적인 선택 사항입니다.

릴리스 정보입니다.
저작권 정보입니다.
Visual StudioPackage Manager UI에 대한 간단한 설명입니다>.
로캘 ID입니다.
프로젝트 URL입니다.
식 또는 파일 형태의 라이선스. 이 licenseUrl 속성은 더 이상 사용되지 않습니다. license 대신 nuspec 메타데이터 요소를 사용합니다.
read-me 파일입니다.
아이콘 파일입니다. 이 iconUrl 속성은 더 이상 사용되지 않습니다. icon 대신 nuspec 메타데이터 요소를 사용합니다.
종속성 및 참조 목록입니다.
갤러리 검색을 지원하는 태그입니다.

다음 코드는 속성을 설명하는 주석이 있는 일반적인 (가상) .nuspec 파일입니다.

<?xml version="1.0"?>
<package xmlns="http://schemas.microsoft.com/packaging/2013/05/nuspec.xsd">
    <metadata>
        <!-- An identifier that must be unique within the hosting gallery -->
        <id>Contoso.Utility.UsefulStuff</id>

        <!-- A package version number that's used when resolving dependencies -->
        <version>1.8.3</version>

        <!-- A comma-separated list of package authors that sometimes appears directly on the gallery -->
        <authors>Dejana Tesic, Rajeev Dey</authors>

        <!-- A project URL that provides a link for the gallery -->
        <projectUrl>http://github.com/contoso/UsefulStuff</projectUrl>

        <!-- License information that's displayed on the gallery -->
        <license type="expression">Apache-2.0</license>
        
        <!-- The location of a read-me file that's displayed in the Visual Studio Package Manager UI -->
        <readme>readme.md</readme>

        <!-- An icon that's used in the Visual Studio Package Manager UI -->
        <icon>icon.png</icon>

        <!-- 
            A property that when true, prompts the user to accept the license when
            installing the package
        -->
        <requireLicenseAcceptance>false</requireLicenseAcceptance>

        <!-- Detailed information about a particular release -->
        <releaseNotes>Bug fixes and performance improvements</releaseNotes>

        <!-- 
            A description that can be used in the Package Manager UI. The
            nuget.org gallery uses information you add in the portal. 
        -->
        <description>Core utility functions for web applications</description>

        <!-- Copyright information -->
        <copyright>Copyright ©2026 Contoso Corporation</copyright>

        <!-- Tags that appear in the gallery and can be used for tag searches -->
        <tags>web utility http json url parsing</tags>

        <!-- Dependencies that are automatically installed when the package is installed -->
        <dependencies>
            <dependency id="Newtonsoft.Json" version="9.0" />
        </dependencies>
    </metadata>

    <!-- A read-me Markdown file that's displayed in the Package Manager UI -->
    <files>
        <file src="readme.md" target="" />
        <file src="icon.png" target="" />
    </files>
</package>

종속성을 선언하고 버전 번호를 지정하는 방법에 대한 자세한 내용은 packages.config 및 패키지 버전 관리를 참조하세요. 요소의 include 특성 및 exclude 특성을 사용하여 패키지에 dependency 포함하거나 제외하려는 종속성 자산을 지정할 수도 있습니다. 자세한 내용은 .nuspec Reference - Dependencies 요소를 참조하세요.

매니페스트는 해당 매니페스트에서 만든 패키지에 포함되어 있으므로 기존 패키지를 검사하여 예제를 찾을 수 있습니다. 적절한 위치는 컴퓨터의 global-packages 폴더입니다. 해당 위치를 찾으려면 다음 명령을 사용합니다.

nuget locals -list global-packages

global-packages 폴더의 위치를 알고 나면 다음 단계를 수행하여 매니페스트 파일을 찾습니다.

global-packages 폴더로 이동합니다.
해당 폴더에서 패키지의 하위 폴더로 이동한 다음 해당 패키지의 모든 버전에 대한 하위 폴더로 이동합니다.
버전 하위 폴더에서 .nupkg 파일의 복사본을 만들고 복사본의 확장 프로그램을 zip으로 변경합니다.
.zip 파일을 열고 그 안에 있는 .nuspec 파일을 검사합니다.

비고

Visual Studio 프로젝트에서 .nuspec 파일을 만들 때 매니페스트에는 패키지가 빌드될 때 프로젝트의 정보로 대체되는 토큰이 포함됩니다. 자세한 내용은 Visual Studio 프로젝트에서 .nuspec 파일 만들기 참조하세요.

.nuspec 파일 만들기

전체 매니페스트 만들기는 일반적으로 다음 방법 중 하나를 통해 생성된 기본 .nuspec 파일로 시작됩니다.

규칙 기반 작업 디렉터리
어셈블리 DLL
A Visual Studio 프로젝트
기본값이 있는 새 파일

그런 다음 최종 패키지에서 원하는 정확한 콘텐츠를 설명할 수 있도록 파일을 직접 편집합니다.

중요합니다

생성된 .nuspec 파일에는 명령을 사용하여 nuget pack 패키지를 만들기 전에 수정해야 하는 자리 표시자가 포함되어 있습니다. .nuspec 파일에 자리 표시자가 포함되어 있으면 이 명령이 실패합니다.

관례 기반 작업 디렉터리에서

NuGet 패키지는 .nupkg 확장명으로 이름이 변경된 ZIP 파일이므로 로컬 파일 시스템에서 원하는 폴더 구조를 만든 다음 해당 구조에서 직접 .nuspec 파일을 만드는 것이 가장 쉬운 경우가 많습니다. 그런 다음 명령은 nuget pack 해당 폴더 구조의 모든 파일을 자동으로 추가하지만 마침표로 시작하는 모든 폴더를 제외하므로 프라이빗 파일을 동일한 구조로 유지할 수 있습니다.

이 방법의 장점은 이 섹션의 뒷부분에서 설명한 대로 패키지에 포함할 파일을 매니페스트에 지정할 필요가 없다는 것입니다. 대신 빌드 프로세스에서 패키지에 들어가는 정확한 폴더 구조를 생성하게 할 수 있습니다. 프로젝트에 속하지 않을 수 있는 다른 파일을 쉽게 포함할 수도 있습니다.

대상 프로젝트에 삽입해야 하는 콘텐츠 및 소스 코드
PowerShell 스크립트
프로젝트의 기존 구성 및 소스 코드 파일로 변환

폴더는 다음 규칙에 맞춥니다.

폴더	목차	패키지 설치 시 작업
(root)	패키지 매니페스트, 최상위 폴더 및 선택적으로 리드미 Markdown 파일과 아이콘 이미지	이 폴더는 lib 및 build와 같은 표준화된 하위 폴더의 시작점으로 사용됩니다.
lib/<tfm>	지정된 TFM(대상 프레임워크 모니커)에 대한 어셈블리(.dll), 설명서(.xml) 및 기호(.pdb) 파일	어셈블리는 컴파일 시간 및 런타임에 대한 참조로 추가됩니다. .xml 및 .pdb 파일은 프로젝트 폴더에 복사됩니다. 프레임워크 대상별 하위 폴더를 만드는 방법에 대한 자세한 내용은 여러 .NET 버전 지원 참조하세요.
ref/<tfm>	지정된 TFM의 어셈블리(.dll) 및 기호(.pdb) 파일	어셈블리는 컴파일 시간에 대해서만 참조로 추가됩니다. 프로젝트 bin 폴더에 아무것도 복사되지 않습니다.
런타임	아키텍처별 어셈블리(.dll), 기호(.pdb) 및 네이티브 리소스(.pri) 파일	어셈블리는 런타임에 대한 참조로만 추가됩니다. 다른 파일은 프로젝트 폴더에 복사됩니다. 해당 컴파일 시간 어셈블리를 제공하려면 `AnyCPU`) < 특정 어셈블리가 있어야 합니다. 여러 .NET 버전 지원 참조하세요.
콘텐츠	임의 파일	콘텐츠는 프로젝트 루트에 복사됩니다. 콘텐츠 폴더를 궁극적으로 패키지를 사용하는 대상 애플리케이션의 루트로 간주합니다. 패키지가 애플리케이션의 /images 폴더에 이미지를 추가하도록 하려면 패키지의 콘텐츠/이미지 폴더에 배치합니다.
build	(3.x+) Microsoft Build 엔진(MSBuild) .targets 및 .props 파일	이러한 파일은 프로젝트에 자동으로 삽입됩니다.
buildMultiTargeting	(4.0 이상) 프레임워크 간 대상 지정을 위한 MSBuild .targets 및 .props 파일	이러한 파일은 프로젝트에 자동으로 삽입됩니다.
buildTransitive	(5.0 이상) MSBuild .targets 및 .props 파일은 모든 소비 프로젝트로 전이적으로 흐릅니다.	이러한 파일은 프로젝트에 자동으로 삽입됩니다. 기능 페이지를 참조하세요.
도구	Package Manager 콘솔에서 액세스할 수 있는 PowerShell 스크립트 및 프로그램	tools 폴더는 Package Manager 콘솔의 `PATH` 환경 변수에만 추가됩니다. MSBuild가 프로젝트를 빌드할 때 사용하는 값에 추가`PATH`.

폴더 구조에는 여러 대상 프레임워크에 대한 어셈블리가 포함될 수 있으므로 여러 프레임워크를 지원하는 패키지를 만들 때 이 메서드가 필요합니다.

원하는 폴더 구조가 있는 경우 해당 폴더에서 다음 명령을 실행하여 .nuspec 파일을 만듭니다.

nuget spec

생성된 .nuspec 파일에는 폴더 구조의 파일에 대한 명시적 참조가 없습니다. NuGet은 패키지를 만들 때 모든 파일을 자동으로 포함합니다. 그러나 매니페스트의 다른 부분에서 자리 표시자 값을 편집해야 합니다.

어셈블리 DLL에서

어셈블리에서 패키지를 만드는 기본 경우 다음 명령을 사용하여 어셈블리의 메타데이터에서 .nuspec 파일을 생성할 수 있습니다.

nuget spec <assembly-name>.dll

이 양식을 사용하면 매니페스트의 몇 자리 표시자가 어셈블리의 특정 값으로 바뀝니다. 예를 들어 <id> 속성은 어셈블리 이름으로 설정되고 <version> 어셈블리 버전으로 설정됩니다. 그러나 매니페스트의 다른 속성에는 어셈블리에 일치하는 값이 없습니다. 명령을 실행한 후에도 이러한 속성에는 자리 표시자가 포함됩니다.

Visual Studio 프로젝트에서

프로젝트에 설치된 다른 패키지는 종속성으로 자동으로 참조되므로 .csproj 또는 .vbproj 파일에서 .nuspec 파일을 만드는 것이 편리합니다. 프로젝트 파일에서 매니페스트를 만들려면 프로젝트 파일이 포함된 폴더에서 다음 명령을 사용합니다.

# Use in a folder that contains a project file, such as <project-name>.csproj or <project-name>.vbproj.
nuget spec

결과 <project-name.nuspec> 파일에는 이미 설치된 다른 패키지에 대한 참조를 포함하여 패키징 시 프로젝트의 값으로 대체되는 토큰이 포함되어 있습니다.

.nuspec에 포함할 패키지 종속성이 있는 경우 대신 nuget pack. 그런 다음 생성된 .nupkg 파일 내에서 .nuspec 파일을 가져옵니다. 예를 들어 다음 명령을 사용합니다.

# Use in a folder that contains a project file, such as <project-name>.csproj or <project-name>.vbproj.
nuget pack myproject.csproj

토큰은 프로젝트 속성의 양쪽에 있는 기호로 구분 $ 됩니다. 예를 들어 <id> 이러한 방식으로 생성된 매니페스트의 값은 일반적으로 다음 줄과 같습니다.

<id>$id$</id>

이 토큰은 압축 시 프로젝트 파일의 값으로 AssemblyName 대체됩니다. 프로젝트 값을 .nuspec 파일 토큰에 정확히 매핑하려면 대체 토큰을 참조하세요.

토큰을 사용하면 프로젝트를 업데이트할 때 .nuspec 파일의 버전 번호와 같은 중요한 값을 업데이트할 필요가 없습니다. 그러나 토큰을 리터럴 값으로 바꿀 수도 있습니다.

이 문서의 뒷부분에서 nuget pack을 실행하여 .nupkg 파일 생성에 설명된 대로 Visual Studio 프로젝트에서 작업할 때 몇 가지 추가 패키징 옵션을 사용할 수 있습니다.

솔루션 수준 패키지

NuGet 2.x만 해당합니다. NuGet 3.0 이상에서는 사용할 수 없습니다.

NuGet 2.x는 Package Manager 콘솔에 대한 도구 또는 추가 명령( 도구 폴더의 콘텐츠)을 설치하지만 솔루션의 프로젝트에 참조, 콘텐츠 또는 빌드 사용자 지정을 추가하지 않는 솔루션 수준 패키지의 개념을 지원합니다. 이러한 패키지에는 직접 라이브러리, 콘텐츠 또는 빌드 폴더에 파일이 포함되지 않으며 해당 종속성 중 어느 것도 해당 라이브러리, 콘텐츠 또는 빌드 폴더에 파일이 없습니다.

NuGet은 프로젝트의 packages.config 파일이 아닌 .nuget 폴더의 packages.config 파일에 설치된 솔루션 수준 패키지를 추적합니다.

기본값이 있는 새 파일에서

다음 명령은 적절한 파일 구조로 시작하는 데 도움이 되는 자리 표시자를 사용하여 기본 매니페스트를 만듭니다.

nuget spec [<package-name>]

생략 <package-name>하면 결과 파일의 이름은 Package.nuspec입니다. 같은 Contoso.Utility.UsefulStuff이름을 제공하는 경우 파일의 이름은 Contoso.Utility.UsefulStuff.nuspec입니다.

결과 .nuspec 파일에는 다음과 같은 projectUrl값에 대한 자리 표시자가 포함됩니다. 파일을 사용하여 최종 .nupkg 파일을 만들기 전에 자리 표시자를 적절한 값으로 바꿉다.

고유한 패키지 식별자를 선택하고 버전 번호를 설정합니다.

패키지 식별자(<id> 요소)와 버전 번호(<version> 요소)는 패키지에 포함된 정확한 코드를 고유하게 식별하기 때문에 매니페스트에서 가장 중요한 두 가지 값입니다.

패키지 식별자에 대한 모범 사례

고유성: 식별자는 패키지를 호스트하는 갤러리에서 고유해야 합니다(예: nuget.org). 식별자를 결정하기 전에 해당 갤러리를 검색하여 이름이 이미 사용 중인지 확인합니다. 충돌을 방지하기 위해 회사 이름을 식별자의 첫 번째 부분(예: Contoso.)으로 사용하는 것이 좋습니다.
Namespace와 유사한 이름: 하이픈 대신 점 표기법을 사용하여 .NET 네임스페이스와 유사한 패턴을 따릅니다. 예를 들어 Contoso.Utility.UsefulStuff을 사용하고 Contoso-Utility-UsefulStuff 또는 Contoso_Utility_UsefulStuff를 사용하지 마십시오. 또한 소비자는 패키지 식별자가 코드에 사용된 네임스페이스와 일치하는 경우에도 유용합니다.
샘플 패키지: 다른 패키지 사용을 보여주는 샘플 코드 패키지를 생성하는 경우, 식별자에 접미사로 .Sample를 붙입니다, 예를 들어 Contoso.Utility.UsefulStuff.Sample. 이 형식의 샘플 패키지는 사용 방법을 보여 주는 패키지에 종속됩니다. 샘플 패키지를 만들 때 앞에서 설명한 규칙 기반 작업 디렉터리 메서드를 사용합니다. 콘텐츠 폴더에서 \Samples\<과 같이 \Samples\>identifier라는 폴더에 샘플 코드를 정렬합니다.

패키지 버전에 대한 모범 사례

일반적으로 라이브러리와 일치하도록 패키지 버전을 설정합니다. 이 지침은 권장되지만 엄격하게 필요하지는 않습니다. 이 방법은 패키지를 패키지할 어셈블리 결정의 앞부분에서 설명한 대로 패키지를 단일 어셈블리로 제한하는 경우 간단합니다. 일반적으로 NuGet 자체는 어셈블리 버전이 아닌 종속성을 확인할 때 패키지 버전을 처리합니다.
비표준 버전 체계를 사용하는 경우 패키지 버전 관리에서 설명한 대로 NuGet 버전 관리 규칙을 고려합니다.

버전 관리 이해에 도움이 되는 다른 리소스는 다음 일련의 간단한 블로그 게시물을 참조하세요.

read-me 파일 및 기타 파일 추가

패키지에 포함할 파일을 직접 지정하려면 태그 뒤에 있는 <files> 파일의 노드를 사용합니다<metadata>.

<?xml version="1.0"?>
<package xmlns="http://schemas.microsoft.com/packaging/2013/05/nuspec.xsd">
    <metadata>
        <!-- ... -->
    </metadata>
    <files>
        <!-- Add files from an arbitrary folder that's not necessarily in the project. -->
        <file src="..\..\SomeRoot\**\*.*" target="" />
    </files>
</package>

팁 (조언)

규칙 기반 작업 디렉터리 접근 방식을 사용하는 경우 readme.md 파일을 패키지 루트 및 콘텐츠 폴더의 다른 콘텐츠에 배치할 수 있습니다. 매니페스트에는 <file> 요소가 필요하지 않습니다.

패키지에 읽기-me 파일을 포함하려면 메타데이터 요소를 사용하여 readme 읽기-me 파일의 대상 경로를 지정합니다. 또한 메타데이터 요소를 사용하여 file 읽기-me 파일의 원본 경로 및 대상 폴더를 지정합니다. 자세한 내용은 readme를 참조하세요.

<?xml version="1.0"?>
<package xmlns="http://schemas.microsoft.com/packaging/2013/05/nuspec.xsd">
    <metadata>
        <!-- ... -->
        <readme>docs\readme.md</readme>
        <!-- ... -->
    </metadata>
    <files>
        <!-- Add a read-me file. -->
        <file src="..\readme.md" target="docs\" />
    </files>
</package>

Visual Studio Package Manager UI에 read-me 파일의 내용을 표시합니다. 예를 들어 다음 스크린샷은 패키지에 대한 HtmlAgilityPack read-me 파일을 보여줍니다.

비고

<files> 파일에 빈 노드를 포함하는 경우 NuGet은 패키지에 lib 폴더의 내용을 포함하지만 다른 콘텐츠는 포함하지 않습니다.

패키지에 MSBuild 소품 및 대상 포함

경우에 따라 빌드 중에 사용자 지정 도구 또는 프로세스를 실행하는 등 패키지를 사용하는 프로젝트에 사용자 지정 빌드 대상 또는 속성을 추가할 수 있습니다. 사용자 지정 빌드 대상 및 속성에 대한 자세한 내용은 패키지의 MSBuild .props 및 .targets를 참조하세요.

프로젝트의 < 폴더에 > 또는 > 파일을 생성하세요. 예를 들어 Contoso.Utility.UsefulStuff.targets 같은 파일을 만듭니다.

그런 다음 .nuspec 파일의 <files> 노드에서 다음 파일을 참조합니다.

<?xml version="1.0"?>
<package >
    <metadata minClientVersion="2.5">
    <!-- ... -->
    </metadata>
    <files>
        <!-- In the package build folder, include everything that's in the local build folder. -->
        <file src="build\**" target="build" />

        <!-- Other files -->
        <!-- ... -->
    </files>
</package>

패키지가 프로젝트에 추가되면 NuGet에는 이러한 속성과 대상이 자동으로 포함됩니다.

nuget pack을 실행하여 .nupkg 파일 생성

어셈블리 또는 규칙 기반 작업 디렉터리를 사용하는 경우 nuget pack 명령을 실행하여 .nuspec 파일과 함께 패키지를 만듭니다. 다음 명령에서 <project-name>를 프로젝트 이름으로 바꾸십시오.

nuget pack <project-name>.nuspec

Visual Studio 프로젝트를 사용하는 경우 프로젝트 파일로 nuget pack 실행합니다. 이 명령은 프로젝트의 .nuspec 파일을 자동으로 로드하고 프로젝트의 토큰을 프로젝트 파일의 해당 값으로 바꿉니다.

nuget pack <project-name>.csproj

비고

토큰 교체의 경우 프로젝트가 토큰 값의 원본이므로 프로젝트 파일을 직접 사용해야 합니다. nuget pack 파일과 함께 사용하면 토큰 대체가 성공하지 못합니다.

모든 경우에 nuget pack 마침표로 시작하는 폴더(예: .git 또는 .hg)를 제외합니다.

NuGet은 업데이트해야 하는 매니페스트의 자리 표시자 값과 같이 수정이 필요한 .nuspec 파일에 오류가 있는지 여부를 나타냅니다.

성공하면 nuget packNuGet 패키지 게시에 설명된 대로 적절한 갤러리에 게시할 수 있는 .nupkg 파일이 있습니다.

팁 (조언)

패키지를 만든 후 검사하는 유용한 방법은 패키지 탐색기 도구에서 여는 것입니다. 이 도구는 패키지 내용 및 해당 매니페스트의 그래픽 보기를 제공합니다. 결과 .nupkg 파일의 이름을 .zip 파일로 바꾸고 해당 내용을 직접 탐색할 수도 있습니다.

추가 옵션

다양한 명령줄 스위치를 nuget pack 사용하여 파일을 제외하고, 매니페스트의 버전 번호를 재정의하고, 출력 폴더를 변경할 수 있습니다. 전체 목록은 pack 명령(NuGet CLI)을 참조하세요.

다음 옵션은 Visual Studio 프로젝트에 공통적인 몇 가지 옵션입니다.

참조된 프로젝트: 프로젝트에서 다른 프로젝트를 참조하는 경우 다음 옵션을 사용하여 -IncludeReferencedProjects 참조된 프로젝트를 패키지의 일부로 추가하거나 종속성으로 추가할 수 있습니다.
```
nuget pack MyProject.csproj -IncludeReferencedProjects
```
이 포함 프로세스는 재귀적입니다. 예를 들어 MyProject.csproj 가 프로젝트 B 및 C를 참조하고 해당 프로젝트가 D, E 및 F를 참조하는 경우 B, C, D, E 및 F의 파일이 패키지에 포함됩니다.

참조된 프로젝트에 자체 .nuspec 파일이 포함된 경우 NuGet은 참조된 프로젝트를 종속성으로 추가합니다. 해당 프로젝트를 별도로 패키지하고 게시해야 합니다.
빌드 구성: 기본적으로 NuGet은 일반적으로 프로젝트 파일에 Debug설정된 기본 빌드 구성을 사용합니다. Release와 다른 빌드 구성의 파일을 압축하려면 -properties 구성 옵션을 사용합니다.
```
nuget pack MyProject.csproj -properties Configuration=Release
```
기호: 소비자가 디버거에서 패키지 코드를 단계별로 실행할 수 있도록 하는 기호를 -Symbols 포함하려면 해당 및 -SymbolPackageFormat 옵션을 사용합니다. 옵션의 -SymbolPackageFormat 경우 다음 형식 snupkg을 지정합니다.
```
nuget pack MyProject.csproj -symbols -SymbolPackageFormat snupkg
```

패키지 설치 테스트

패키지를 게시하기 전에 일반적으로 프로젝트에 패키지를 설치하는 프로세스를 테스트하려고 합니다. 테스트를 통해 필요한 모든 파일이 프로젝트의 올바른 위치에 있게 됩니다.

표준 패키지 설치 단계 사용하여 Visual Studio 또는 명령줄에서 수동으로 설치를 테스트할 수 있습니다.

자동화된 테스트의 경우 다음 기본 프로세스를 사용할 수 있습니다.

.nupkg 파일을 로컬 폴더에 복사합니다.
명령을 사용하여 패키지 원본에 폴더를 추가합니다 nuget sources add -name <name> -source <path> . 자세한 내용은 원본 명령(NuGet CLI)을 참조하세요. 지정된 컴퓨터에서 이 로컬 원본을 한 번만 설정해야 합니다.
nuget install <package-ID> -source <name>을 사용하여 해당 소스에서 패키지를 설치합니다. 이 명령에서 명령 <name> 에서 사용하는 nuget sources 원본의 이름과 일치해야 합니다. 원본을 지정하면 NuGet에서 해당 원본에서만 패키지를 설치하도록 지시합니다.
파일 시스템을 검사하여 파일이 올바르게 설치되어 있는지 확인합니다.

.nupkg 파일인 패키지를 만든 후 선택한 갤러리에 게시할 수 있습니다. 자세한 내용은 NuGet 패키지 게시를 참조하세요.

패키지의 기능을 확장하거나 다른 시나리오를 지원할 수도 있습니다. 자세한 내용은 다음 문서를 참조하세요.

알아야 할 다른 패키지 형식은 다음 문서를 참조하세요.

피드백

이 페이지가 도움이 되었나요?

Last updated on 2026-04-14