in
Forums
Blogs
Files
Devexpress.Com
ClientCenter
Support Center
DevExpress Channel

This Blog

Syndication

The ASPx Blog - Mehul Harry's DevExpress Blog

How to easily convert your project to a new DevExpress release

When new DevExpress components are released or updated you'll need to convert your Visual Studio project to use the new release. The simplest and easiest way to convert it is to use the DevExpress Project Converter tool.

The Project Converter exe is in "Program Files/Developer Express/", you can find a shortcut to it in the Start Menu under Developer Express.

image

You'll find that this little tool is very easy to use. You just set the Project Path and click Upgrade. If you want to convert several projects at once then choose a base directory like your projects or websites folder.

In my case, for Windows Vista, I select: "C:\Users\Mehul\Documents\Visual Studio 2005\WebSites\" since there are usually several different types of projects being worked on.

The Project Converter has a checkbox option that will create backup files for you, so you don't need to worry about it. In the lower part, you can also see every file that has been modified, skipped and backed up by the tool.

image

How to Add DevExpress Project Converter to Visual Studio

For faster access, you can easily integrate this tool into Visual Studio. So you can launch it from the Visual Studio 2005 menu or the toolbar. Let me show you how:

  1. Click on the Tools -> External Tools menu option inside Visual Studio.
  2. Click Add and then define the following properties:
    • Title: Name as you would like to see it in the menu, e.g., DevExpress Project Converter
    • Command: Location where the Project Converter is installed. Typically this will be in a directory such as: "C:\Program Files\Developer Express .NET v7.2\Tools\DXperience\ProjectConverter.exe". Please note, that with every major release from us, you'll want to update the command path to the latest location. 
    • Arguments: These are arguments that will be passed to the Project Converter tool. Visual Studio should generate the "$(SolutionDir)\" for you but if not, enter it. This argument is the location of the project currently open in Visual Studio.
  3. Finally, click OK. You should now see a new menu item under your Tools menu.

 

image

Published Sep 10 2007, 09:44 PM by Mehul Harry (Developer Express)
Filed under: ,
Technorati tags: ASPxperience, DXperience

Comments

 

Marc Greiner [DX-Squad] said:

Hi Mehul,

Good to know that the converter can be used in VS !

I have been using the project converter for a while now, and have a question regarding the "Create backup files" as I never used it checked.

Are there situations where the project converter could harm the project and I need my original files back ?

Thanks,

Marc

September 11, 2007 2:28 AM
 

Mehul Harry (Developer Express) said:

Hi Mark,

Thanks. The project converter mainly sets the proper version numbers in your code, project, and config files. So there shouldn't be such a situation but if there is, you can rely on the backup files.

September 11, 2007 2:57 AM
 

Dirk Illenberger said:

This is just to mention an important point for developers that use texts with special characters (e.g. german Umlauts).

If the code file is not saved with the correct encoding (e.g. Unicode) then the project converter is not able to determine the correct encoding and will mess up the texts. All non-english alphabet characters will look strange and it's a pain to correct them manually if you don't have a backup copy.

So my insight for non-English developers before running the project converter:

- Use backup copies or checked in versions of a version control system

- Make sure that you have saved your code files with the correct encoding.

To learn more about that issue and how to choose the encoding see www.devexpress.com/.../CB43935.aspx

Does anyone know how to make Visual Studio use "Unicode (UTF-8 with signature) - Codepage 65001" encoding as the default?

It would make life a lot easier since every now and then I forget about that issue and create a new standard source file which then hasn't the right encoding. And when converting my project I might mess up strings in that particular file.

— Dirk.

September 11, 2007 3:34 AM
 

Steven Rasmussen said:

This is probably a dumb question... but what exactly is the HintPath behavior for?

September 11, 2007 9:54 AM
 

Denis V. Volman said:

Is it possible to launch Project Converter tool from command line with parameters?

Another words convert my projects from a batch file...

September 11, 2007 1:52 PM
 

Mehul Harry (Developer Express) said:

Hi Steve,

The Hint Path option determines the processing method for the HintPath tag, which may appear next to an assembly reference in your project file (~.csproj / ~.vbproj). The recommended value for this option is "Remove". And it's not a dumb question. :-)

Hi Denis,

Unfortunately, from the command line, you can only launch and pass the project path as a parameter. I recommend creating a suggestion for support to make a full command line version.

Thanks.

September 11, 2007 6:57 PM
 

Mehul Harry (Developer Express) said:

Hi Dirk,

Thanks for bring up the point about encoding. I don't know if there is a standard way to set the encoding in VS but you might try this link. There are a couple of workarounds suggested here:

forums.asp.net/.../1808187.aspx

Good luck.

September 11, 2007 8:06 PM
 

Michael Cheng said:

Yep, I often use this tool, it's very useful!

September 12, 2007 4:58 AM
 

Mehul Harry (Developer Express) said:

Hi Michael,

You sound like you're up to date on the latest releases. I'm the same way. :)

Thanks.

September 12, 2007 7:34 AM
 

Rollie Claro said:

on one comment, i'd love to see DX's controls in action in regards to the project converter. :)

September 12, 2007 8:05 PM
 

Mehul Harry (Developer Express) said:

Hi Rollie,

If you have a suggestion and a mockup then please submit it through our support center for consideration.

Thanks.

September 14, 2007 1:23 AM
 

AshleyT said:

I have DevExpress 7.1.2 installed.  So all I need to do is run DXperience-7.2.4.exe.

Then for each project that I want to start using in 7.2.4, I need to run this converter tool.  Is there anything else?

September 27, 2007 11:52 AM
 

Mehul Harry (Developer Express) said:

Hi Ashley,

Yes, uninstall 7.1.2 and install latest version. Then you can use the Project Converter to upgrade your projects.

Thanks.

October 1, 2007 4:02 AM

Leave a Comment

(required)  
(optional)
(required)  
Verification code: Required
   
Add
Copyright © 1998-2008 Developer Express Inc.
ALL RIGHTS RESERVED