Getting Started
Installation
System Requirements
Supported Operating Systems
Windows 10.
Windows 11.
System Installation Requirements
To utilize the WebMAP: WinForms to Blazor Conversion Tool, ensure your machine meets these requirements:
Internet access
Desktop Build Tools workload for Microsoft Build Tools (included with Build Tools installation).
Microsoft Build Tools 2022 17.12 to 17.14 (the installer will look for it and install it if necessary).
Conversion Requirements
You must have a valid license.
Microsoft Build Tools 2022 or Microsoft Visual Studio 2022 v17.12 to v17.14.
Visual Studio installation must include the following workload:
Go to Workloads tab and make sure that .NET desktop build tools option is checked.
Make sure to include the following components in the workload. If they're not already selected, navigate to the Individual Components tab and choose them for installation.
Ensure source code compiles successfully in Visual Studio with the required target framework installed on your machine.
Step 1: Execute the Application installer
If you've ever installed a windows application on your computer, this should be pretty straightforward.
Click on the downloaded .exe file.
On the next screen, click on the install button.
The installer will set up all the required files in your machine (Note that you will not be asked to input license information until you launch the application for the first time.)
The installer will check for missing dependencies in your computer and ask to install them if they're missing (internet access is required). If you choose not to install those dependencies, then the installation process will be canceled since those dependencies are necessary for the conversion tool to work as expected.
Step 2: Launch the Application
GAP WebMAP: WinForms to Blazor is an executable program file so you can run it like any other Windows application. When you first start WebMAP: WinForms to Blazor, you will see the following screen:
When you launch WebMAP: WinForms to Blazor for the first time, it will prompt you for the license key. Contact [email protected] if you are looking to get a license or renew an existing one. If you have an issue with a current license, please contact [email protected] for further information related to these problems.
General Menu
File Menu
The File menu can be found in the top left corner of the application screen. When you choose this menu, you will get the following options:
Settings: This option will take you to the settings page of the application where you can configure some specific settings for the conversion of your application.
Close: This option allows you to close the whole application.
Help Menu
The Help menu can be found in the top left corner of the application screen, next to the File menu. Once you click on it, you will get the following options:
User Guide: by clicking this option your default browser will open and take you to the documentation site for WebMAP: WinForms to Blazor.
License Information: It will give you details about: what execution mode this license is available, for who the license is registered to and when the license will expire. Also from this screen, you can update the current license.
Check for Updates: WebMAP: WinForms to Blazor should check for updates every time it starts up. However, if you're not sure whether or not you have the latest version, you can select this option so the application checks for updates. If an update is available, you will be given the option to download it. If there are no updates available, you will get a brief message indicating that "you're up to date!".
Terms and Conditions: This will take you to the terms and conditions page of GAP Mobilize.Net. Brace yourself for some legalese, but if you're looking for the terms and conditions of use for this product, look no further.
About WebMAP: WinForms to Blazor: this will give you some basic information about the version of WebMAP: WinForms to Blazor that you are currently running, including what version of the application and the conversion core the application is using.
Conversion Settings
To go to the conversion settings screen, click on the "Let's begin" button from the initial screen. Once in the conversion parameters screen, you have two ways of getting into the settings screen.
The first one is to click on the File option from the menu above and then select Settings option. The second one is to click on the blue gear icon next to the "Start conversion" button.
Once in the settings screen, the following will be displayed:
For now, we have two general settings on this screen:
Start-up project: Indicates the startup project where the conversion should begin.
Custom conversion file: This option allows you to select a configuration file provided by GAP to customize the conversion to your needs. You can request and work with our sales team to customize this configuration file once you have acquired a full license with us. Please reach out to [email protected] for further information.
In this same window, we also have the tab conversion results which has the following settings available:
Target framework: you can select the desired framework of your output application between .NET 9, and .NET 10.
Reset settings button: You can reset to the original default settings if you would like to revert your changes.
Conversion Process
To effectively utilize WebMAP: WinForms to Blazor, follow these crucial steps. This guide will lead you through the necessary inputs for the application and outline the internal processes it undertakes.
Step 1: Insert the Input Solution and Output Folder
Once you have launched WebMAP: WinForms to Blazor and click the "Let's begin" button, you will see the following screen where you can specify both the input solution (.sln) and the output folder.
Input Solution: Your input solution is the solution file (.sln) of your application. You can either click on the browse button or type the path manually.
You don't have to make sure your application is compiled before trying to use it as an input solution. But it is advised to make sure the application can be compiled on your machine before the conversion process.
Output Folder: The output folder is the folder where you would like to save the logs, and output code from the conversion process.
Once you select your input and output parameters, the application will conduct the following validations:
If there are already files in the output directory, you will get a message once you hit "Start Conversion" that will ask you if you'd still like to proceed with the conversion.
If one or both of the file paths are invalid, you will get a message indicating so.
Once the "Start conversion" button is activated, click on it to start the conversion process.
Step 2: Start the Conversion Process
Once you begin the conversion process, there are three different conversion states that will be updated accordingly.
Note that you will also get a readout of how many files are being converted, and the total size of the source files.
WebMAP: WinForms to Blazor conversion tasks are divided up as follows:
Parsing: The solution you selected as input is loaded into the conversion tool which analyzes it and prepares to parse through the source code. If there are any errors in loading the files, an error message will be thrown.
Processing: The conversion process begins and produces some metadata about the loaded files including the size and quantity of the files reported on the screen. While the conversion process is taking place, WebMAP: WinForms to Blazor is building a complete AST and a complete symbol table to properly create functional equivalence on the output code.
Write Results: This final state lets you know that the conversion process is complete, and the application is creating the output code and conversion logs to populate the output folder.
Take into account that since both the analyzing and converting processes depend on your input application's size, these steps may take from a few minutes to several ones.
Step 3: Check the Conversion Results
Once the conversion has finished, the "Next" button will be available at the bottom right of the screen. Once you clicked on it, you will be taken to a screen with a short summary of statistics about the conversion that just took place.
Included on this screen are the following:
Conversion Inventory
Total Number of Files: The number of files that were processed during the conversion.
Input Total Size: The total size of your input solution.
Number of Errors: Number of warnings, elements not converted, and errors that were generated by the application while processing and converting your input solution.
Conversion Overview
documentation: link directed to the post-conversion documentation.
Successfully Converted: this corresponds to the percentage of language elements successfully converter to WebMAP Blazor.
Not Converted: the percentage of language elements not converted to WebMAP Blazor.
Conversion Performance
Elapsed Time: The actual time it took to convert your solution.
Speed: The speed in language elements per second that took WebMAP: WinForms to Blazor to convert the source code.
Last updated