Skip to main content
BuyLog In
General Information
Search in…
Docs > Install Updates > Project Converter: CLI
All docs
V24.2
General Information
Support Services
Installation: Unified Component Installer
Installation: NuGet Packages
Install Updates
Upgrade Notes
Project Converter
Project Converter: GUI
Project Converter: CLI
Request a Hotfix
Security Information
Localization
Frequent Support Inquiries
DevExpress EULAs
DevExpress Trademarks
Download CHM

DevExpress Project Converter: Console Application

  • 3 minutes to read

Use the following syntax to run the Project Converter as a console application from the installation directory:

cd C:\Program Files\DevExpress 24.2\Components\Tools\Components 
ProjectConverter-console.exe <drive:yourProjectPath> [options]

If the conversion is successful, ProjectConverter-console.exe returns 0 as an exit code. It returns 1 if there were warnings, and -1 in case of an error.

Command Line Options

/?
Displays a help page.
<drive:yourProjectPath>
Specifies the single path that contains the project(s) to upgrade.
/fl:<drive:yourFilePath>
Specifies the path to the file that contains a list of folders to upgrade. The file should be a plain text file with one folder path per line.

Target DevExpress-based Projects to .NET 8 and .NET Framework 4.6.2

Note

.NET 8, .NET Framework 4.6.2, Visual Studio 2019 are minimally supported versions for DevExpress libraries in v24.2. Refer to the following breaking change article for additional information: .NET 8 and .NET Framework 4.6.2 are minimally supported Target Frameworks for DevExpress libraries in v24.2.

When you update the DevExpress-powered project that targets .NET Framework 4.5.2 / .NET 6 (or earlier), the Project Converter displays a window that informs you that the Project Converter will re-target DevExpress-based projects to .NET 8 and .NET Framework 4.6.2 and update 3rd party NuGet packages to the latest compatible versions.

Use the following command line options to disable automatic updates if you want to update DevExpress-powered projects manually:

/noautoupdate
Disables automatic update of the TargetFrameworkVersion and 3rd-party NuGet packages for projects with DevExpress dependencies based on the latest version compatible with the target framework.
/noautoupdatepkg
Disables automatic update of 3rd-party NuGet packages for projects with DevExpress dependencies based on the latest version compatible with the target framework.

Read the following help topic for additional information: Target DevExpress-based Projects to .NET 8 and .NET Framework 4.6.2.

Additional Options

You can change the default Project Converter behavior and add the following options:

/topackages
Converts DevExpress assembly references (DLLs) to corresponding NuGet package references. Read the following help topic for additional information: Migrate DevExpress-Powered .NET Framework Apps to the Latest .NET Version.
/o
Skips subdirectories and upgrades only files in the specified directory.
/ro
Skips read-only files.
/h:remove

Removes hint paths (the default behavior for versions prior to v21.2.4).

Tip

Choose this option if project assemblies are loaded from the installation directory.

/h:update

Updates hint paths (the default behavior for versions v21.2.5+).

Tip

Choose this option if project assemblies are loaded from a custom directory.

/b
Does not create backup files.
/d:skipped
Disables skipped file notifications.
/d:warning
Disables warning notifications.
/d:error
Disables error notifications.
/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.
See Also