UiPath Documentation
robot
2024.10
false
Robot admin guide

.NET troubleshooting

Solutions for .NET-related errors when installing or upgrading UiPath Robot with MSI installers, including corrupted .NET runtime issues.

.NET required during the MSI upgrade​

Description​

Upgrading the Robot with MSI installers (Studio or Robot) fails with the following error: "You must install.NET Desktop Runtime to run this application."

Potential issue​

The.NET Desktop Runtime or.NET Runtime installed on your machine may be corrupted.

Solution​

Uninstall the.NET Desktop Runtime/.NET Runtime from your device and run the UiPath MSI installer again.

Activities cannot find .NET Runtime​

Description​

Workflows using specific activity packages fail when executed by 2023.4.0 and newer robots. The following errors are displayed:

  • "To run this application, you must install missing frameworks for .NET."
  • "To run this application, you must install .NET."

Impacted activity packages​

  • UiPath.Form.Activities version 2.0.x
  • UiPath.IntelligentOCR.Activities
  • UiPath.MobileAutomation.Activities
  • UiPath.Vision
  • UiPath.DocumentUnderstanding.Activities
  • OCR related activities in the UiPath.UIAutomation.Activities package
  • UiPath.OmniPage.Activities
  • UiPath.OCR.activities

Solution 1​

Upgrade the activity packages of the problematic workflows to the latest versions.

Solution 2​

Add an Invoke Code activity at the start of the problematic workflow with the following snippet:

System.Environment.SetEnvironmentVariable("DOTNET_ROOT", System.AppContext.BaseDirectory)
System.Environment.SetEnvironmentVariable("DOTNET_ROOT", System.AppContext.BaseDirectory)

Solution 3​

Install:

  • .NET Desktop Runtime , for Windows OS
  • .NET Runtime, for other operating systems, such as MacOS
  • .NET Framework Runtime

.NET 8 projects fail to run​

Description​

Executing a Windows or a cross-platform process built using Studio 2024.2, on a 2023.12 Robot version or lower, fails with the following error: "RemoteException: NU1202: Package <package_name> <version> is not compatible with net6.0-windows7.0 (.NETCoreApp,Version=v6.0). Package <package_name> <version> supports: net8.0-windows7.0 (.NETCoreApp,Version=v8.0)."

Potential issue​

NuGet tries to resolve a package for.NET 6, whereas your automation was built using.NET 8. Such forward compatibility is not supported.

Solution​

Upgrade your Robots to version 2024.2.

Was this page helpful?

Connect

Need help? Support

Want to learn? UiPath Academy

Have questions? UiPath Forum

Stay updated