rzaripov.kz

Управление версиями 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-ресурсы становятся надёжной частью процесса тогда, когда их генерация и проверка выполняются автоматически.