{"type":"doc","content":[{"type":"paragraph","content":[{"text":"You can migrate .NET applications running on AutoCAD® platform to ARES Commander with minimal changes using following 2 steps.","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Replace AutoCAD® .NET assemblies with ARES .NET assemblies into your project references.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Replace Autodesk.AutoCAD namespace with Teigha namespace in the source code.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Equivalent Assemblies and Namespaces","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Assemblies","type":"text"}]}]}]},{"type":"table","attrs":{"layout":"default"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[340.0]},"content":[{"type":"paragraph","content":[{"text":" AutoCAD®","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[340.0]},"content":[{"type":"paragraph","content":[{"text":" ARES Commander","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[340.0]},"content":[{"type":"paragraph","content":[{"text":"acmgd.dll + accoremgd.dll + accui.dll","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[340.0]},"content":[{"type":"paragraph","content":[{"text":"FxCoreMgd_*.dll","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[340.0]},"content":[{"type":"paragraph","content":[{"text":"acdbmgd.dll","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[340.0]},"content":[{"type":"paragraph","content":[{"text":"TD_Mgd_*.dll","type":"text"}]}]}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Namespaces - Most commonly used namespaces mapped as below","type":"text"}]}]}]},{"type":"table","attrs":{"layout":"default"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[340.0]},"content":[{"type":"paragraph","content":[{"text":"AutoCAD® Namespace","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[340.0]},"content":[{"type":"paragraph","content":[{"text":"ARES Commander Namespace","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[340.0]},"content":[{"type":"paragraph","content":[{"text":"Autodesk.AutoCAD.ApplicationServices","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[340.0]},"content":[{"type":"paragraph","content":[{"text":"Teigha.ApplicationServices","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[340.0]},"content":[{"type":"paragraph","content":[{"text":"Autodesk.AutoCAD.ApplicationServices.Core","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[340.0]},"content":[{"type":"paragraph","content":[{"text":"Teigha.ApplicationServices.Core","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[340.0]},"content":[{"type":"paragraph","content":[{"text":"Autodesk.AutoCAD.EditorInput","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[340.0]},"content":[{"type":"paragraph","content":[{"text":"Teigha.EditorInput","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[340.0]},"content":[{"type":"paragraph","content":[{"text":"Autodesk.AutoCAD.Runtime","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[340.0]},"content":[{"type":"paragraph","content":[{"text":"Teigha.Runtime","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[340.0]},"content":[{"type":"paragraph","content":[{"text":"Autodesk.AutoCAD.DatabaseServices","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[340.0]},"content":[{"type":"paragraph","content":[{"text":"Teigha.DatabaseServices","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[340.0]},"content":[{"type":"paragraph","content":[{"text":"Autodesk.AutoCAD.Geometry","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[340.0]},"content":[{"type":"paragraph","content":[{"text":"Teigha.Geometry","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[340.0]},"content":[{"type":"paragraph","content":[{"text":"Autodesk.AutoCAD.PlottingServices","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[340.0]},"content":[{"type":"paragraph","content":[{"text":"Teigha.PlottingServices","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[340.0]},"content":[{"type":"paragraph","content":[{"text":"Autodesk.AutoCAD.Colors","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[340.0]},"content":[{"type":"paragraph","content":[{"text":"Teigha.Colors","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[340.0]},"content":[{"type":"paragraph","content":[{"text":"Autodesk.AutoCAD.Customization","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[340.0]},"content":[{"type":"paragraph","content":[{"text":"Teigha.Customization","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[340.0]},"content":[{"type":"paragraph","content":[{"text":"Autodesk.AutoCAD.Windows","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[340.0]},"content":[{"type":"paragraph","content":[{"text":"Teigha.Windows","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[340.0]},"content":[{"type":"paragraph","content":[{"text":"Autodesk.AutoCAD.GraphicsSystem","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[340.0]},"content":[{"type":"paragraph","content":[{"text":"Teigha.GraphicsSystem","type":"text"}]}]}]}]},{"type":"paragraph","content":[{"text":"Only Global namespace are different in AutoCAD®[Autodesk.AutoCAD] and in ARES[Teigha] rest internal namespaces names are same and classes and methods are fully compatible.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":" Advance Migration","type":"text"}]},{"type":"paragraph","content":[{"text":"If you do not want to maintain separate source code for AutoCAD® and ARES Commander, then additional steps are necessary. A single project with two build configuration solves the issue.","type":"text"}]},{"type":"paragraph","content":[{"text":"Step 1:","type":"text","marks":[{"type":"strong"}]},{"text":" Create 2 new build configurations for one for AutoCAD® and another for ARES Commander.","type":"text"}]},{"type":"paragraph","content":[{"text":" ","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center","width":100.0},"content":[{"type":"media","attrs":{"width":624,"id":"568f7d0a-0136-4f4d-a932-7148dadb2542","collection":"contentId-1690763281","type":"file","height":351}}]},{"type":"paragraph","content":[{"text":"Step 2:","type":"text","marks":[{"type":"strong"}]},{"text":" Using project Properties, select all configurations one by one and define Symbol “AutoCAD” or “ARES” for the corresponding configurations.","type":"text"}]},{"type":"paragraph","content":[{"text":"For AutoCAD_Release configuration:","type":"text"}]},{"type":"paragraph","content":[{"text":" ","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"width":624,"id":"1bd8390b-3516-45df-933c-386fbbd7b600","collection":"contentId-1690763281","type":"file","height":236}}]},{"type":"paragraph","content":[{"text":"For ARES_Release:","type":"text"}]},{"type":"paragraph","content":[{"text":" ","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"width":593,"id":"6fa41419-2548-4b4c-aed8-c994a7520086","collection":"contentId-1690763281","type":"file","height":250}}]},{"type":"paragraph","content":[{"text":" ","type":"text"},{"text":"Step 3:","type":"text","marks":[{"type":"strong"}]},{"text":" Add Conditional reference assemblies to the project using Symbols. Modify csproj file manually in the text editor to add condition for all references as in the following example.","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"table","attrs":{"layout":"wide"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"initial","rowspan":1,"colwidth":[680.0]},"content":[{"type":"codeBlock","attrs":{"language":"csharp"},"content":[{"text":"\n \n \n \n C:\\Program Files\\Autodesk\\AutoCAD 2020\\accoremgd.dll\n \n \n \n \n \n C:\\Program Files\\Autodesk\\AutoCAD 2020\\acdbmgd.dll\n \n \n \n \n \n C:\\Program Files\\Autodesk\\AutoCAD 2020\\acmgd.dll\n \n \n \n \n \n C:\\Program Files\\Graebert GmbH\\ARES Commander 2020\\BIN\\FxCoreMgd_4.03_15.dll\n \n \n \n \n \n C:\\Program Files\\Graebert GmbH\\ARES Commander 2020\\BIN\\TD_Mgd_4.03_15.dll\n \n \n \n ","type":"text"}]}]}]}]},{"type":"paragraph","content":[{"text":"Step 4:","type":"text","marks":[{"type":"strong"}]},{"text":" Change in the source code add using directives for both SDK conditionally and also alias the Global namespace of both CAD Libraries to CADLib as below and Replace ","type":"text"},{"text":"Autodesk.AutoCAD","type":"text","marks":[{"type":"strong"}]},{"text":" to this new alias ","type":"text"},{"text":"CADLib ","type":"text","marks":[{"type":"strong"}]},{"text":"in *.cs source files. One has to do this for each cs file in the project which is using APIs belongs to ","type":"text"},{"text":"Autodesk.AutoCAD","type":"text","marks":[{"type":"strong"}]},{"text":" because using directive is limited to a single cs file. ","type":"text"}]},{"type":"paragraph","content":[{"text":" ","type":"text"}]},{"type":"table","attrs":{"layout":"wide"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"initial","rowspan":1,"colwidth":[680.0]},"content":[{"type":"codeBlock","attrs":{"language":"csharp"},"content":[{"text":"#if ARES\n \nusing Teigha.DatabaseServices;\n \nusing Teigha.Runtime;\n \nusing Teigha.Geometry;\n \nusing Teigha.ApplicationServices;\n \nusing Teigha.EditorInput;\n \nusing CADLib = Teigha;\n \n#elif AutoCAD\n \nusing Autodesk.AutoCAD.DatabaseServices;\n \nusing Autodesk.AutoCAD.Runtime;\n \nusing Autodesk.AutoCAD.Geometry;\n \nusing Autodesk.AutoCAD.ApplicationServices;\n \nusing Autodesk.AutoCAD.EditorInput;\n \nusing CADLib = Autodesk.AutoCAD;\n \n#endif\n \n//If we already aliased Autodesk.AutoCAD or Teigha to CADLib by using statement as above then to migrate below statement\n//where we have used fully qualified calss name as Color below\nAutodesk.AutoCAD.Colors.Color acadColor = Autodesk.AutoCAD.Colors.Color.FromRgb(color.R, color.G, color.B);\n\n//migrated code will be and will work for both .NET SDK\n \nCADLib.Colors.Color acadColor = CADLib.Colors.Color.FromRgb(color.R, color.G, color.B);\n\n//Such situation only happens when Color conflicts with Other namespace's Color class \n//then we have to write fully qualified class name. ","type":"text"}]}]}]}]},{"type":"paragraph","content":[{"text":"Step 5:","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"Specify separate Output folders for both configurations.","type":"text"}]},{"type":"paragraph","content":[{"text":"Build both configurations one by one. The builds will work with their corresponding applications.","type":"text"}]},{"type":"paragraph","content":[{"text":" ","type":"text"}]}],"version":1}