Tool for Converting VC++2005 Project to Linux Makefile

• Download source files - 15 KB
• Download binaries - 10.39 KB

Introduction

This tool automatically converts Visual C++ 8.0 or 9.0 projects to Linux makefile. Important note, there is no loss during the conversion: source code and .sln/.vcproj files are left unchanged. The tool has been implemented in C# VS 2005.

Why?

• Your application is cross-platform based.
• Now you are facing a decision to migrate from Visual C++ 6 to 8 or 9.

Both these reasons force you to create a makefile manually and each small change in your project requires hard physical labor in makefile maintenance.

This tool will do it for you automatically and will provide you with the ability to keep .sln/.vcproj and .mak files synchronized.

Using the Tool

The tool is a command line (console application).
Argument format is like the following:

1. In case an active project name is similar to solution name:

   sln2mak [Solution_FullPath_File_Name].sln

   Example:

   sln2mak c:/myprojects/test/unit_test.sln

2. In case an active project name differs from solution name:

   sln2mak -l [Main_Project_Name] [Solution_FullPath_File_Name].sln

   Example:

   sln2mak -l unit_test c:/myprojects/test/test.sln

3. In case you would like to convert a list of .vcproj files, type in this list, when the first one is the main lead project, and then use -d flag for additional dependencies, like libs, for a main project if it exists.

   sln2mak [Main_Project_FullPath_Name].vcproj [Project_FullPath_Name_2].vcproj ... 
            [Project_FullPath_Name_n].vcproj -d [lib_Name_1] ... [lib_Name_n]

   Example:

   sln2mak c:/myprojects/tets/unit_test.vcproj c:/myprojects/tets/test_lib.vcproj 
       -d mystaticlib1 mystaticlib2 mystaticlib3 

   For usage, call sln2mak with no arguments.

   After application runs, you'll find .mak file in path where .vcproj is located with the same name as the project.

   .mak files have all additional libraries path, sources, flags for compiler, linker, preprocessor and target path. 

In .sln path, you'll find Makefile that will handle all target rules (clean, make) and dependencies.

Points of Interest

Parser Class

This class has a static constructor that aims to be known for all classes without instantiation.

It holds regular expression that serves all other classes for parsing .sln and .vcproj files.

Regex m_ProjectGuid      = new Regex(@"ProjectGUID=""\{(.*)\}"""        ) ;
Regex m_SlnExtention     = new Regex(@"(.*)(.[Ss][Ll][Nn])$"            ) ;
Regex m_VcprojExtention  = new Regex(@"(.*)(.[Vv][Cc][Pp][Rr][Oo][Jj])$") ;
Regex m_ProjectRegex     = new Regex(@"Project\(""\{(.*)\}""\) = ""(.*)"", ""(.*)"",
   ""\{(.*)\}""") ;

VcSlnInfo Class

This class parses solution file and creates Makefile with target rules.

This class uses stream reader for reading .sln file line by line. During reading .sln file, it recognizes an active project (its name is similar to the solution name) and creates four dictionaries that hold information about all main and dependent projects:

• Key = Guid number , Value = ProjectName
• Key = ProjectName , Value = ProjectFullPath
• Key = ProjectName , Value = MakeFileName
• Key = ProjectName , Value = ProjectDependencies

Dictionary<string, string>  m_ProjGuidName = new Dictionary<string, string>() ;

Then method ParseVcproj is called - public VcProjInfo class's function, but first for each .vcproj  instance of VcProjInfo object created with projectName, projectFullPath and projectMakFileName.

VcProjInfo Class

In this class, VCProjectEngine object is used for retrieving all the necessary information about .vcproj, like target type and name, compiler flags, additional libraries, linker flags, sources and filters, preprocessor definitions, configurations, etc.

using Microsoft.VisualStudio.VCProjectEngine;
VCProjectEngine vcprojEngine = new VCProjectEngineObject();
//Init VCProject vcProj object
VCProject m_VcProj = (VCProject)vcprojEngine.LoadProject(vcProjFile);

//Init vcproj configurations list 
IVCCollection m_ConfigCollection = (IVCCollection)m_VcProj.Configurations;

All these helped me to create .mak file with CFLAGS, LDFLAGS, OBJS, etc.

Important Notes

• There is no loss during the conversion: source code stays unchanged.  
• Probably I did not cover all flags during parsing from .vcproj to .mak, but now you have all necessary information to be able to add anything I've missed.
• During my work I inspect that there are few differences between VC++ 8 solution/vcproj and VC++ 9, so you can use this tool for both.
• If you convert this source code to Visual Studio 2008, please use proper Microsoft.VisualStudio.VCProjectEngine reference version 9.0.0.0 instead of 8.0.0.0.

History  

Prior to writing the application, I tried to find a similar tool on the internet, but was only successful in finding other people's questions on online forums regarding the issue.
Then I attempted to understand XML-schema of a VC++8 solution and project, but the schema wasn't clear enough.

Suddenly I found a Microsoft.VisualStudio.VCProjectEngine reference with VCProjectEngine object within .NET components which helped me to understand the structure of a VC++ 2005 project. I used this object in my application for .vcproj parsing instead of using System.Xml for XML tree reading, and this without proper XML schema documentation.

Disclaimer 

The information provided on this page comes without any warranty whatsoever.  

This tool has been extensively tested before being published, but always there is the possibility to find some weakness. I strongly recommend that you back up your project before using this tool. Moreover, though I am willing to know if there is anything I can do in order to improve it, let me clearly say that it's not my fault if your project is corrupted by this tool.

Update History  

• 20/4/2009 Bug fixes (sorry for long delay)
• Added some spaces in dependencies
• Removed a loop which was creating multiple rules for a single project
• Added uppercase WIN32 to be replaced by uppercase LINUX
• Removed -o option for CPP files
• Removed printing of "else"
• Full path for dependent project fixed.

Especially thanks to Ahmad and Adrej, who helped me to find and fix all listed bugs.

• 6/9/2008 Bug fixes
• Uses sln2mak.exe from the same path as .sln/.vcproj.
• 16/9/2008 Bug fixes 
• Handles null reference for VC compiler tool, recursive file filters expanding during sources list creation

This article, along with any associated source code and files, is licensed under The Code Project Open License (CPOL)