This project creates a Visual Studio extension (VISX) containing Project templates and a packaging MSBuild targets file to allow easier Package'n'Publish integration with TFS (or other CI) builds.
It was presented at Developer! Developer! Developer! South West 4 ( http://www.dddsouthwest.com ) on 26th May 2012, and in an updated form at DDDNorth 2 ( http://developerdeveloperdeveloper.com/north2/ ) on 13th October 2012.
Current Build Status
Changes for v0.10
- Visual Studio 2017 now supported by the nuget package (Issue #27)
- How the tooling finds
TextTemplate.exewas changed (again) to support the new (random) location for the latter.
- How the tooling finds
- Tooling no longer tries to locate
tf.exeand checkout using TFS by default (Issue #22)
(See the changelog for more information)
- Visual Studio 2012 SP1.
- Visual Studio 2012 SP1 SDK.
- NuGet Package Manager 2.5 or above.
Option 1 - Add NuGet packaging to a class library
NuGet.PackageNPublishNuGet package to your class library
YourProjectName.ttfile to match your project name!
Rebuild and watch as a NuGet package is created, including all your library's dependencies
Option 2 - Create a NuGet Packaging Project using the NuGet.Package'n'Publish extension
There's a handy screencast demonstrating how to get started on YouTube:
Install the extension into Visual Studio
EITHER from a pre-built .visx file
OR by building the NuGet.PackageNPublish.sln solution (and then installing the generated .visx file)
Add a new NuGet.PackageNPublish project to your solution, perferably at the Solution folder level - e.g.
c:\temp\MySolution -- c:\temp\MySolution\MySolution.sln -- c:\temp\MySolution\MyLibrary
---- c:\temp\MySolution\MyLibrary\MyLibrary.csproj -- c:\temp\MySolution\MyLibrary.NuGetPackage ---- c:\temp\MySolution\MyLibrary.NuGetPackage.csproj
Give the project sensible name ending in .NuGetPackage - e.g. "MyLibrary.NuGetPackage"
If named like this, then the assembly from the packaging project is removed from the package automatically,
Add references to the assemblies you want to include in your package
- By default, if you name your package "MyLibrary.NuGetPackage" (or similar), and reference "MyLibrary" then you're already good to go, AND the packaging project will include your "MyLibrary.dll" automagically, AND it will find and package the source in a symbols package - again automagically.
Any assembly ending in .Silverlight.dll will be put in the lib/SL40 folder within the package.
Any other assembly will be put in the lib/Net40 folder within the package.
Don't forget to add a line to the .tt file for the library for any additional references other than the one to "MyLibrary"
Add dependencies on other NuGet packages
The dependencies will be included automatically in your NuGet package
Set the AssemblyTitle, AssemblyFileVersion and AssemblyDescription in Properties\AssemblyInfo.cs
Build the solution
You now have NuGet (.npkg) and a Symbols (.symbols.nupkg) packages built in your project directory!
How to publish a package
- Build your solution with the /p:PublishNuGetPackage=true msbuild switch
- To change the target repository from the default (http://nuget.org) use the /p:PublishNuGetPackageTarget="http://myrepo.org" switch
- If you've not cached the API key for your custom repository, use the /p:PublishNuGetPackageTargetKey="MySecretAPIKey" switch
How to publish a Symbols package
- Build your solution with the /p:PublishSymbolPackage=true msbuild switch
- To change the target repository from the default (http://symbolsource.org) use the /p:PublishSymbolPackageTarget="http://mysymbolserver.org" switch
- If you've not cached the API key for your custom repository, use the /p:PublishSymbolPackageTargetKey="MySecretAPIKey" switch
Still to do
- A project template for "meta" packages (i.e. those that only contain dependencies on other NuGet packages)
- Documentation! Documentation! Documentation!
Fork it... Fix it... Raise Issues... Generate Pull requests... Use it!
For general chat about the NuGet.PackageNPublish tooling, there's also the JabbR channel - http://jabbr.net/#/rooms/NuGetPackageNPublish