Generating Interface Description Files for External References using gmStudio
August 31, 2019
Interface Description Files (IDFs)
Step 1. Start the gmStudio Wizard
Step 2. Specify Source Input Parameters
Step 4. View Upgrade Process
Step 5. Continue
Step 6. Review Metrics Summary
Step 7. Review Results
Step 8. Review Generated Interface Description Files (IDFs)
Step 9. Archive IDFs for Distribution
Suppose you are interested in upgrading-to-.NET a number of VB6 projects, as listed in the example below:
The purpose of this exercise is to produce correct Interface Description Files (IDFs) for all the externals (libraries and components of .dll, *.ocx, *.tlb, or *.olb extension, for example) referenced by a group of well-formed VB6 projects (.vbp), as listed above for example.
It is assumed that all externals referenced by these projects are properly registered (and licensed, for third-party proprietary components) on the machine where these projects build correctly.
The outputs of this exercise are the IDFs (*.xml files) listed in Step 8.
In gmStudio, select [File][Upgrade Project Wizard …] and press [Next] when ready
In the Form below
Press [Next] when ready to move on with the selected list of projects (seven (7) in this case)
Step 3. Specify Target Output Parameters
In the Form below
Press [Next] when ready to move on with the actual translation
The Form below shows the various translation steps as they are being completed.
Press [Next] to move on to reviewing the results of the translation process.
In the Form below, press the [No, thank you … Next] button, to move on.
In the Form below, press the [Finish] button, to move on.
From the Title Menu, select [View][Interface Description Files] to move to the next step.
The snapshot below shows a listing of the IDFs (*.xml text files) contained in the …\idf\FromIdl folder, as generated by gmStudio for all the externals referenced in this Upgrade Project.
In File Explorer, select the idf\FromIdl folder and right-click [Send to][Compressed (zipped) folder] in order to compress all of the IDFs into a zip file, FromIdl.zip, as shown below.
At this point, these IDFs will be ready to "ship" for use in gmStudio – on a machine that may not have the corresponding externals properly registered (or licensed in the case of licensed third-party components).