0
0
mirror of https://github.com/dreamforceinc/wUpdateVersionPS.git synced 2026-03-28 18:52:46 +03:00

Fixed codepage of README.md file.

This commit is contained in:
2026-02-17 15:40:40 +03:00
parent f4e2a4cfb1
commit 465b5049ab

View File

@@ -1,61 +1,61 @@
# wUpdateVersionPS # wUpdateVersionPS
Ñêðèïò PowerShell äëÿ àâòîìàòè÷åñêîãî îáíîâëåíèÿ íîìåðà âåðñèè ïðîãðàììû. Скрипт PowerShell для автоматического обновления номера версии программы.
_**Ôàéë ðåñóðñîâ äîëæåí áûòü â ANSI èëè UTF-8 êîäèðîâêå.**_ _**Файл ресурсов должен быть в ANSI или UTF-8 кодировке.**_
## Íàçíà÷åíèå ñêðèïòà ## ## Назначение скрипта ##
`wUpdateVersionPS` ñëóæèò äëÿ àâòîìàòè÷åñêîãî îáíîâëåíèÿ âåðñèè ïðîãðàììû ïåðåä ýòàïîì êîìïèëÿöèè â ñðåäå ðàçðàáîòêè Microsoft Visual Studio. Ñêðèïò èçâëåêàåò çíà÷åíèå âåðñèè èç ôàéëà, ñîäåðæàùåãî ìàêðîñ èëè îïðåäåëåíèå `APP_VERSION`, è çàïèñûâàåò ýòó âåðñèþ â áëîê `VERSIONINFO` ôàéëà ðåñóðñîâ. `wUpdateVersionPS` служит для автоматического обновления версии программы перед этапом компиляции в среде разработки Microsoft Visual Studio. Скрипт извлекает значение версии из файла, содержащего макрос или определение `APP_VERSION`, и записывает эту версию в блок `VERSIONINFO` файла ресурсов.
## ×òî äåëàåò ñêðèïò? ## ## Что делает скрипт? ##
1. Èçâëåêàåò âåðñèþ ïðîãðàììû èç çàäàííîãî ôàéëà (*íàïðèìåð `version.h`*), ñîäåðæàùåãî ñòðîêó âèäà `#define APP_VERSION "X.Y.Z.W"`. 1. Извлекает версию программы из заданного файла (*например `version.h`*), содержащего строку вида `#define APP_VERSION "X.Y.Z.W"`.
2. Îáíîâëÿåò â óêàçàííîì ôàéëå ðåñóðñîâ (*íàïðèìåð `resources.rc`*) áëîê `VERSIONINFO`, ñîäåðæàùèé ñòðîêè `FileVersion` è `ProductVersion`, ñîîòâåòñòâåííî. 2. Обновляет в указанном файле ресурсов (*например `resources.rc`*) блок `VERSIONINFO`, содержащий строки `FileVersion` и `ProductVersion`, соответственно.
## Êàê çàïóñòèòü ñêðèïò? ## ## Как запустить скрипт? ##
Çàïóñêàéòå ñêðèïò êîìàíäîé â êîíñîëè PowerShell: Запускайте скрипт командой в консоли PowerShell:
```bash ```bash
powershell.exe -ExecutionPolicy Bypass -File path\to\wUpdateVersionPS.ps1 arg1 arg2 powershell.exe -ExecutionPolicy Bypass -File path\to\wUpdateVersionPS.ps1 arg1 arg2
``` ```
Ïàðàìåòðû: Параметры:
`path\to\wUpdateVersionPS.ps1`: Ïîëíûé ïóòü ê PowerShell-ñêðèïòó. `path\to\wUpdateVersionPS.ps1`: Полный путь к PowerShell-скрипту.
`arg1`: Ïóòü ê ôàéëó, ñîäåðæàùåìó îïðåäåëåíèå âåðñèè (`version.h`). `arg1`: Путь к файлу, содержащему определение версии (`version.h`).
`arg2`: Ïóòü ê ôàéëó ðåñóðñîâ (`resources.rc`). `arg2`: Путь к файлу ресурсов (`resources.rc`).
Íàïðèìåð: Например:
```bash ```bash
powershell.exe -ExecutionPolicy Bypass -File C:\Scripts\wUpdateVersionPS.ps1 C:\Project\version.h C:\Project\resources.rc powershell.exe -ExecutionPolicy Bypass -File C:\Scripts\wUpdateVersionPS.ps1 C:\Project\version.h C:\Project\resources.rc
``` ```
## Àâòîìàòèçàöèÿ çàïóñêà ñêðèïòà ïåðåä ñáîðêîé ïðîåêòà ## ## Автоматизация запуска скрипта перед сборкой проекта ##
Âû ìîæåòå äîáàâèòü âûçîâ ñêðèïòà â êà÷åñòâå ïðåäêîìïèëÿöèîííîãî øàãà â ïðîåêòå Microsoft Visual Studio, âûïîëíèâ ñëåäóþùèå øàãè: Вы можете добавить вызов скрипта в качестве предкомпиляционного шага в проекте Microsoft Visual Studio, выполнив следующие шаги:
1. Ù¸ëêíèòå ïðàâîé êíîïêîé ìûøè ïî ïðîåêòó â Solution Explorer è âûáåðèòå ïóíêò Properties. 1. Щёлкните правой кнопкой мыши по проекту в Solution Explorer и выберите пункт Properties.
2. Ïåðåéäèòå íà âêëàäêó Build Events, ðàçäåë Pre-Build Event, Command Line. 2. Перейдите на вкладку Build Events, раздел Pre-Build Event, Command Line.
3. Äîáàâüòå òóäà ñëåäóþùèé êîä: 3. Добавьте туда следующий код:
```bash ```bash
powershell.exe -ExecutionPolicy Bypass -File "$(SolutionDir)wUpdateVersionPS.ps1" "$(ProjectDir)version.h" "$(ProjectDir)resources.rc" powershell.exe -ExecutionPolicy Bypass -File "$(SolutionDir)wUpdateVersionPS.ps1" "$(ProjectDir)version.h" "$(ProjectDir)resources.rc"
``` ```
> *Â äàííîì ïðèìåðå ñêðèïò `wUpdateVersionPS.ps1` íàõîäèòñÿ â ïàïêå ðåøåíèÿ, à ôàéëû `version.h` è `resources.rc` - â ïàïêå ïðîåêòà.* > *В данном примере скрипт `wUpdateVersionPS.ps1` находится в папке решения, а файлы `version.h` и `resources.rc` - в папке проекта.*
4. Îáíîâèòå îïðåäåëåíèå ìàêðîñà `APP_VERSION` â ôàéëå `version.h` (Íàïðèìåð `APP_VERSION "1.0"` -> `APP_VERSION "1.1"`). 4. Обновите определение макроса `APP_VERSION` в файле `version.h` (Например `APP_VERSION "1.0"` -> `APP_VERSION "1.1"`).
Òàêèì îáðàçîì, êàæäûé ðàç ïåðåä êîìïèëÿöèåé ïðîåêòà âåðñèÿ ïðîãðàììû áóäåò àâòîìàòè÷åñêè îáíîâëÿòüñÿ. Таким образом, каждый раз перед компиляцией проекта версия программы будет автоматически обновляться.
_(c) 2026 Vladislav Salikov aka W0LF aka 'dreamforce'_ _(c) 2026 Vladislav Salikov aka W0LF aka 'dreamforce'_
> _Ýòîò òåêñò ñîçäàí ñ ïîìîùüþ Giga.Chat._ > _Этот текст создан с помощью Giga.Chat._
----- -----