How to Build the Toolkit DLL
General Requirements
The following general requirements are applicable when building the Windchill Workgroup Manager Toolkit:
• A toolkit DLL must be built to successfully integrate with Windchill Workgroup Manager as a Windchill Workgroup Manager Toolkit application, the DLL entry point method must contain the following signature:
extern "C" wwgmtkClientCustomizer_ptr wwgmtkGetCustomizer()
The DLL method then returns a non-null object that implements the interface wwgmtkClientCustomizer.
• To build and use Windchill Workgroup Manager Toolkit structures and definitions, the DLL must use the “include” files provided with the toolkit and link with the libraries from the appropriate platform location in the installation. These files are included in the examples\wwgmtk_api_demos directory.
• Makefiles specify the compiler and link flags to be used for your operating system. The sample makefiles for the Windows operating systems are included in the examples\wwgmtk_api_demos directory.
Use the sample makefiles:
◦ As templates for structuring your own application makefiles
◦ When creating a new application
◦ When moving to a new release of your CAD tool, update the flags in your application makefiles
◦ When moving to a new release of the Windchill Workgroup Manager client, update the flags in your application makefiles.
• PTC requires that you use Microsoft Visual Studio 2019 Update 4, because the supplied Windchill Workgroup Manager Toolkit package sample Microsoft Studio project files and some standard libraries were prepared using Microsoft Visual Studio 2019 Update 4.
Windows Build Instructions
Ensure the
WWGMTK_Install_DIR user environment variable is set up. For more information, see
Create the WWGMTK_Install_DIR Environment Variable—Windows.
For ease of working on Windows, the toolkit contains the Microsoft Visual Studio project file, wwgmtk_vs_project.vcxproj, which contains the compile and link instructions needed for a Windchill Workgroup Manager Toolkit application.
The sample wwgmtk_vs_project.vcxproj project file:
• References the libraries in the toolkit by using relative paths to the environment variable WWGMTK_INSTALL_DIR
• Declares the entry point functionality for the DLL.
PTC recommends when creating a new customization project, you use the template file provided as a starting point for build settings.