Управление версиями Delphi-приложения через ресурсы
Версия приложения — это часть его технического контракта с пользователем, операционной системой и инструментами распространения. Она отображается в свойствах исполняемого файла, используется установщиками, попадает в отчёты об ошибках и помогает понять, какая сборка установлена на конкретном компьютере. Если эти сведения обновляются вручную, проект быстро получает рассинхронизированные номера.
В Delphi для Windows версионные данные обычно хранятся в ресурсе VERSIONINFO, который компилятор встраивает в исполняемый файл. Такой подход позволяет управлять номером релиза, версией файла, названием продукта, авторскими правами и другими метаданными без изменения исходного кода приложения.
У FireMonkey-проектов есть дополнительная особенность: одна кодовая база может выпускаться для Windows, macOS, Linux, Android и iOS. Формат версии и место её публикации на каждой платформе отличаются, поэтому удобная схема должна учитывать как ресурсы Delphi, так и требования магазинов приложений, пакетов и операционных систем.
Практичная стратегия строится вокруг единого источника данных. Номер версии задаётся в настройках проекта или в автоматизированной сборке, затем попадает в Windows-ресурс и при необходимости передаётся в мобильные конфигурации. Это снижает риск, что имя файла, интерфейс программы и сведения о пакете будут показывать разные значения.
Из чего состоит версия приложения
Чаще всего используются четыре компонента: основная версия, дополнительная версия, номер исправления и номер сборки. В записи 3.5.12.47 первые два числа могут обозначать функциональный релиз, третье — исправления, а последнее — конкретный результат сборочного конвейера. Формат выбирает команда, однако правила должны быть постоянными.
Для Windows важно различать FileVersion и ProductVersion. Первая характеристика относится к конкретному исполняемому файлу и полезна при сравнении заменяемых бинарников. Вторая описывает продукт в целом и может быть общей для нескольких компонентов: основного приложения, службы, библиотеки или установщика.
Внутренняя версия, которую видит программа во время работы, не обязана полностью совпадать с отображаемой строкой. Например, числовые компоненты могут храниться в TVersionInfo, а пользователю показываться как 3.5.12 (сборка 47). Желательно заранее определить, какие данные участвуют в проверке обновлений, а какие служат только для диагностики.
Ресурс VERSIONINFO в Delphi
В Windows-проекте Delphi настройки версии доступны в параметрах проекта, в разделе с информацией о версии. IDE формирует ресурс, связанный с исполняемым файлом через директиву наподобие {$R *.res}. В стандартный набор обычно входят числовая версия файла, версия продукта, описание, название компании, имя продукта и информация об авторских правах.
Для просмотра результата достаточно открыть свойства .exe в проводнике Windows или воспользоваться утилитой анализа PE-файлов. Такой способ полезнее, чем проверка только надписи в окне «О программе»: он показывает, действительно ли ресурс попал в итоговый бинарник.
Если требуется полный контроль, ресурс можно создать вручную в формате .rc и скомпилировать в .res. Пример описания может выглядеть так:
1 VERSIONINFO
FILEVERSION 3,5,12,47
PRODUCTVERSION 3,5,12,0
FILEFLAGSMASK 0x3fL
FILEOS 0x40004L
FILETYPE 0x1L
{
BLOCK "StringFileInfo"
{
BLOCK "040904E4"
{
VALUE "CompanyName", "Example Studio"
VALUE "FileDescription", "Рабочее приложение"
VALUE "FileVersion", "3.5.12.47"
VALUE "ProductName", "Example App"
VALUE "ProductVersion", "3.5.12"
}
}
}
После компиляции ресурс подключается к проекту, но важно не допустить конфликт со стандартным ресурсом, который уже генерирует IDE. В проекте должен остаться один источник VERSIONINFO; иначе итоговая сборка может содержать неожиданные или устаревшие значения.
Единый источник номера версии
На небольшом проекте номер можно изменить в свойствах Delphi вручную. Для регулярных релизов лучше вынести его в отдельный файл, переменные системы сборки или параметры CI/CD. Например, файл version.json может хранить major, minor, patch и build, а скрипт передавать эти значения компилятору и генератору ресурса.
При такой схеме разработчик меняет номер в одном месте, после чего автоматически обновляются ресурс Windows, имя установочного пакета, отображаемая версия и архив артефактов. Номер сборки часто увеличивается при каждом успешном запуске конвейера, тогда как номер продукта меняется только при подготовке релиза.
| Элемент | Назначение | Пример | Где проверять |
|---|---|---|---|
| Основная версия | Крупное изменение продукта | 3 | Окно приложения, магазин |
| Дополнительная версия | Новые функции в рамках релиза | 5 | Свойства файла |
| Исправление | Исправления ошибок | 12 | Отчёт об ошибке |
| Номер сборки | Конкретный результат компиляции | 47 | CI/CD, журнал обновлений |
| Версия файла | Идентификация бинарника Windows | 3.5.12.47 | Свойства .exe |
| Версия продукта | Идентификация выпуска | 3.5.12 | Установщик, интерфейс |
Следует также разделять версию исходного кода и версию приложения. Git-тег v3.5.12 описывает состояние репозитория, но сам по себе не меняет ресурс исполняемого файла. Сборочный сценарий должен связывать тег, номер сборки и создаваемые артефакты, чтобы любой бинарник можно было восстановить по истории проекта.
Получение версии во время работы
В Delphi-приложении версия нужна для окна сведений, диагностического журнала, отправки отчётов и проверки совместимости. На Windows её можно читать из собственного VERSIONINFO через функции API GetFileVersionInfoSize, GetFileVersionInfo и VerQueryValue. Это позволяет получать данные именно из текущего исполняемого файла.
Для FireMonkey-кода часто удобнее иметь общий сервис, например TAppVersionService, который возвращает строку версии независимо от платформы. Внутри сервиса Windows-реализация читает PE-ресурс, Android получает сведения из манифеста или пакета, а iOS использует значения CFBundleShortVersionString и CFBundleVersion.
Не стоит жёстко прошивать одну и ту же строку в нескольких формах. Иначе после выпуска исправления окно «О программе» может показывать новую версию, а журнал — старую. Все части приложения должны обращаться к единому интерфейсу, который формирует нормализованное представление версии.
При обработке обновлений полезно сравнивать числовые компоненты, а не строки. Лексикографическое сравнение ошибочно сочтёт 3.10 меньшей версией, чем 3.9. Поэтому значения следует хранить в структуре с отдельными полями или преобразовывать в последовательность чисел.
Особенности мобильных и настольных платформ
На Android видимая пользователю версия обычно соответствует versionName, а целочисленный номер обновления — versionCode. Первый может быть 3.5.12, второй должен возрастать при публикации нового пакета. Он не обязан совпадать с четвёртым компонентом Windows-версии, но должен контролироваться той же системой сборки.
В iOS применяются CFBundleShortVersionString для маркетинговой версии и CFBundleVersion для номера сборки. App Store предъявляет собственные требования к их изменению, поэтому данные нужно передавать в настройки конкретной цели Xcode или в параметры экспорта приложения. Значения Windows-ресурса автоматически не становятся версиями iOS-пакета.
На macOS приложение также содержит параметры bundle, а Linux-дистрибутивы могут использовать собственные форматы пакетов: DEB, RPM, AppImage или архивы. Для кроссплатформенного проекта разумно иметь общие поля версии и отдельный адаптер, который записывает их в формат соответствующей платформы.
При подготовке релиза стоит проверять метаданные после сборки, а не только параметры проекта. Утилиты анализа пакетов, просмотр свойств файла и автоматические тесты помогают убедиться, что номер действительно попал в установочный артефакт. При работе с внешними системами сборки полезно изучать практики автоматизации и публикации, например в материалах о middleware, адаптируя общие идеи под Delphi-процесс.
Автоматизация проверки и выпуска
Минимальный сценарий сборки должен получить версию из Git-тега или файла конфигурации, проверить её формат, создать ресурс и передать его компилятору Delphi. После компиляции сценарий может извлечь версию из .exe, сравнить её с ожидаемой и завершить работу с ошибкой при расхождении.
Отдельно проверяются правила увеличения номера. Версия файла должна меняться при выпуске нового бинарника, номер продукта — при изменении публичного релиза, а мобильный код сборки — возрастать согласно требованиям магазина. Такие проверки защищают от повторной загрузки пакета с уже использованным номером.
Хорошая практика — включать версию в имя артефакта: ExampleApp-3.5.12-build47-win64.exe. При этом имя не заменяет метаданные внутри файла. Пользователь может переименовать бинарник, а система обновлений и средства диагностики должны всё равно получать корректные сведения из ресурса или пакета.
Перед публикацией проверяются четыре результата: отображение версии в интерфейсе, свойства исполняемого файла, номер установочного пакета и данные целевой платформы. Такая процедура занимает немного времени, но предотвращает путаницу между тестовой, предварительной и стабильной сборками. Delphi-ресурсы становятся надёжной частью процесса тогда, когда их генерация и проверка выполняются автоматически.