Windows - How to configure a new project

Using the SDK - New project

• Install Visual Studio 2019 or newer

• Unzip Binah_Windows_SDK_[version].zip

• Create a new project in Visual Studio. The Project can be of type (WPF App, Console App). Can be for Platform .NET Core (3.1, 3,0) or .NET Framework (4.7.2 - 4.5).

• Select the configuration (Debug\Release) and the platform x64

• Open the Reference Manager dialog (In a .NET Framework project right click References=>Add Reference…, In a .NET Core project right click Dependencies=>Add Project Reference…)
  
  
  
  

• In the dialog, click browse, navigate to the SDK folder, select the Binah.WindowsSdk.Core.dll Assembly, and add it.

• Do the same with Binah.WindowsSdk.Common.dll

• If it is a .net Framework project in the dialog click on Assemblies and select System.Drawing Assembly and add it. (Not needed if it is a .NET Core project)

• In the Solution Explorer right click on the project and click Manage NuGet Packages…

• Browse and install the following packages:

  • "Cats.CertificateTransparency" Version="2.0.0"

  • "Extended.Wpf.Toolkit" Version="4.4.0"

  • "GuerrillaNtp" Version="2.0.1"

  • "Microsoft.Composition" Version="1.0.31"

  • "Microsoft.Win32.Registry" Version="5.0.0"

  • "Microsoft.Xaml.Behaviors.Wpf" Version="1.1.39"

  • "Newtonsoft.Json" Version="13.0.1"

  • "NLog.Extensions.Logging" Version="5.0.2"

  • "System.ComponentModel.Composition" Version="6.0.0"

• If not a UWP project, also Browse and install “Microsoft.Windows.SDK.Contracts” version "10.0.22621.2" and install it.

• Create a HealthMonitorManager and use it to create a session. A detailed example of this can be found in the common flow section of the interface document.

• Build the solution. Make sure in the output the build succeeded with no errors.

• Please note that when building the project the .net Assemblies of the SDK will be copied automatically to the output folder. The native dlls however will not be copied automatically and need to be copied to the output folder before the project can run.
  The dlls that need to be copied are (Binah.WindowsSdk.Algo.Interop.dll, Binah.WindowsSdk.Licensing.dll, Binah.WindowsSdk.NativeWrappers.dll)

• Run the project.

For a non UWP project, you should see the following NuGet dependencies list:

<ItemGroup> 
  <PackageReference Include="Cats.CertificateTransparency" Version="2.0.0" /> 
  <PackageReference Include="Extended.Wpf.Toolkit" Version="4.4.0" /> 
  <PackageReference Include="GuerrillaNtp" Version="2.0.1" /> 
  <PackageReference Include="Microsoft.Composition" Version="1.0.31" />
  <PackageReference Include="Microsoft.Win32.Registry" Version="5.0.0" />
  <PackageReference Include="Microsoft.Windows.SDK.Contracts" Version="10.0.22621.2" />
  <PackageReference Include="Microsoft.Xaml.Behaviors.Wpf" Version="1.1.39" />
  <PackageReference Include="Newtonsoft.Json" Version="13.0.1" />
  <PackageReference Include="NLog.Extensions.Logging" Version="5.0.2" />
  <PackageReference Include="System.ComponentModel.Composition" Version="6.0.0" />
 </ItemGroup>