mirror of
https://github.com/dreamforceinc/wUpdateVersionPS.git
synced 2026-03-28 10:42:46 +03:00
119 lines
5.6 KiB
Markdown
119 lines
5.6 KiB
Markdown
# wUpdateVersionPS
|
||
|
||
Скрипт PowerShell для автоматического обновления номера версии программы.
|
||
|
||
_**Файл ресурсов должен быть в ANSI или UTF-8 кодировке.**_
|
||
|
||
|
||
## Назначение скрипта ##
|
||
`wUpdateVersionPS` служит для автоматического обновления версии программы перед этапом компиляции в среде разработки Microsoft Visual Studio. Скрипт извлекает значение версии из файла, содержащего макрос или определение `APP_VERSION`, и записывает эту версию в блок `VERSIONINFO` файла ресурсов.
|
||
|
||
## Что делает скрипт? ##
|
||
|
||
1. Извлекает версию программы из заданного файла (*например `version.h`*), содержащего строку вида `#define APP_VERSION "X.Y.Z.W"`.
|
||
|
||
2. Обновляет в указанном файле ресурсов (*например `resources.rc`*) блок `VERSIONINFO`, содержащий строки `FileVersion` и `ProductVersion`, соответственно.
|
||
|
||
## Как запустить скрипт? ##
|
||
|
||
Запускайте скрипт командой в консоли PowerShell:
|
||
|
||
```bash
|
||
powershell.exe -ExecutionPolicy Bypass -File path\to\wUpdateVersionPS.ps1 arg1 arg2
|
||
```
|
||
Параметры:
|
||
|
||
`path\to\wUpdateVersionPS.ps1`: Полный путь к PowerShell-скрипту.
|
||
|
||
`arg1`: Путь к файлу, содержащему определение версии (`version.h`).
|
||
|
||
`arg2`: Путь к файлу ресурсов (`resources.rc`).
|
||
|
||
Например:
|
||
|
||
```bash
|
||
powershell.exe -ExecutionPolicy Bypass -File C:\Scripts\wUpdateVersionPS.ps1 C:\Project\version.h C:\Project\resources.rc
|
||
```
|
||
|
||
## Автоматизация запуска скрипта перед сборкой проекта ##
|
||
|
||
Вы можете добавить вызов скрипта в качестве предкомпиляционного шага в проекте Microsoft Visual Studio, выполнив следующие шаги:
|
||
|
||
1. Щёлкните правой кнопкой мыши по проекту в Solution Explorer и выберите пункт Properties.
|
||
|
||
2. Перейдите на вкладку Build Events, раздел Pre-Build Event, Command Line.
|
||
|
||
3. Добавьте туда следующий код:
|
||
```bash
|
||
powershell.exe -ExecutionPolicy Bypass -File "$(SolutionDir)wUpdateVersionPS.ps1" "$(ProjectDir)version.h" "$(ProjectDir)resources.rc"
|
||
```
|
||
> *В данном примере скрипт `wUpdateVersionPS.ps1` находится в папке решения, а файлы `version.h` и `resources.rc` - в папке проекта.*
|
||
|
||
4. Обновите определение макроса `APP_VERSION` в файле `version.h` (Например `APP_VERSION "1.0"` -> `APP_VERSION "1.1"`).
|
||
|
||
Таким образом, каждый раз перед компиляцией проекта версия программы будет автоматически обновляться.
|
||
|
||
_(c) 2026 Vladislav Salikov aka W0LF aka 'dreamforce'_
|
||
|
||
> _Этот текст создан с помощью Giga.Chat._
|
||
-----
|
||
|
||
|
||
# wUpdateVersionPS
|
||
|
||
A PowerShell script for automatically updating the program version number.
|
||
|
||
_**The resource file must be in ANSI or UTF-8 encoding.**_
|
||
|
||
## Script Purpose ##
|
||
`wUpdateVersionPS` is used to automatically update the program version before compilation in the Microsoft Visual Studio IDE. The script extracts the version value from a file containing the `APP_VERSION` macro or definition and writes this version to the `VERSIONINFO` block of the resource file.
|
||
|
||
## What does the script do? ##
|
||
|
||
1. Extracts the program version from the specified file (*e.g. `version.h`*) containing the string `#define APP_VERSION "X.Y.Z.W"`.
|
||
|
||
2. Updates the `VERSIONINFO` block in the specified resource file (*e.g. `resources.rc`*) containing the strings `FileVersion` and `ProductVersion`, respectively.
|
||
|
||
## How do I run the script? ##
|
||
|
||
Run the script with the following command in the PowerShell console:
|
||
|
||
```bash
|
||
powershell.exe -ExecutionPolicy Bypass -File path\to\wUpdateVersionPS.ps1 arg1 arg2
|
||
```
|
||
Parameters:
|
||
|
||
`path\to\wUpdateVersionPS.ps1`: Full path to the PowerShell script.
|
||
|
||
`arg1`: Path to the file containing the version definition (`version.h`).
|
||
|
||
`arg2`: Path to the resource file (`resources.rc`).
|
||
|
||
For example:
|
||
|
||
```bash
|
||
powershell.exe -ExecutionPolicy Bypass -File C:\Scripts\wUpdateVersionPS.ps1 C:\Project\version.h C:\Project\resources.rc
|
||
```
|
||
|
||
## Automating the execution of a script before building a project ##
|
||
|
||
You can add a script call as a pre-compile step in a Microsoft Visual Studio IDE by following these steps:
|
||
|
||
1. Right-click the project in Solution Explorer and select Properties.
|
||
|
||
2. Go to the Build Events tab, Pre-Build Event section, Command Line.
|
||
|
||
3. Add the following code there:
|
||
```bash
|
||
powershell.exe -ExecutionPolicy Bypass -File "$(SolutionDir)wUpdateVersionPS.ps1" "$(ProjectDir)version.h" "$(ProjectDir)resources.rc"
|
||
```
|
||
> *In this example, the `wUpdateVersionPS.ps1` script is located in the solution folder, and the `version.h` and `resources.rc` files are in the project folder.*
|
||
|
||
4. Update the definition of the `APP_VERSION` macro in the `version.h` file (e.g. `APP_VERSION "1.0"` -> `APP_VERSION "1.1"`).
|
||
|
||
This way, the program version will be automatically updated every time the project is compiled.
|
||
|
||
_(c) 2026 Vladislav Salikov aka W0LF aka 'dreamforce'_
|
||
|
||
> _This text was created using Giga.Chat._
|