Troubleshoot the project
9 Mar 20238 minutes to read
The Syncfusion Troubleshooter will be installed in Visual Studio along with Syncfusion Essential Studio setup installation. The Syncfusion Troubleshooter can be done the below items,
-
Report the Configuration issues.
-
Apply the solution
Report the Configuration issues
The following steps help you to utilize the Syncfusion Troubleshooter by Visual Studio.
-
To open Syncfusion Troubleshooter Wizard, follow either one of the options below:
Option 1:
Open an existing Syncfusion Application, choose Syncfusion menu. Then select corresponding platform menu and click Troubleshoot…NOTE
In Visual Studio 2019, Syncfusion menu available under Extension in Visual Studio menu.
Option 2:
Right-click the Project file in Solution Explorer, then select the command Syncfusion Troubleshooter… Refer to the following screenshot for more information. -
Now it’s analyze the project and it will report the project configuration issues of Syncfusion controls in the Troubleshooter dialog if any issues found. If the project doesn’t have any configuration issue, the dialog box will show there is no configuration changes required in following areas,
-
Syncfusion assembly references.
-
Syncfusion Web.config entries.
-
Syncfusion NuGet Packages.
-
IMPORTANT
The Syncfusion Troubleshooter command will be visible only for Syncfusion projects that means the project should contain Syncfusion assemblies or Syncfusion NuGet packages referred.
Syncfusion Troubleshooter handles the below project configuration issues,
-
Assembly Reference Issues.
-
Web.config Issues (for Web applications).
-
NuGet related Issues.
Assembly Reference Issues
The Syncfusion Troubleshooter deals with below assembly reference issues in Syncfusion Projects.
-
Dependent assemblies are missing for referred assemblies from project.
For Instance: If “Syncfusion.Tools.WPF” assembly referred in project and “Syncfusion.Shared.WPF” (dependent of Syncfusion.Tools.WPF) not referred in project, Syncfusion Troubleshooter will be shown dependent assembly missing.
-
Syncfusion assembly version mismatched. Compare to all Syncfusion assembly’s versions are in same project. If found any Syncfusion assembly version inconsistency, Syncfusion Troubleshooter will be shown Syncfusion assemblies version mismatched.
For Instance: If “Syncfusion.Tools.WPF” assembly (v15.2450.0.43) referred in project, but other Syncfusion assemblies referred assembly version is v15.2450.0.40. Syncfusion Troubleshooter will be shown Syncfusion assembly version mismatched.
-
Framework version mismatching (Syncfusion Assemblies) with project’s .NET Framework version. Find the supported .NET Framework details for Syncfusion assemblies in below link,
For Instance: The.NET Framework of the application is v4.5 and “Syncfusion.Tools.WPF” assembly (v15.2400.0.43 & .NET Framework version 4.0) referred in same application. The Syncfusion Troubleshooter will be shown Syncfusion assembly .NET Framework version is incompatible with project’s .NET Framework version.
Web.config Issues (for Web applications)
The Syncfusion Troubleshooter deals with below web.config issues in Syncfusion web projects.
-
Syncfusion assembly entry version mismatched. Each Syncfusion assembly entry version/.NET Framework version will be compared with corresponding referred Syncfusion assembly in the application.
For Instance: If “Syncfusion.EJ.Export” assembly (v15.2450.0.46) referred in project, But “Syncfusion.EJ.Export” assembly entry version (v15.2450.0.33) in Web.config file. Syncfusion Troubleshooter will be shown Syncfusion assembly entry version mismatched.
-
Multiple version and Duplicate Syncfusion assembly entry. Syncfusion Troubleshooter will show the duplicate assembly entry when Syncfusion assembly entry presented in Web.config which is not referred in project or multiple Syncfusion assembly entry in Web.config for same Syncfusion assembly.
For Instance: If project have “Syncfusion.EJ.Pivot” assembly (v15.2450.0.43) entry in Web.config file, But “Syncfusion.EJ.Pivot” assembly not referred in project. Syncfusion Troubleshooter will be show Duplicate assembly entry.
For Instance: If project Multiple “Syncfusion.EJ” assembly (v15.2400.0.46 && v15.2460.0.46) entry with mismatched assembly version/.NET Framework version in Web.config, Syncfusion Troubleshooter will show the Duplicate assembly entry and Multiple Syncfusion assembly entries.
-
Namespace entry missing. If any Syncfusion namespaces are missing in Web.config that is related to referred Syncfusion assemblies in project, Syncfusion Troubleshooter will show namespace entry is missing.
For Instance: If “Syncfusion.EJ.MVC” assembly (v15.2450.0.46) referred in project and “Syncfusion.MVC.EJ” namespace entry missing in Web.config file, Syncfusion Troubleshooter will show Syncfusion namespace entry missing.
-
Namespace entry version mismatched. If any Namespace entry version (assembly version) mismatched with corresponding referred assembly version in ASP.NET Web Application, Syncfusion Troubleshooter will be shown Namespace entry version mismatched.
For Instance: If “Syncfusion.EJ” assembly (v15.2450.0.46) referred in project and “Syncfusion.JavaScript.DataVisualization” Namespace entry version (v15.2450.0.43) in Web.config file. Syncfusion Troubleshooter will be show Syncfusion namespace entry version mismatched.
-
HTTP/Server handler entry mismatched. HTTP/Server handler entry version compare to corresponding referred assembly version in project. If any Syncfusion HTTP/Server handler entry version mismatched, Syncfusion Troubleshooter will show HTTP/Server handler entry mismatched.
For Instance: If “Syncfusion.EJ.” assembly (v15.2450.0.46) referred in project, But “Syncfusion.JavaScript.ImageHandler” HTTP/Server handler entry version (v15.2450.0.43) in Web.config file. Syncfusion Troubleshooter will be show Syncfusion HTTP/Server handler entry version mismatched.
NuGet Issues
The Syncfusion Troubleshooter deals with below NuGet package related issues in Syncfusion projects.
-
Multiple versions of Syncfusion NuGet Packages are installed. If Syncfusion NuGet Package version is differ from other Syncfusion NuGet Package version, Syncfusion Troubleshooter will be shown Syncfusion NuGet package version is mismatched.
For Instance: Syncfusion.Web,Base package installed multiple version(v15.2.0.43 & v15.2.0.46), Syncfusion Troubleshooter will be shown Syncfusion package version mismatched.
-
Installed Syncfusion NuGet package’s Framework version is differing from the project’s .NET Framework version.
For Instance: Syncfusion.Calculate.Base NuGet package version(v15.2.0.46 with 4.0 Framework) installed in project, But the project .NET Framework version is 4.5. So, Syncfusion Troubleshooter will be show Syncfusion package Framework version is mismatched.
-
Dependent NuGet package of the installed Syncfusion NuGet packages is missing.
For Instance: If install Syncfusion.Calculate.WPF NuGet package alone in project, Syncfusion Troubleshooter will show the Syncfusion.Calculate.Base dependent NuGet package missing.
IMPORTANT
Internet connection is required to restore the missing dependent packages. If no Internet is available, the dependent packages will not be restored.
Apply the solution
-
Once the Syncfusion Troubleshooter dialog loads, check the corresponding check box of the issue which you need to resolve. Then click the “Fix Issue(s)” button.
-
A dialog appears, which will ask to take a backup of the project before perform the troubleshooting process. If you need to backup the project before troubleshooting click “Yes” button.
-
Wait for a while, the Syncfusion Troubleshooter is being resolve the selected issues. Once the troubleshooting process completed, there will be a status message in the Visual Studio status bar as “Troubleshooting process completed successfully.”
-
Then, Syncfusion licensing registration required message box will be shown as follow, if you are installed the trial setup or NuGet packages since Syncfusion introduced the licensing system from 2018 Volume 2 (v16.2.0.41) Essential Studio release. Please navigate to the help topic which is shown in the licensing message box to generate and register the Syncfusion license key to your project. Refer to this blog post for understanding the licensing changes introduced in Essential Studio.