Knowledgebase
Getting Nightly Builds with NuGet
Posted by Andrew BT on 22 June 2014 04:34 PM

As of SciChart v3.1, we are now delivering nightly and stable builds via NuGet. 

What is NuGet? 

NuGet is a package manager for Visual Studio and .NET. It allows you to add a reference to a DLL and download it from the cloud. There is no need to keep DLLs in version control or install them on local disk. You can download them on-demand and link against them during your build process. 

How do I Use it?

In order to publish SciChart WPF and Silverlight we have created a private NuGet feed.

ABT Software Primary NuGet Feed

The ABT Software Primary Nuget feed is hosted by MyGet - professional hosted NuGet. This feed operates over port 80 and SSL and should be available with 99.9% uptime. 

HINT: *.nupkg files can be unzipped if you rename them as zip. They contain the SciChart DLLs. So, even if you are not using NuGet, you can get our nightly builds by clicking the download button on the gallery page and unzipping the package.  

ABT Software Secondary NuGet Feed 

The secondary NuGet feed has had over 5,000 downloads but is being replaced by MyGet above. This is hosted on our development servers at port 81 and will be deprecated soon.

Integrating ABT Software's NuGet Feed with Visual Studio

Step 1: Setup the ABTSoftware NuGet Feed in Visual Studio

You will need to setup your Visual Studio to read from the feed in the following manner:

  • Open Visual Studio, go to Tools -> Options -> NuGet Package Manager -> Package Sources
  • Add the ABT Software NuGet Feed using the following credentials



  • Next, for any Visual Studio project right click the project and select 'Manage NuGet Packages'



  • Choose ABT Software as the feed, and if necessary search for SciChart. 



  • That's it! SciChart will be added as a reference to your project. 

Step 2: Updating to the Latest Build

Every night, our systems will publish a nightly build of the Stable SciChart Release branch to the ABT Software NuGet feed. To get the latest you will need to update the package. There are several ways to do this:

  1. You can download the *.nupkg file directly from the server and unzip it. 
  2. Or, if using NuGet, follow the steps from the NuGet docs - Using the Package Manager Console and use the Package Manager Console command Update-Package SciChart to get the latest. 
  3. Or, re-do the steps above to Manage Nuget Packages and search for SciChart / Install the latest. 

There are a wealth of resources on the web showing how to manipulate NuGet Packages also.

Step 3: Update to a Specific Build

If you would rather update to specific release builds as opposed to nightly builds, you can do this via the Package Manager Console

Uninstall-Package SciChart -Force
Install-Package SciChart -Source https://www.myget.org/F/abtsoftware/api/v2 -Version <!--press tab key for autocomplete -->

Step 4: (Optional) Viewing the Version History

Every night, our Build server publishes Nightly Builds from our repository to the ABT Software NuGet feed(s). This contains critical bug fixes and major/minor stable updates.

You can view the version(s) available in Visual Studio Package Manager Console by using the following command

get-package -ListAvailable -AllVersions -filter SciChart -source https://www.myget.org/F/abtsoftware/api/v2 

 

Troubleshooting NuGet Packages

Q: I can't build when Referencing NuGet in Visual Studio

If you experience any problems building a project which references a NuGet package, ensure the Enable Package Restore option is enabled on your Visual Studio project. 

Q: I can't build when referencing SciChart via NuGet on a Build Server, or on another computer

Make sure the ABT Software NuGet feed is included in your NuGet.targets file, like this:

<ItemGroup Condition=" '$(PackageSources)' == '' ">
	<!-- Package sources used to restore packages. By default, registered sources under %APPDATA%\NuGet\NuGet.Config will be used -->
	<!-- The official NuGet package source (https://www.nuget.org/api/v2/) will be excluded if package sources are specified and it does not appear in the list -->        
	<PackageSource Include="https://www.nuget.org/api/v2/" />
	
	<!-- Also include the ABT Software NuGet feed -->
	<PackageSource Include="https://www.myget.org/F/abtsoftware/api/v2"/>
</ItemGroup>

Limitations

  • We are only publishing critical bug fixes, or major/minor stable updates from our release branches. You can use the Nightly Build in production systems with confidence.
  • Currently the NuGet feed is public, however, we reserve the right to make it private for enterprise customers at a later date.
  • We are only publishing SciChart in WPF and Silverlight in .NET4.0 and SL5 configurations and SciChart3D in .NET4.0 configuration.
    • Don't forget you can use a .NET4.0 DLL in a .NET4.5 or 4.5.1 application without problems. 
    • We are not publishing x86 and x64, as NuGet does not support platform specific DLLs. 
    • The ABT.Controls.SciChart3D.Wpf DLL (containing the DirectX10 Renderer) has a dependency on SharpDX. This will be automatically installed when you install the SciChart3D package. 

 

 

 



Attachments 
 
(2 vote(s))
Helpful
Not helpful

CONTACT US

Not sure where to start? Contact us, we are happy to help!


CONTACT US

SciChart Ltd, 16 Beaufort Court, Admirals Way, Docklands, London, E14 9XL. Email: Legal Company Number: 07430048, VAT Number: 101957725