generalinformation-2530-updates-project-converter-gui.md
Use one of the following ways to run the Project Converter as a dialog window.
In the Start menu of your Windows OS, select All Programs > DevExpress 25.2 > Project Converter 25.2.
In Visual Studio main menu, select Extensions > DevExpress > Project Converter > Project Converter 25.2.
Run the Project Converter from the command line.
Follow the steps below to upgrade your project.
Run the Project Converter.
In the Path tab, click the Browse… button and set the path to the project you want to upgrade.
Modify advanced settings (optional).
Click the Upgrade All button.
In the conversion log window that appears, click the Finish button to close the Project Converter.
Check the Advanced Settings checkbox in the Project Converter window to show advanced conversion settings.
Custom Public Key TokenAllows you to specify your public key token if you purchased the DevExpress assemblies’ source code and compiled your version with a custom public key token.Hint Path Behavior
Specifies how to treat HintPath attributes that contain paths to DevExpress assemblies.
Remove — removes HintPath attributes from the project file. Choose this option if project assemblies are loaded from the installation directory.
Update — updates substrings in paths that contain an old version number with a new version number. Choose this option if project assemblies are loaded from a custom directory.
Ask to Upgrade a Project in Visual Studio
If enabled, the following dialog appears in Visual Studio when you open a project that contains references to outdated DevExpress assemblies.
Process SubdirectoriesIf enabled, files in nested folders are upgraded. Otherwise, the converter upgrades only files in the specified directory.Process Read-Only FilesIf enabled, read-only files are upgraded without prompting. Otherwise, the converter displays a confirmation dialog for each read-only file it finds.Create Backup FilesIf enabled, the converter creates copies of the upgraded files before modifying them (the .bak extension is added to these copies).Convert DevExpress assembly references to NuGet packages
Converts DevExpress assembly references (DLLs) to corresponding NuGet package references. Enable this option if you plan to migrate a .NET Framework project to .NET 8+.
Note
After conversion, DevExpress design-time features and tools will no longer be available in .NET Framework project without the Unified Component Installer. Once the DevExpress Project Converter replaces DevExpress assembly references with NuGet packages, run Microsoft .NET Upgrade Assistant or update your project manually to complete the migration.
Read the following help topic for additional information: Migrate DevExpress-Powered .NET Framework Apps to the Latest .NET Version.
The Project Converter allows you to upgrade projects that are located in the same path or in multiple paths.
Use the Path tab to set the path to the folder that contains projects to upgrade.
The My Collection tab allows you to specify multiple paths. Click the Add Folder… button to add a new path; or click the Import List… button to load a path list from an existing text file, which should be a plain text file with one folder path per line.
You can upgrade some or all the projects that the specified folders contain:
Click the Upgrade All button to upgrade all the found items.
Click the Search and Select Projects button to display a list of the found projects. You can choose which projects to upgrade.
Use the following syntax to run the Project Converter from the installation directory:
cd C:\Program Files\DevExpress 25.2\Components\Tools\Components
ProjectConverter.exe [options]
The available options are listed below.
<drive:yourProjectPath>Specifies the path to the project(s) that should be upgraded/sAutomatically starts conversion. The converter does not close when the conversion is complete./scAutomatically starts conversion. The converter closes when the conversion is complete./k:<yourPublicKeyToken>Allows you to specify your public key token if you purchased the DevExpress assemblies’ source code and compiled your version with a custom public key token./h:removeRemoves hint paths. Choose this option if project assemblies are loaded from the installation directory./h:updateUpdates hint paths. Choose this option if project assemblies are loaded from a custom directory./oSkips subdirectories and upgrades only files in the specified directory./roSkips read-only files./bDoes not create backup files.
See Also
Type 'X' exists in both assemblies / Type 'X' is ambiguous in namespace 'Y'