Installing Delphi and DUnitX Testing Framework
A 30 day free trial of Embarcadero's RAD Studio or Delphi may be downloaded from here. Alternatively, a free Starter Edition version is also available. Follow installation instructions included with the product.
Non-Windows based Operating Systems
Delphi will not run in a non-Windows based operating system. However, it is possible to run Delphi within a virtual machine that is hosting Windows.
Installing DUnitX Test Framework
DUnitX comes installed in Delphi version XE8 and up with an exception for the Starter Edition of Delphi.
With Delphi successfully installed, and working correctly, please follow these steps for retrieving and installing DUnitX if you find that your installation of Delphi is lacking the DUnitX framework.
- DUnitX is an open source project by VSoftTechnologies. The DUnitX GitHub repo is available here.
- It is best to fork the repo and then clone or otherwise download the fork to your local machine.
- Step-by-step instructions on how to install DUnitX into Delphi have been posted by Vincent Parrett in a blog post located here.
- The Starter Edition of Delphi doesn't allow the use of project experts. DUnitX comes with an expert which will aid the student in creating a new DUnitX based project. The expert creates the project's .DPR file. The exercises in this track all include the .DPR file making the expert not necessary. DUnitX otherwise has no issues with projects created in Delphi versions starting with XE all the way up to and including the Starter Edition of Berlin.
Delphi Configuration for DUnitX
If you had to install DUnitX because your installation didn't already come with it then please follow the following illustrated steps to make the necessary configuration changes to Delphi in order for it to locate your installation of DUnitX.
Note: it is assumed that you have completed the installation of Delphi by this point.
- Start Delphi. If your installation is new you will most likely end up at a
Welcome Pagesimilar to this.
- Find and click
Toolsalong the top menu.
- Along the left side of the Options screen find and click on
- Click the
Newbutton located in the
- A New User Variable window should appear that contains two fields. In the top field enter
DUNITXfor the Variable Name. In the bottom field enter the complete path to your copy of DUnitX, for example mine is
C:\Program Files\Embarcadero\Studio\18.0\source\DUnitX. Click the
Okbutton to then close this window.
- Locate and click on
Libraryalong the left side of the Options screen.
- Click the
...button associated with the Library path in the Directories group
- In the Directories window enter the variable name that you created a few steps ago. The entry should appear like this
Addbutton to add this new item to the list.
Okbutton to store the change.
- Finally, click the
Okbutton on the Options window to save all the changes.
Delphi will now be able to locate units that pertain to the DUnitX testing framework library.
Note: It is assumed that Delphi versions XE and higher are being utilized by the student.
Help us explain this better! File a GitHub issue at https://github.com/exercism/delphi/issues if you have suggestions, or submit a patch with improvements to the https://github.com/exercism/delphi/blob/master/docs/INSTALLATION.md file.