README

Delphi Versions Include File

A Delphi include file of Delphi version compiler directives to simplify conditional compilation based on compiler version. Supporting from Delphi 2007 through Delphi 13 Florence.

Including in Your Project

You can use Git's submodule support to include the latest DelphiVersions.inc automatically in your project's Git repo (it doesn't even need to be on GitHub).

Scripted Install

There is a polygot script that should work in PowerShell, CMD, & Bash to add it as a submodule, and running it later will update to the latest version.

In a hurry? You can use the following one-liner to install it. Just run this from a terminal in your repository (curl is available on Windows 10 an newer, and most all Linux distros.)

From a Command Prompt (not PowerShell)

curl -LO "https://raw.githubusercontent.com/jimmckeeth/DelphiVersions/master/update_delphiversions.cmd" && update_delphiversions.cmd && del update_delphiversions.cmd

From PowerShell terminal (not CMD.exe)

iwr -useb 'https://raw.githubusercontent.com/jimmckeeth/DelphiVersions/master/update_delphiversions.cmd' -OutFile 'update_delphiversions.cmd'; ./update_delphiversions.cmd; rm update_delphiversions.cmd

From Bash / WSL / Git Bash

curl -fsSL https://raw.githubusercontent.com/jimmckeeth/DelphiVersions/master/update_delphiversions.cmd | sh

Manual Install

If you want to install it manually, run the following git commands in your repo:

git submodule add https://github.com/jimmckeeth/DelphiVersions.git DelphiVersions
git submodule update --remote --merge DelphiVersions

And then in the when you want to update DelphiVersions.inc just repeat the last line

git submodule update --remote --merge DelphiVersions

or just run update_delphiversions.cmd again.

Troubleshooting

Git submodules are configured through the .gitmodules file in the root of your respository. After the above steps it should look something like:

[submodule "DelphiVersions"]
        path = DelphiVersions
        url = https://github.com/jimmckeeth/DelphiVersions.git

If you have trouble you can remove those lines and delete the folder and try again. Or read the docs.

Directivies & Usage

If your code requires a feature introduced in Delphi 10.0 then you would use

{$I DelphiVersions\DelphiVersions.inc}

{$IFDEF DELPHI10_UP}
// Your fancy code
{$ENDIF}

Here is a list of directives defined: