Building from Source

To work with the SDK source code you'll need to download and install Microsoft Visual Studio Express 2013 for Windows Desktop or an appropriate paid version.

Building the Source Code

1. Clone the repository to your local machine. You can do this on the repository home page by clicking "Clone in Desktop".
2. Double-click ds3_net_sdk.sln to open the solution in Visual Studio.
3. In the Solution Explorer window on the right, right click the top solution element.
4. Click "Configuration Manager..."
5. Select "Release" or "Debug" in the drop-down on the top-right. "Debug" bundles debugging symbols with .dlls so you can debug the SDK with Visual Studio. "Release" should be used when creating a distributable.
6. Click "Close" to exit the configuration manager.
7. Press Ctrl+Shift+b to build all projects in the solution.

You can find the respective binaries in the bin/Debug or bin/Release directory of each project.

• The Ds3 project contains the core SDK. The resulting binary is called ds3_net_sdk.dll. You do not need to distribute any of the other files in the bin directory.
• The Ds3Client project contains the PowerShell module. The resulting PowerShell module is the folder bin/[Debug or Release]/Modules/Ds3Client
• The Ds3ClientInstaller project creates an executable that copies the PowerShell module files to the correct location. This project always copies the module from Ds3Client/bin/Release. The resulting executable is called Ds3ClientInstaller.exe. You do not need to distribute any of the other files in the bin directory.
• The TestDs3 project contains unit tests for the SDK itself. See Running Unit Tests
• The TestDs3Client project contains unit tests for the configuration cmdlets in the PowerShell module. See Running Unit Tests