Nuget is easier than you think 

and 

you should be using it.

By
Justin James

About Me

Topics

Quick Survey

What is the heck Nuget?

Where can I get nuget packages?

What happens when I consume a package?

1. Looks at package  dependencies to figure out what is installed 
2. Downloads any missing dependencies and installs them
3. Downloads package and installs it
4. package.config file created in project folder
5. repositories.config file is created in the packages folder

What does install a package mean?

1. If package is used before then Uninstall.ps1 is run
2. References, Source Files, and Config changes are removed
3. A folder for each package is created in the package folder
4. Package is uncompressed
5. Any dll in the lib folder is added as a reference
6. Anything in the content folder are copied into the project
7. Files with a .pp extensions are transformed into source files
8. Xml files with a .transform extension are merged
9. Xml files with a (un)install.xdt are transformed
10. Init.ps1 is run
11. Install.ps1 is run

What happens when I build a solution?

Demo

Creating Packages Topics

Creating Packages Overview

Creating Packages Overview

May contain: 

• assemblies
• source code
• powershell scripts
• executables
• config files
• config/source transformations
  

If publishing package publicly, need a free account at http://nuget.org/   

Solution level Packages

Package Conventions

Supporting Multiple Frameworks

Basic Package Creation

Example Nuget Spec Non-VS

 <?xml version="1.0" encoding="utf-8"?>
<package xmlns="http://schemas.microsoft.com/packaging/2012/06/nuspec.xsd">
  <metadata>
    <id>log4net.blank.config</id>
    <version>1.0.0</version>
    <title>Log4Net Blank Configuration File</title>
    <authors>Justin James</authors>
    <owners>Justin James</owners>
    <requireLicenseAcceptance>false</requireLicenseAcceptance>
    <description>Inserts a blank log4net.config file.</description>
    <summary>Log4Net Blank Configuration File</summary>
    <releaseNotes>Initial Rev</releaseNotes>
    <dependencies>
      <dependency id="log4net" version="2.0.3" />
    </dependencies>
  </metadata>                                                                                                                                                                                                                                                                                                                                                                                            

  <files>
    <file src="**" exclude="build.cmd" />
  </files>
</package>

Example Nuget Spec - VS

<?xml version="1.0"?>
<package >
  <metadata>
    <id>$id$</id>
    <version>$version$</version>
    <title>$title$</title>
    <authors>$author$</authors>
    <owners>$author$</owners>
    <requireLicenseAcceptance>false</requireLicenseAcceptance>
    <description>$description$</description>
    <releaseNotes> Summary of changes made in this release.</releaseNotes>
    <copyright>Copyright 2014</copyright>
    <tags>Demo</tags>
  </metadata>
</package>

Common Nuget Pack Options

Using a GUI to create packages

Questions on Creation Basics?

2 ways to update configs files

[Filename].transform

[Filename].*.xdt

Transform Source Code

Powershell Scripts

Powershell Scripts Cont.

Demo

Hosting Your Own Nuget Feed

Tell Everyone about the Feed

Demo 

Updating nuget

Nuget vNext (aka 3.0) 

Other projects using nuget

More Information

Books

Questions?

Backup

What does a nupkg do?

3 ways to play with packages

Spec Replacement Tokens

Getting Help

Installing Packages

Common Commands

Updating Packages

Uninstall Package

Re-Install Packages

Framework and Profiles

Framework Versions Examples

Useful PM Console Switches

Publishing Packages

Hosting Remote Feed in Azure 

Include/Exclude Files

Dependencies

Assembly References

Framework Assembly References

UI Preview