{"id":39534,"date":"2020-06-18T06:00:26","date_gmt":"2020-06-18T13:00:26","guid":{"rendered":"https:\/\/devblogs.microsoft.com\/premier-developer\/?p=39534"},"modified":"2020-06-15T06:45:27","modified_gmt":"2020-06-15T13:45:27","slug":"how-to-debug-and-step-into-service-fabric-sdk-source-code","status":"publish","type":"post","link":"https:\/\/devblogs.microsoft.com\/premier-developer\/how-to-debug-and-step-into-service-fabric-sdk-source-code\/","title":{"rendered":"How to Debug and Step Into Service Fabric SDK Source Code"},"content":{"rendered":"

In this blog, Premier Consultant Kurt Schenk shows how to debug into the source code of the Service Fabric SDK which is used to develop Reliable Services and Reliable Actors. Service Fabric is open source, including the SDK which is on GitHub here<\/a>.<\/p>\n

\n

#1. Determine what commit to check out of GitHub<\/strong><\/p>\n

You need to match the source code that you check out with the NuGet package that you are referencing. For example, using Visual Studio we can see that my service is referencing these Service Fabric NuGet packages.<\/p>\n

\"Machine<\/p>\n

This is 6.4 CU6 release of Service Fabric, on May 2nd, 2019, which you can verify by going to https:\/\/docs.microsoft.com\/en-us\/azure\/service-fabric\/release-notes<\/a> and clicking on “release notes” in section “Service Fabric 6.4 releases” for May 2, 2019. You will see the following table showing that this release is compatible with Service Fabric .NET SDK (3.3.658) \/ Microsoft.ServiceFabric (6.4.658)<\/p>\n

\"Machine<\/p>\n

If you are referencing the latest version (Major.Minor) of a Service Fabric release (6.4, 6.5, 7.0, 7.1, https:\/\/docs.microsoft.com\/en-us\/azure\/service-fabric\/release-notes <\/a>) then you can check out the release branch as shown below. So branch release_3.3 is 6.4 CU7 released May 28, 2019 which is .NET SDK (3.3.664) \/ Microsoft.ServiceFabric (6.4.664).<\/p>\n

\"Machine<\/p>\n

If you navigate to https:\/\/github.com\/microsoft\/service-fabric-services-and-actors-dotnet\/blob\/release_3.3\/properties\/service_fabric_common.props<\/a> you will see the same confirmed there.<\/p>\n

<NugetPkg_Version_Microsoft_ServiceFabric>6.4.644<\/NugetPkg_Version_Microsoft_ServiceFabric>\r\n\r\n<NugetPkg_Version_Microsoft_ServiceFabric_Diagnostics_Internal>3.3.644<\/NugetPkg_Version_Microsoft_ServiceFabric_Diagnostics_Internal>\r\n\r\n<NugetPkg_Version_Microsoft_ServiceFabric_Data>3.3.644<\/NugetPkg_Version_Microsoft_ServiceFabric_Data>\r\n\r\n<NugetPkg_Version_Microsoft_ServiceFabric_FabricTransport_Internal>3.3.644<\/NugetPkg_Version_Microsoft_ServiceFabric_FabricTransport_Internal>\r\n\r\n\r\n\r\n\r\n<MajorVersion>3<\/MajorVersion>\r\n\r\n<MinorVersion>3<\/MinorVersion>\r\n\r\n<BuildVersion>17<\/BuildVersion>\r\n\r\n<Revision>0<\/Revision<\/pre>\n
However, in my sample project I am using a slighter earlier version of the Service Fabric SDK and therefore have to go back a few commits, from 6.4.664 back 6.4.658. To find an exact match, look at AssemblineInformationVersion for one of the Service Fabric SDK assemblies referenced in the service, and match to MajorVersion.MinorVersion.BuildVersion.Revision in service_fabric.common.props. For example, looking at bin\\x64\\Release\\Microsoft.ServiceFabric.Actors.dll with ILSpy, I see AssemblineInformationVersion 3.3.15.0.<\/p>\n
[assembly: TargetFramework(\".NETFramework,Version=v4.5\", FrameworkDisplayName = \".NET Framework 4.5\")]\r\n\r\n[assembly: AssemblyCompany(\"Microsoft\")]\r\n\r\n[assembly: AssemblyConfiguration(\"Release\")]\r\n\r\n[assembly: AssemblyCopyright(\"Copyright (c) Microsoft Corporation. All rights reserved.\")]\r\n\r\n[assembly: AssemblyFileVersion(\"3.3.15.0\")]\r\n\r\n[assembly: AssemblyInformationalVersion(\"3.3.15.0\")]\r\n\r\n[assembly: AssemblyProduct(\"Microsoft Azure Service Fabric\")]\r\n\r\n[assembly: AssemblyTitle(\"Microsoft.ServiceFabric.Actors\")]\r\n\r\n[assembly: SecurityPermission(SecurityAction.RequestMinimum, SkipVerification = true)]\r\n\r\n[assembly: AssemblyVersion(\"6.0.0.0\")]\r\n<\/pre>\n
Going back a bit in commit history there is a match here: https:\/\/github.com\/microsoft\/service-fabric-services-and-actors-dotnet\/blob\/fe334251815b33aa3d29f243d0c9a2ae5ea8d8d6\/properties\/service_fabric_common.props<\/a>.<\/p>\n
Now we can check out commit fe334251815b33aa3d29f243d0c9a2ae5ea8d8d6 and this will be an exact match for the Service Fabric SDK source code.<\/p>\n