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.
Currently only the CMD variant is available.
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.
![x2a_01.png]( "x2a_01.png")
This command will take the project named "testproject" located at C:\code\ and convert it from XNA to ANX by overwriting the original projectfile.
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.
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.
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.
will allow you to convert an ANX Content Project back to a XNA .contentproj file.
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.
Currently only the CMD variant is available.
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 Command Line Tool
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.