C++ Reverse

How to Install

1. Download the Plugin file by clicking the blue Download button at the top of this page.
2. After the download is complete, drag the downloaded .jar file to an open instance of Astah. A pop-up will appear asking you to confirm installation. Choose [Yes].
3. If the pop-up below opens, restart Astah.
   
   The [Plugin] menu exists in Astah version 7.2 or later.
4. If [Import C++] is under [Tools] – [C++], your installation is complete.
   

How to Use

First, export your C++ source code to XML using Doxygen.

1. Download and install Doxygen.
2. Launch Doxygen from [doxygen] – [Doxywizard]. When the [Doxygen GUI Frontend] dialog opens, select [Wizard] – [Project] and specify the items below.
   

   Project name	Enter the project name
   Project version or id	Enter the project version or ID
   Source code directory	Specify the source code directory
   Scan recursively	Check this to scan subfolders as well.
   Destination directory	Do not use the following symbols: &, <, >, * or @.

3. Go to [Wizard] – [Mode] and check the two options shown below.
   
4. Go to [Wizard] – [Output] and check [XML].
   
5. Go to [Expert] – [Input] and specify the encoding used in the source code (e.g. UTF-8, CP1252). See the list of supported encodings.
   
6. Go to [Expert] – [Preprocessor] and check the three options [ENABLE_PREPROCESSING], [MACRO_EXPANSION] and [SEARCH_INCLUDES]. Other options can be set as you prefer.
   
7. Go to [File] – [Save] to save the configuration. Back in the [Doxygen GUI Frontend] dialog, select the [Run] tab, specify the working directory, and click [Run doxygen]. When Doxygen finishes without errors, the message “Doxygen has finished” appears.
   
8. In Astah, create a new file or open an existing one. Go to [Tools] – [C++] – [Import C++] and load the XML file.
   
9. To create a class diagram from the imported source code, right-click on a package and generate a class diagram automatically.

When import fails

• Make sure you set the correct encoding in Doxygen. Follow the steps below to regenerate the XML file.
  1. Check which encoding the C++ source code uses. All source code files must use the same encoding.
  2. Launch Doxygen and go back to Step 3 to configure the settings.
  3. In Step 5, set the same encoding as the C++ source code.
     (Reference: list of encodings Doxygen supports)
  4. Go back to Step 7, generate the XML, and try importing it into Astah again.
• This plugin was tested with Doxygen version 1.8.6. If you are using another version of Doxygen, use version 1.8.6.

If this does not solve the problem, please contact us.