Making installers

By using WiX, make an installer for the plug-in.


  1. Copy the following files from the directory "[TOP FOLDER]\MolipSDK\StdSrc\eng" into the directory "[User's Documents folder]\src\PgTest".


  2. Change the file name.
    StdSrc.wxs -> PgTest.wxs


  3. Open "build.bat" with the text editor.
    Modify the WiX directory's path.
    And chante the file name "StdSrc" to "PgTest".


  4. Start [Microsoft Visual C++ 2008 Express Edition].
    Click the menu [File] >[Open] >[Project/Solution] to open the dialog [Open File].
    Select "PgTest.wxs" and click the button [OK].


  5. "PgTest.wxs" will be opened.


  6. Start 'DdGuidGen.exe' in the folder '[TOP FOLDER]\MolipSDK\Tools'.
    Click the button [New GUID] to generate new GUID.
    Click the button [Copy] to copy the GUID into the clipboard.


  7. Paste the GUID into 'PgTest.wxs' as the value of the 'Id' attribute of the 'Product' tag.


  8. Click the button [New GUID] again and generate new GUID.
    Click the button [Copy] to copy the GUID into the clipboard.


  9. Paste the GUID into 'PgTest.wxs' as the value of the 'Guid' attribute of the 'Component' tag.


  10. Modify the 'Name','Version' and 'Manufacturer' attributes of the 'Product' tag.
    These values are registered into Windows as the product information when the installer is executed.


  11. Modify the 'Description','Comments' and 'Manufacturer' attributes of the 'Package' tag.
    These values are registered into the installer as the installer's information.


  12. Modify the 'Name' and 'LongName' attributes of the two 'Directory' tags.
    These values specify the installation directory. In the following image's case, the program will installed into the following directory.
    "\Program Files\Taro Tokyo Corp\Dynamic Draw PlugIn MyTest"
    The value of the 'Name' attribute must be 8 characters or less. Set the full name to the 'LongName' and the short name to the 'Name'.


  13. Modify the 'Name' and 'Source' attributes of the 'File' tag.
    The value of the 'Name' attirbute specify the file name of the installed program after the installation finished.
    The value of the 'Source' attirbute specify the file name which is included into the installer.
    In the following image's case, 'Release\PgTest.dll' is included into the installer, and it will be installed as 'PgTest.dll' into the directory following directory when installing. "\Program Files\Taro Tokyo Corp\Dynamic Draw PlugIn MyTest\PgTest.dll"


  14. Modify the 'Key' attribute of the 'Registry' tag.
    Set the Dynamic Draw's version into the next to "Ver".

    Set the GUID value of 'PG_MODULE_CLSID' in 'MpaModule.cpp' into the next to "PlugIn\".


  15. Modify the 'Value' attribute of the three 'Registry' tags.
    First 'Value' attribute specify which application is suppoted by the plug-in.

    See the following table.

    Application Decimal Hexadecimal
    Dynamic Draw 256 0x100
    Chip Editor 512 0x200
    Arrow Editor 1024 0x400
    Thought Retriever/History Manager 2048 0x800
    Thought Tickler/History Recorder 4096 0x1000

    If the plug-in supports two or more applications, specify the OR value.
    This setting must be agreement with the setting of 'PG_MODULE_NAME' in 'MpaModule.cpp'.


  16. Second 'Value' attribute specify the file name of the plug-in. It must be same value with the 'Name' attribute of the 'File' tag.


  17. Third 'Value' attribute specify the module name of the plug-in.

    It must be same value with the 'PG_MODULE_NAME' in 'MpaModule.cpp'.


  18. Save 'PgTest.wxs'.
    Execute 'build.bat' to build the installer.


  19. The result of the building is stored into 'log.txt'.
    Open 'log.txt' with a text editor and confirm that the building process has been completed successfully.


  20. If the building process was successfully finished, the installer 'PgTest.msi' would be generated.


  21. Execute the installer file 'PgTest.msi' to install the plug-in.


  22. Open the 'Programs and Features' panel from 'Control Panel' to confirm that the installation has been completed successfully.


  23. Start Dynamic Draw.
    In the property page [Plug-in] of the dialog [Environment setup], confirm that the plug-in 'MyTest' has been added.