How to debug the existing Syncfusion source code?
Debugging the existing Syncfusion source code
Syncfusion has started to provide source code as a separate installer named ‘Essential Studio Source Code Add-on’ since v9.4.0.62. To access the source code, install the Essential Studio Source Code Add-on. You can access the Essential Studio Source Code Add-on from the Essential Studio Dashboard. You can also download it from the Products and Downloads page using your support account in Direct-Trac. When you are using earlier versions like 9.3.0.x, you must install Essential Studio with the respective version’s unlock key. For example, when you are working with Essential Studio v8.3.0.21, you would need to install it with the v8.3.0.21 unlock key.
You can refer the detailed documentation about Source Code Add-ons from the following link.
In order to debug Syncfusion’s source code, ensure that the necessary code is shipped to your machine under the following path:
Path: [Syncfusion Installed Path]\platforms
When you make changes to the Syncfusion source code and want to use it in your application, you need to rebuild the source again. The tool, Build Manager, makes your work easy.
- Based on the .NET Framework installed in your machine, the Syncfusion Build Manager enables the framework version check box.
- When you are using Essential Studio v.8.1.0.30, download the Syncfusion Assembly Manager from the following location:
- Replace the AssemblyManagerWindows.exe file and the AssemblyManagerConsole.exe file in the following path:
Path: [Syncfusion Installed Path]\Utilities\AssemblyManager
- For all other Essential Studio versions, you can use the Assembly Manager from the above mentioned installed path.
The source of the assemblies listed above can be found under the following path:
For 32 bit: ${install_drive}:\Program Files\Syncfusion\Essential Studio\${version}
For 64 Bit: ${install_drive}:\Program Files (x86)\Syncfusion\Essential Studio\${version}
Follow the instructions provided to build assemblies with Build Manager.
- Open the Dashboard and run the Build Manager Utility.
- Choose the framework version you want and the product from the Product combo box.
- By checking the Use Prebuilt Dependencies option, you can also choose the dependency assemblies to be built in debug mode or from a precompiledassemblies folder.
- Choose the Debug option under the Assembly Type group box.
- Choose Perform Build. Doing so compiles the assemblies that can be debugged and the PDB files into the following path:
Path: [Syncfusion Installed Path]\UserAssemblies\[version]\[Framework Version]\debug
Figure 1: Syncfusion Build Manager
- Once the build is complete, click the Launch Assembly Manager button from the Build Manager tool to open the Syncfusion Assembly Manager.
- Choose the Remove All Versions option under Action in the Assembly Manager.
Figure 2: Syncfusion Assembly Manager
- In order to install, you have to choose the assembly type as Debug, and then choose Perform Action.
Figure 3: Debug and Perform Action
- Open your project and ensure that you have set Copy Local as False in all Syncfusion assemblies, then, recompile the project.
- Set a breakpoint, creating an instance of a Grid control, and then run your application.
- Once Visual Studio hits the breakpoint, press the F11 key to debug the Syncfusion control source code.
You can refer the detailed documentation about Build Manager in the following link:
