Difference between revisions of "LMD VCL - DevUtil"

Revision as of 17:03, 3 June 2007

<< Back to Getting started or Product Resources page

[edit]

Introduction

Customers who purchased LMD VCL Complete Subscription can request access data to our source code repository (which allows to download most current version at any time). The LMD VCL 2007 source branch is quite complex with the two main products (LMD-Tools, LMD ElPack and LMD IDE-Tools) + various sub- and standalone packages). Therefore we created a small tool which allows simple and fast testing of any possible package combination. A package combination (a set of LMD projects, e.g. LMD-Tools Core Controls + ChartPack and DesignPack) is called a WorkSpace.

Features

User with SVN can completely abstain from downloading full installers: Using the SVN sourcecode and LMD DevUtil any supported package can be easily created on the fly. Major features are:

• Apart from a first huge download (of the current source releases) only actually changed source files (or better: even source changes) need to be downloaded in the future (instead of full installers with complete sourcecode).
• Besides predefined standard WorkSpaces (which actually correspond to available LMD 2007 packages) you can set up any custom WorkSpace. You need to attend specific dependencies (e.g. all LMD Packages use shared lmd.rtl) only.
• LMD DevUtil is very flexible and allows any number of different local WorkSpaces with their own work/target folder.
• Working folder features:
  • Prepare folder for work in specified IDE (very fast, by one button click), e.g. generate package files, rename *.pas and *.dfm files (for .Net), create working project group, remove all other LMD-packages from IDE registry, add working folder to IDE search paths and start specified IDE with that project group.
  • Removes all compiled and garbage files; rename files back, delete redundant package files, ect. (useful for file comparision with main source folder).
• Setting common compiler switches via GUI

Preparations

At very first step you must ensure to get access to our source repository (based on Subversion, abbreviated: SVN). Various ways are possible (and you are free to use any available client). We strongly recommend TortoiseSVN - a great free Windows-based GUI client to access SVN based repositories. We definitely like the way how integration into Windows Explorer is done.

• URL of TortoiseSVN homepage is http://tortoisesvn.net. In the left navigation bar click on Download and get the most appropriate installer for you.
  After downloading, run the installer. If you install TortoiseSVN the first time, you usually have to reboot your system.
• Now you have to make your initial checkout for the LMD 2007 source branch. Start Windows Explorer, select a target drive and click somewhere with right mousebutton to display context menu. You will notice a new SVN Checkout... menu item. Select this menu item to display the Checkout dialog.
• Enter here the URL of the repository (you received it with your access data) and the checkout directory. We suggest to use a directory name like C:\LMD2007VCL (in any case you should avoid to select an existing directory). Then press ok.
• Ignore the message regarding a certificate, after that you will asked for username and password (which you received with your SVN access data). Now the complete and most current version of the LMD VCL 2007 sourcecode will be downloaded onto your system.

Special Note: We strongly recommend not to change any files in the local repository. Always use DevUtil to generate working/installation folders. Reason: A common sourcebase for all relevant and supported compilers is used. When you check out source directories you will notice missing project files. They will always be autogenerated on the fly when needed.

• Now start the first time LMDDevUtil.exe from the target folder.
  • A dialog will pop up and ask for the LMD VCL Source directory (usually the checkout directory, in our example: C:\LMD2007VCL) and the Root Working directory. The later one is used as variable (%ROOT_WORKDIR%) for different working directories. Mention here the target folder where compiled/generated versions should be located.
  • After that specify the name of the first WorkSpace on your system.

Using LMD DevUtil

After preparations the application window of LMD DevUtil should look as follows:
The Workspace tab contains two sections: Local (your custom workspaces, where you can add/modify any number of workspaces) and Shared SVN Workspaces (the predefined ones, which represent actually all available LMD 2007 products.

Auto-compile packages and start IDE

To compile and install e.g. LMD-Tools SE into your IDE, simply follow these steps:

• Select LMD-Tools SE workspace in Shared SVN tab. Change any of available compiler switch options.
• Click on Start button at top of application window. If IDE (in example: d7 represents Delphi 7) is already displayed in button, simply click on it. Otherwise click the arrow and select the target IDE.
• The files will be generated (and placed in the directory specified in Working Directory
• All packages will be compiled, IDE will be started, lib paths and package settings will be automatically updated. Also all packages specified on Additional tab will be automatically removed.
  

Messages Output Tab

When Start function is used, the compiler output is displayed here.

Prepare Working folder only

To compile and install e.g. LMD-Tools SE into your IDE, simply follow these steps:

• Select LMD-Tools SE workspace in Shared SVN tab. Change any of available compiler switch options.
• Click on Prepare button at top of application window. If IDE (in example: d7 represents Delphi 7) is already displayed in button, simply click on it. Otherwise click the arrow and select the target IDE.
• All required files will be generated (in the directory specified in Working Directory
• No files will be compiled, only lib paths will be automatically updated. In addition a project group file will be generated which will include all selected projects. After you started IDE, you can simply load this project group file and compile/install all included packages.
  

Clean Up feature

Removes all compiled and garbage files; renames files back, deletes redundant package files, etc. (useful for file comparision with main source folder). This is NOT the same like pressing "Delete all files.." button!

Delete all files from working directory

Press this button to delete ALL files from working directory. This is a required step when you want e.g. to generate files for a different IDE/compiler.

How to...

Update SVN archive

Click with right mousebutton on SVN folder (in example: C:\LMD2007VCL). In context menu select SVN Update. Now local SVN will be synchronized with remote SVN (all updates since last checkout will be applied).

Create a custom WorkSpace

To create a custom local WorkSpace:

• Switch to Local tab on left PageControl.
• Click on "New WorkSpace" button and modify name.
• The easiest way is to use project names from one of the Shared SVN WorkSpaces. Simply use entries from "Projects" memo field and add/remove desired projects.
• Specify a Working Directory, if required change compiler switches.
• Form File menu select Save config now

Combine different WorkSpaces

When you combine different WorkSpaces, make sure that no redundant entries are included. E.g. to create a combined WorkSpace of LMD-Tools SE and LMD ElPack Standard, lmd.rtl and lmd.rtlx projects need to be included only once:
lmd.rtl
lmd.rtlx
lmd.core
lmd.elcore