[译]自动Windows资源(* .rc)版本编辑器

By robot-v1.0

本文链接 https://www.kyfws.com/applications/auto-windows-resource-rc-version-editor-zh/

01月01日, 0001 - 6 分钟阅读 - 2891 个词 阅读量 0

[译]自动Windows资源(* .rc)版本编辑器

原文地址：https://www.codeproject.com/Articles/3650/Auto-Windows-Resource-rc-version-Editor

原文作者：Réda BOUREBABA

译文由本站 robot-v1.0 翻译

前言

This freeware allows to edit a Windows Resources File (.rc) and to produce a file named ‘version.h’ containing several string constants (#define). It can also synchronize a RC file and version.h with the Classbuilder Master Header File.*

这个免费软件允许编辑Windows资源文件(* .rc)并生成一个名为’version.h’的文件,其中包含多个字符串常量(#define).它还可以将RC文件和version.h与Classbuilder主头文件同步.

介绍(Introduction)

该免费软件的灵感也来自CodeProject托管的Srinivas Vaithianathan的工具:(This freeware is inspired by a tool by Srinivas Vaithianathan hosted by CodeProject too:) 在构建时对可执行文件进行版本控制(Versioning of executables at build time) .我完全修改了它,现在没有任何代码了.(. I completely modified it and now there isn’t any code remaining from it.)

从现在开始,我使用了一个很棒的开源工具,名为(Since several years now, I’m using a great open source tool named)类构建器(ClassBuilder).该工具由Jimmy Venema提供,可以在以下位置找到(. This tool is provided by Jimmy Venema and can be found at) SourceForge(SourceForge) .(.)

从Sourceforge项目页面:(From Sourceforge project page:)

ClassBuilder是针对C ++开发人员的免费CASE工具,在Win95/98/NT上运行.它使您可以通过图形用户界面以高度抽象的方式创建,操作和导航类,类关系,类成员和类方法.(ClassBuilder is a freeware CASE tool targeted at the C++ developer, running on Win95/98/NT. It lets you create, manipulate and navigate classes, class relations, class members and class methods at a high level of abstraction through a graphical user interface.)类构建器(ClassBuilder)为每个类生成两个文件(一个(generates two files for each class (one) .cpp(.cpp*)*还有一个(and one).H(**.h*))和整个数据模型的主标头文件.主头文件包含所有类的头,定义了() and a Master Header File for the whole data model. The Master Header File includes all the classes' headers, defines the*) typedef s,…该文件还包含一些符号常量,这些符号常量在生成源时会自动更新.根据一个数据模型命名(s,… This file also contains some symbolic constants which are automatically updated when you generate the sources. According to a data model named)模型(model),主头文件(, the Master Header File)*型号(model.h)*将包含:(will contain:)

#define MODEL_DATE      20030211
#define MODEL_TIME      193311
#define MODEL_VERSION   12

每次更改界面时,(Each time you change the interface,)类构建器(ClassBuilder)增量(increments) MODEL_VERSION 和更新(and updates) MODEL_DATE 和(and) MODEL_TIME .(.)

将数据模型编译为可执行文件或DLL(Compiling the data model as executable or DLL)

要使用数据模型,您应该将其编译为静态库,可执行文件或DLL.如果是exe或DLL,Visual Studio会生成一个(To use the data model, you should compile it as a static lib, an executable or a DLL. In case of exe or DLL, the Visual Studio generates a)** .rc(**.rc*)*文件.该文件包含GUI定义,图标,光标,位图…,还应包含二进制文件的版本信息.(*file. This file contains GUI definitions, icons, cursors, bitmaps… It should also contain the version information of the binary.*)

这是Windows资源文件中的代码片段,它描述了以下文件的版本信息(Here is the fragment of code in a Windows Resource File which describes the version information for)*RC版本(RCVersion)*本身.(itself.)

/////////////////////////////////////////////////////////////////////////////
//
// Version
//

VS_VERSION_INFO VERSIONINFO
FILEVERSION 1, 0, 0, 100
PRODUCTVERSION 1, 0, 0, 1
 FILEFLAGSMASK 0x3fL
#ifdef _DEBUG
 FILEFLAGS 0x9L
#else
 FILEFLAGS 0x8L
#endif
 FILEOS 0x4L
 FILETYPE 0x1L
 FILESUBTYPE 0x0L
BEGIN
    BLOCK "StringFileInfo"
    BEGIN
        BLOCK "040904b0"
        BEGIN
            VALUE "Comments", "Modified by BZCToOn's"
            VALUE "CompanyName", "Syntheretix"
            VALUE "FileDescription", "rcversion MFC Application"
            VALUE "FileVersion", "1, 0, 0, 100"
            VALUE "InternalName", "rcversion"
            VALUE "LegalCopyright", "Copyleft (C) Bzc ToOn'S 2002"
            VALUE "OriginalFilename", "rcversion.EXE"
            VALUE "PrivateBuild", "RCVERSION-20030212_100"
            VALUE "ProductName", "rcversion Application"
            VALUE "ProductVersion", "1, 0, 0, 1"
        END
    END
    BLOCK "VarFileInfo"
    BEGIN
        VALUE "Translation", 0x409, 1200
    END
END

RCVersion有什么作用？(What RCVersion does?)

*RC版本(RCVersion)*同时解析主头文件和资源文件.接下来,根据这两个文件中包含的信息,它生成一个名为(parses both the Master Header File and the Resources File. Next, according to the information contained in these two files, it generates a file named)*版本(version.h)*并更新资源文件.(and updates the Resources File.)

输出:version.h(Output: version.h)

这是由产生的输出文件(Here is the output file produced by)*RC版本(RCVersion)*本身.(for itself.)

// Generated by RCVersion 1.0.0.1 build RCVERSION-20030212_100 (20030213-020245)
// Copyleft (C) Bzc ToOn'S 2002
// Generated on 13/02/2003 02:02:46 from resource file rcversion.rc
#define __SNAPSHOT__        "20030213-020246"
#define __FILEVERSION__     "1.0.0.100"
#define __PRODUCTVERSION__  "1.0.0.1"
#define __COMPANY__         "Syntheretix"
#define __PRODUCT__         "rcversion Application"
#define __DESCRIPTION__     "rcversion MFC Application"
#define __PRIVATEBUILD__    "RCVERSION-20030212_100"
#define __COPYRIGHT__       "Copyleft (C) Bzc ToOn'S 2002"

// Master Header Values (ClassBuilder)!!
#define __CB_DATE__         "20030212"
#define __CB_TIME__         "190244"
#define __CB_VERSION__      "100"

// Do Not Modify !!

命令行执行(Command line execution)

rcversion [-q] [-i input]
  -q   quiet: don't show the UI. Usefull for Custom Build Step in Visual Studio.
  -i   input: specify the input file. The input file could be *.rc or *.h.
              The filename without extension will be used as data model name.

如何在Visual Studio中使用RCVersion(How to use RCVersion with Visual Studio)

向项目添加文件:(Add a file to the project:)版本(version.h)
定义自定义构建步骤(Define Custom Build Step)
- **命令行:(Command Line:)**rcversion -q -i $ {TargetName)(rcversion -q -i $(TargetName))
- **描述:(Description:)**RC版本(RCVersion)
- **输出:(Output:)**版本(version.h)
- 依存关系:(Dependencies:)$(TargetName).h($(TargetName).h*)*
您现在可以放(You can now put) #include 'version.h' 在(in)$(TargetName).h($(TargetName).h*)*或在(*or in*)*stdafx.h(*stdafx.h*)*.(*.*) **别忘了将RCVERSION放在路径上(*Don’t forget to put RCVERSION in path*)**

要么(or)

将Visual Studio可执行文件路径设置为安装RCVERSION的目录(To set Visual Studio executable path to the directory where RCVERSION is installed)

特征(Features)

从Classbuilder主头文件中提取版本号(Version number extraction from Classbuilder Master Header File)
RC文件版本信息编辑器(RC File version information editor)
*版本(version.h)*代(generation)
可选的RC文件更新(Optional RC file update)
备份您的旧(Backup of your old)*版本(version.h)*和RC文件(and RC files)
预览(Preview of)*版.(version.)*h和RC文件(h and RC files)
版本(Edition of)*版本(version.h)*和RC文件(通过记事本:-))(and RC files (through Notepad :-)))
非互动执行(Non interactive execution)

错误与限制(Bugs & limitation)

我仅在自己的项目中测试了RCVersion.对我来说,它运行良好.我也希望你;-).(I only tested RCVersion on my own projects. For me, it runs fine. I hope for you too ;-).)

历史(History)

RCVERSION-20030212_100(RCVERSION-20030212_100)
- 初版(First release)
RCVERSION-20030214_200(RCVERSION-20030214_200)
- 版本(version.h): 添加(: Added) #ifdef _DEBUG / #endif
- 版本(version.h):更好的格式(: better formatting)
- 在符号常量中添加了新字段" Symbols Prefix"(Added new field ‘Symbols Prefix’ to the symbolic constants)
- 添加了新的命令行选项(Added new command line option) -p prefix 设置符号前缀(to set the symbols prefix)
- 预览控件现在是(Preview control is now a) RichEdit 一种支持固定宽度的字体(one to support fixed width font)

修正错误(Fixed Bugs)

RC文件解析:如果控件ID包含以下内容之一:(RC File parsing: If a control ID contains one of the) VERSIONINFO 指令((directive () FILEVERSION ,(,) PRODUCTVERSION ),整行被替换,整个RC文件已损坏.(), the whole line is replaced and the whole RC File is corrupted.)

许可

本文以及所有相关的源代码和文件均已获得The Code Project Open License (CPOL)的许可。

C++ VC7.0 WinXP Windows Win2K MFC Visual-Studio Dev 新闻翻译