4.1 Platform Requirements
ST-Developer supports Intel x86 machines with Windows XP/Vista and software development with Visual Studio 2005 (VC 8.0) as well as the older Microsoft Visual C++ v6.0 compiler. Consult the README.TXT file on the distribution media for exact disk space requirements and other details.
You must install ST-Developer using an account with administrator privileges. After the installation is complete, you can run the tools under any user account. Under Windows 2000, you must have "Power User" privileges.
4.2 Installation Procedure
Remove Earlier Versions
- If you are upgrading from a v10 or earlier installation with Visual Studio plug-ins, use the Start | Programs | ST-Developer | Visual C++ Integration tool to "unintegrate" the Visual Studio plug-ins. Do this for each ST-Developer user.
- Go to the Start | Settings | Control Panel menu item. Select Add/Remove Programs , then choose the ST-Developer entry from the list of packages.
Install the New Version
- Insert the ST-Developer CD-ROM into your drive. If the installer does not start automatically, double click on stdev.msi.
Some pre-XP machines may not recognize the .msi extension, or may complain that the package cannot be installed by the Windows Installer service. If either of these happen, just install the Windows MSI 2.0 upgrade below.
Windows 2000/NT: Double click on
InstMsiW.exe
.
Windows 98 or ME: Double click on
InstMsiA.exe
.
- The installer will guide you through the installation process. If you wish to omit parts of ST-Developer, or specify where it is installed, select a custom installation when prompted, otherwise select typical installation.
- Request a license key when prompted. Click Register and follow the instructions in the web form. If you wish to request a key later, select STEP Tools | Request License Key on the Start menu. We will send the key by e-mail and you can install it as described in Software License Keys.
ST-Developer is now installed. You can verify the environment settings on your machine and test the ST-Developer tools as described in the following sections.
Visual Studio and Environment Settings
The ST-Developer installer sets several environment variables used by the Visual Studio project files and makefiles for the sample programs to find programming libraries, header files, and tools.
To check these, start a command prompt and type set , or bring up the Environment tab of the System control panel. Verify that each has an accurate value:
%ROSE% ST-Developer installation directory, also set under Software\STEP Tools, Inc.\ST-Developer in the registry.
%ROSE_BIN% Directory containing ST-Developer executables. Usually %ROSE%\bin . This is added to your %PATH% variable.
%ROSE_INCLUDE% Directory containing the ST-Developer C++ header files. Usually %ROSE%\include . Used by project files.
%ROSE_LIB % Directory containing the ST-Developer C++ libraries. Usually a subdirectory under %ROSE%\lib . Used by project files.
%ROSE_CONFIG% Location of the makefile configuration file. This is a file in the %ROSE%\config directory that defines settings for the demo makefiles.
ST-Developer includes libraries built for newer and older versions of Visual C++ as well as multi-thread, static ( /MT flag) and multi-thread, dynamic ( /MD flag) link conventions. By default, the ROSE_LIB variable points to the libraries for Visual Studio 2005 with the /MD flag. To usea different version, change ROSE_LIB as below:
ST-Developer for 32bit Windows:
<stdev-install-dir>\lib\i86_win32_vc8_md Visual Studio 2005 with /MD
<stdev-install-dir>\lib\i86_win32_vc8_mt Visual Studio 2005 with /MT
<stdev-install-dir>\lib\i86_win32_vc6_md Visual C++ 6 with /MD
<stdev-install-dir>\lib\i86_win32_vc6_mt Visual C++ 6 with /MT
ST-Developer for 64bit Windows:
<stdev-install-dir>\lib\x64_win64_vc8_md Visual Studio 2005 with /MD
<stdev-install-dir>\lib\x64_win64_vc8_mt Visual Studio 2005 with /MT
You can also specify one of these explicitly as a /LIBPATH in your project settings if you need alternate versions.
If you write code that executes in multiple threads, be aware that the ST-Developer libraries are not reentrant. You must ensure that only one thread calls an ST-Developer library function at any point in time.
Verify the Installation
You can test the various components of ST-Developer using the following steps:
- Select STEP Tools | Documentation on the Start menu to open the ST-Developer online manuals. The manual home page is located at the following URL within the installation directory:
file:/<stdev_install_dir>/docs/index.html
- Open a command prompt and use the rose file utility to list the installed system resource files. This verifies that the path, registry, and environment settings are properly configured. If you have problems, make sure that the %ROSE_BIN% directory is in your search path.
C:\> rose ls
It should return something like the following:
Total number of designs:: 100
In C:\Program Files\STEP Tools\ST-Runtime 12\schemas\*.*
? ap239_product_life_cycle_support_mim_lf.rose
ap239_product_life_cycle_support_mim_lf_EXPX.rose
? associative_draughting.rose
associative_draughting_EXPX.rose
? automotive_design.rose
automotive_design_EXPX.rose
? building_design_schema.rose
building_design_schema_EXPX.rose
[ . . . files ommitted . . . ]
- Go to the Start menu and open the ST-Developer online manuals. You will see a list of links to pre-installed schemas (AP201, AP202, etc). Go to one of them and compile one of the sample programs.
For each sample program you will see a Windows project link. Right-click on the link to save the project zip file. Unpack the zip file and open the project file within with Visual Studio.
If you prefer to work from the command line, there is also a makefile within the zip that you can build with nmake . If you may need to first run the vcvars32.bat file supplied with Visual Studio to put the cl compiler into your command line search path.