Git for Windows is the standard Git distribution for Windows. It provides the git command-line
tool, a Bash environment (Git Bash), and supporting utilities. All Continuous Delphi repositories
are hosted on GitHub and require Git for all version control operations.
If you have only ever used source control through a Delphi IDE plugin or a folder-copy workflow, Git is the foundational tool to learn first. Everything else in this guide builds on it.
| Requirement | Value |
|---|---|
| Minimum version | 2.47 |
| Recommended version | Latest stable |
- Required for cloning all repositories
- Required for working with submodules (used in
cd-ci-toolchain) - Required by TortoiseGit, GitHub CLI, and most CI tooling
- Provides
gpg.exebundled inusr/bin/(used for signed commits)
- Latest release: https://git-scm.com/download/win
- GitHub releases: https://github.com/git-for-windows/git/releases/latest
- winget:
winget install --id Git.Git
See setup-git-for-windows.md for step-by-step installation instructions on Windows 11.
- During installation, when asked about the default branch name, choose
main. - When asked about line ending handling, choose "Checkout as-is, commit as-is" if your
repositories use
.gitattributesto manage line endings explicitly (Continuous Delphirepositories do). Otherwise choose "Checkout Windows-style, commit Unix-style line endings". - Git for Windows bundles its own
gpg.exeatC:\Program Files\Git\usr\bin\gpg.exe. This is used for signed commits when configured. See signed commits documentation for details. git --versionshould returngit version 2.47.x.windows.xor later after installation.
-# Git References for Delphi Developers
-
2023-02-16 DelphiCon 2023Demystifying Git, Why is it Popular, and How to Use it?2023-03-13Embarcadero YouTube Video: Git, Demystified - Rich Dudley - Delphicon 2023
-
2022-01-09 Embarcadero BlogHow to Automate Large Numbers of Delphi Project Builds -
2021-12-05 IdeasAwakenedRADAuthenticator Part 4 – Build Automation with Delphi and GitHub by Installing a Self-hosted Runner -
2020-08-19 Embarcadero BlogVersion Control: Get Started with Git, Remote Repositories and RAD Studio XE82020-08-14Embarcadero YouTube Video: Using Git Source Code Control in Delphi and RAD Studio, feat. Ian Barker -
2020-07-22 Delphi Code MonkeyGit with Delphi: The Basics -
2018-03-05 MediumHow I Implemented a CI Build of Delphi Binaries Using GitLab CI -
2016-12-08 The Delphi GeekRAD Studio and Version Control + Git – Links -
2015-02-10 Fixed by CodeGit' Delphi -
Victor Tadashi, GitHub User:
charoleizerdelphi-gitlab-ci-sample (GitLab CI/CD with Delphi example repo) -
toptal.com Delphi .gitignore Generator
- Embarcadero DocWiki Git Integration in the IDE
- GitHub Docs About Commit Signature Verification
- GitHub Docs Signing Commits
- GitHub Docs Signing Tags
2022-10-07 Ken MuseComparing GitHub Commit Signing Options (GPG vs SSH vs S/MIME)2021-12-05 IdeasAwakenedConfigure Git for Signed Commits on Windows Using GPG2020-11-24 Nick JanetakisSigning and Verifying Git Commits on the Command Line and GitHub
- GitHub Docs GitHub Actions: CI/CD Overview
- GitLab Docs Get Started with GitLab CI/CD
2021-12-05 IdeasAwakenedRADAuthenticator Part 4 - Build Automation with Delphi and GitHub by Installing a Self-hosted Runner2021-01-13 IdeasAwakenedGetting Started with CI/CD Using Delphi and Jenkins on Windows
- Atlassian Git Flow Workflow
- conventionalcommits.org Conventional Commits Specification
- GitVersion GitVersion Documentation – Semantic Versioning from Git History
- GitHub Marketplace Git Semantic Version GitHub Action
2019-03-11 Ordinary ExpertsGit Flow, Semantic Versioning, and CHANGELOG.md - Walkthrough
- git-scm.com Pro Git – Git Tools: Submodules
- GitHub Blog Working with Submodules
- Atlassian Git Submodule Tutorial
- git-scm.com Pro Git Book (free)
- Roger Dudler Git: The Simple Guide
- GitHub Docs GitHub Documentation
- GitLab Docs GitLab Documentation