Heads Down Display Dynamic Linked Library Procedures

From Wikipedia, the free encyclopedia

Brief summary of what HDDL is and how it works.

[edit] Initial Setup

Request account and access to Visual SourceSafe (VSS) from SCM group.

1) Go to computer station labeled HDDDLL-PC in the SIL and log in using your Windows domain name and password.
2) Create a local folder for checking out development files (ex: C:\User\Dev). This will be your working folder.
3) Map a network drive (ex: S:\) to \\rex\dgcs, to have access to DGCS source code.
4) Check to see if Microsoft Visual SourceSafe (VSS), Visual Studio .NET, and Araxis Merge are installed.
5) Run VSS: Programs -> Microsoft Visual SourceSafe -> Microsoft Visual SourceSafe 6.0
6) Use your Windows username for both login and password.
7) When prompted to open the SourceSafe database, choose the Production entry. If it’s not available, click Browse, and enter \\rex\windev\VSS\Production\srcsafe.ini in the “File Name” field.
8) Click Open.
9) Once logged in, change your password by going to the Tools->Change Password menu. Use your login name for the old password.
10) Thereafter, go to VSS 'All Projects' window (on the left) and right-click on the $/ folder. Set Working Folder to local folder (ex: C:\User\Dev).

NOTE: To have quicker access to VSS, Visual Studio, and Araxis Merge, create shortcuts on your desktop.

[edit] HDDDLL Generation – SETUP

1) Find parent of HDDDLL YYY on the DGCS software version tree. 2) Open VSS (if not already opened) a. Open Production database - \\rex\windev\VSS\Production\srcsafe.ini b. Navigate to $/PC-Dev/GA-ASI/Components/HDDDll/XXX, where XXX is the parent of YYY (new version to generate) c. Get the latest version: right-click on /XXX - choose Get Latest Version, and check recursive & build tree on dialog. Click OK to create new folder, then Yes to All, when prompted. When lower left corner says Ready, it's done acquiring the latest version LOCALLY. 3) Go to C:\User\Dev\...\HDDDll\ and rename folder XXX to YYY (new HDDDLL version). - Remove read-only property to folder contents in \HDDDll\YYY\ by going into the DOS shell and issuing an 'attrib -r *.* /s’ command. (May need to cd /d c:\. Also can be done by right clicking the YYY folder and going into Properites and unclick the read-only button.) 4) Delete all files with .scc, .bld, .vspscc, .ncb, .opt. - Go to C:\User\Dev\..\HDDDll\YYY and right click on folder. Select search and type *.scc,

               then *.bld and *.vspscc, *.ncb, *.opt.  Remove all instances. (If mssccrpj.scc is read only

do not delete. Otherwise Visual Studio will complain of missing file.) 5) Delete Build.bat and GetDependencies.bat from C:\User\DEV\..\HDDDll\YYY\Build\ - These files will be obtained from a shared directory later. 6) Delete PostBuild.bat and PreBuild.bat from C:\User\DEV\..\HDDDll\YYY\Source\HDDDll\ - These files will be obtained from a shared directory later. 7) Go to C:\User\Dev\...\HDDDll\YYY\Common\Include a. open ASIComponentVersion.h with notepad b. Change version XXX to YYY (the build version should end in .1, ex: YYY.0.0.1) c. Save d. Delete asiCopyrightRC.h. It will be obtained from a shared directory later. 8) Verify that C:\User\Dev\...\HDDDll\YYY\Installer directory exists, if it does not exist, go to HDDDLL 754 branch and right click on the installer folder and select the “Get Latest” option. Change the “To” field to be C:\User\Dev\...\HDDDll\YYY\Installer and click OK. Verify that C:\User\Dev\...\HDDDll\YYY\Installer now exists. 9) Go back to VSS and create new project under $/PC-Dev/GA-ASI/Components/HDDDll/ by right clicking on the HDDDll folder, then clicking on Create Project. 10) Name the project YYY (the working DGCS version for HDDDLL) and in the comments area type in the SCR # and title. The VSS folder for YYY is now created. 11) Click on $/PC-Dev/GA-ASI/Components/HDDDll (do not open HDDDll directory). Click on the Add Files icon (white page with plus) and select the local \HDDDll\YYY folder when prompted (Open YYY folder). Check recursive, and enter SCR# and title. This will populate the VSS YYY folder with the folders within it, with files from your local source. 12) Go back into C:\User\Dev\...\HDDDll\YYY and issue an additional 'attrib -r *.* /s’ command on the directory or right click on YYY folder, go into properties and then unselect the Read-only box.