For converting an XNA Game to the ANX Framework you can use the ProjectConverter Tool.
You can choose if the Project should be converted directly, so the result is saved in the source directory, or if it should be saved in a different path.

The tool can be used as a GUI- and a CMD-Variant.
This tool is still in development. If you encounter any errors, please open an Issue for it.

What the tool is doing

Since the ANX Framework is code compatible with XNA it's very easy to convert projects between these two.
The tool simply removes the XNA assembly references in the csproj file and replaces them with the corresponding ANX assemblies.
Then the tool iterates through all the code files associated with the csproj file and replaces all XNA usings with the ANX ones.
It can also convert XNA Content Projects to ANX Content Projects.

Using the Graphical User Interface

If you do not pass any arguments to the application, it will automatically start in GUI mode.
The UI looks like this and should be self explanatory.


Using the Command Line Interface

When starting the tool via cmd you can choose between different operation modes by passing parameters:

1. Converting into the same file:

"ProjectConverter.exe /anx C:\code\testproject.csproj"
This command will take the project named "testproject" located at C:\code\ and convert it from XNA to ANX by overwriting the original projectfile.

2. Converting into different file:

"ProjectConverter.exe /anx /O=C:\converted C:\code\testproject.csproj"
By using this command, you can convert from XNA to ANX, but save the resulting project file into another location. The "/O=<path>"-Switch sets the new location.

3. Converting ANX to XNA:

"ProjectConverter.exe xna C:\code\testproject.csproj"
This command allows you to backconvert a project from ANX to XNA, as long as you did not use anything from the ANX Extended namespace.

4. Converting XNA Content Projects

"ProjectConverter.exe /content2anx /O=U:\tmp\projectconvertertest D:\SampleContent\SampleContent.contentproj"
Using this command you can convert your existing XNA Content Project to the ANX equivalent.
The "/O="-Switch sets the new location the content project file will be generated like in 2.

5. Converting ANX Content Projects

"ProjectConverter.exe /content2xna /O=U:\tmp\ D:\SampleContent\SampleContent.cproj"
will allow you to convert an ANX Content Project back to a XNA .contentproj file.

Last edited Nov 17, 2012 at 7:57 PM by eagleeyestudios, version 9


theParser Sep 22, 2013 at 3:34 PM 
C:\Program Files (x86)\ANX.Framework\Tools\ProjectConverter.exe

Jyskall Nov 24, 2012 at 6:13 PM 
You can find it in the "ANX.Framework\build" Folder, in the actual sourcecode. Just open it in VS and start a build.

Reelix Oct 7, 2012 at 1:35 PM 
Still doesn't exist in the project file 9 months later - I'd also like to know where this tool is...

vibbix Oct 1, 2012 at 8:46 PM 
Does this work with projects?

Rafael_Vasco Feb 19, 2012 at 3:40 AM 
I doesn't work right now. The assemblies are not correctly switched.

GambitRicky Jan 13, 2012 at 10:10 AM 
Sounds fine but where is the tool? Google has no clue about it and it is certainly not included in the msi installset