NuGet Packages

NuGet can be used to automatically add files and references to your Visual Studio projects. You can use the Syncfusion UWP NuGet packages without installing the Essential Studio or UWP platform installation to development with the Syncfusion UWP controls. From v16.2.0.46 (2018 Volume 2 Service Pack 1) onwards, all the Syncfusion components are available as NuGet packages at nuget.org.

NOTE

Starting from v17.1.0.32 (2018 Volume 1), Syncfusion will no longer publish NuGet packages at nuget.syncfusion.com.

Installing NuGet Packages

Using NuGet Package Manager

The NuGet Package Manager can be used to search and install NuGet packages in the Visual Studio solution or project.

  1. Right-click the project or solution in the Solution Explorer tab, and choose Manage NuGet Packages…

    NuGet package manager add-in for windows

    Alternatively, click Tools menu, NuGet Package Manager | Manage NuGet Packages for Solution...

  2. By default, the NuGet.org package is selected in the Package source drop-down. If NuGet.org is not configured in your Visual Studio, refer to the Microsoft docs to configure NuGet.org feed URL in your Visual Studio.

    NuGet package manager dialog window

  3. The NuGet Packages are listed and available in the package source feed URL. Search and install the required packages in your application, by clicking Install button.

NOTE

The Syncfusion NuGet packages are published in public NuGet.org from v16.2.0.46. So, If you need to Install earlier version of 16.2.0.46 Syncfusion NuGet packages, configure Syncfusion private feed URL.

Using Package Manager Console

To reference the Syncfusion UWP component using the Package Manager Console as NuGet packages, follow the below steps.

  1. On the Tools menu, select NuGet Package Manager and then Package Manager Console.

  2. Run the following NuGet installation commands:

    #install specified package in default project
    Install-Package <Package Name>
    
    #install specified package in specified project 
    Install-Package <Package Name> - ProjectName <Project Name>
    

    For example:

    #install specified package in default project
    Install-Package Syncfusion.Calculate.UWP46
    
    #install specified package in specified project 
    Install-Package Syncfusion.Calculate.UWP46-ProjectName SyncfusionDemoApplication
    

Managing NuGet package using NuGet CLI

The NuGet Command Line Interface (CLI), nuget.exe, provides the full extent of NuGet functionality to install, create, publish, and manage packages without making any change to the project files.

  1. Download the latest NuGet CLI from here.

    NOTE

    To update the existing nuget.exe to latest version use the following command.

    nuget update -self
    
  2. Open the downloaded executable location in the command window, and run the following commands to download and install the required NuGet packages to a project specified in the package.config.

    #install specified package in default project from specified Package Source 
    nuget.exe install <Package name | ConfigFilePath > [Options]
    

    NOTE

    configPath is optional. This identifies the packages.config or solutions file that lists the packages utilized in the project.

    For example:

    #install specific package 
    nuget.exe install “Syncfusion.Calculate.UWP46”
    
    #install all package which mention in package.config path 
    nuget.exe install “C:\Users\SyncfusionApplication\package.config”
    

NOTE

If you need to Install earlier version of 16.2.0.46 Syncfusion NuGet packages, configure Syncfusion private feed URL.

Upgrading NuGet packages

Using NuGet Package Manger

NuGet packages can be updated to their specific version or latest version available in the Visual Studio solution or project.

  1. Right-click the project or solution in the Solution Explorer tab, and choose Manage NuGet Packages…
    Alternatively, click Tools menu, NuGet Package Manager | Manage NuGet Packages for Solution...

  2. Select the Updates tab to see the packages available for update from the desired package sources. Select the required packages and the specific version from the dropdown, and click the Update button.

Using Package Manger Console

To update the installed Syncfusion UWP NuGet packages using the Package Manager Console, follow the below steps.

  1. On the Tools menu, select NuGet Package Manager, and then Package Manager Console.

  2. Run the following NuGet installation commands:

    #Update specific NuGet package in default project
    Update-Package <Package Name>
    
    #Update all the packages in default project
    Update-Package 
    
    #Update specified package in specified project 
    Update-Package <Package Name> - ProjectName <Project Name>
    

    For example:

    #Update specified Syncfusion UWP NuGet package 
    Update-Package Syncfusion.Calculate.UWP46
    
    #Update specified package in specified project 
    Update-Package Syncfusion.Calculate.UWP46 -ProjectName SyncfusionDemoApplication
    

Using NuGet CLI

Using the NuGet CLI, all the NuGet packages in the project can be updated to the available latest version.

  1. Download the latest NuGet CLI from here.

    NOTE

    To update the existing nuget.exe to latest version use the following command.

    nuget update -self
    
  2. Open the downloaded executable location in the command window. Run the following “update commands” to update the Syncfusion UWP NuGet packages.

    #update all NuGet packages from config file
    nuget update <configPath> [options]
    
    #update all NuGet packages
    nuget update
    

    NOTE

    configPath is optional. This identifies the packages.config or solutions file lists the packages utilized in the project.

    For example:

    #Update all NuGet packages from config file
    nuget update “C:\Users\SyncfusionApplication\package.config”
    

Syncfusion NuGet feed URL Configuration

Get the Syncfusion NuGet feed URL

You should get the private Syncfusion UWP NuGet feed URL to install or upgrade the Syncfusion UWP NuGet packages. To get the URL from Syncfusion website use the following steps:

  1. Navigate to nuget.syncfusion.com, and select the MOBILE tab.

  2. Click the Copy URL label under UWP platform to copy the Syncfusion UWP platform NuGet feed to clipboard or directly use the following URL:

    https://nuget.syncfusion.com/nuget_universalwindows/nuget/getsyncfusionpackages/universalwindows

    Syncfusion UWP NuGet feed URL

  3. Now, use this NuGet feed URL to access the Syncfusion NuGet Packages in Visual Studio.

Add the Syncfusion NuGet feed URL

Windows

  1. Open your Visual Studio application.

  2. On the Tools menu, select Options.

  3. Expand the NuGet Package Manager and select Package Sources.

  4. Click the Add button (green plus), and enter the ‘Package Name’ and ‘Package Source URL’ of the Syncfusion UWP NuGet packages.

    Name: Name of the package listed in the available package sources.
    Source: Syncfusion UWP NuGet Feed URL
    https://nuget.syncfusion.com/nuget_universalwindows/nuget/getsyncfusionpackages/universalwindows.

  5. Click the Update button to add the name and source details to package sources.

    NuGet Package Manager dialog with Syncfusion UWP NuGet feed URL for reference

NuGet CLI

  1. Download the latest NuGet CLI from here.

    NOTE

    To update the existing nuget.exe to latest version use the following command.

    nuget update -self
    
  2. Open the downloaded executable location in the command window, and run the following commands to configure the Syncfusion UWP NuGet packages.

    #Add specified Package Source in NuGet.config file 
    nuget.exe Sources Add –Name <Source name> –Source <Source location>  
    

    For example:

    nuget.exe Sources Add –Name “Syncfusion Source” –Source “https://nuget.syncfusion.com/nuget_universalwindows/nuget/getsyncfusionpackages/universalwindows”