如何获取 Git 内部版本号并将其嵌入文件中？

Question

我想介绍一个从 Git 版本中获取的版本控制常量。我知道如何做到这一点——在 svn 中以一种非常骇人听闻的方式——

关于如何使用 Git 执行此操作的任何想法？

Answer 1

这是我的工作：

作为构建过程的一部分，我运行以下脚本（解释一下，因为我现在不在 Xcode）

git describe --all > version.txt

在我的应用程序中，我从该文件中读取版本号并将其显示给用户（必要时）。确保将 version.txt 添加到您的 .gitignore。这样做的好处是，如果你标记你的发布，git describe 只会输出标记，否则它会输出提交哈希。

Answer 2

对我来说，git describe 最初并没有给出主题标签。但是，以下是：

git describe --all --long

这导致了由 kubi 描述的格式。假设您只想要最后一部分（主题标签），如下所示（保存到 version.txt 文件）：

git describe --all --long | tr "-" " " | awk '{ print $3 }' > version.txt

编辑：正如一位朋友向我指出的那样，如果您愿意，实际上可以只使用cut 来完成：

git describe --all --long | cut -d "-" -f 3 > version.txt

Answer 3

为了在 php 中获得 Git 修订，我使用了类似这样的东西（将路径更改为 .Git 目录）

public static function getGitRevision()
     {
         $rev = trim(file_get_contents(NT_Path::ROOT . "/.git/HEAD"));

         if (substr($rev, 0, 4) == 'ref:') {
             $ref =  end(explode('/', $rev));
             $rev = trim(file_get_contents(NT_Path::ROOT . "/.git/refs/heads/{$ref}"));
         }

         return $rev;
     }

Answer 4

与其把它放在一个文本文件中然后每次都获取它的内容，这似乎工作得很好：

sed -i.bak "s/$version = '.*';/$version = '`git rev-parse --short HEAD | tr -d '\n'`';/g" version.php

version.php 看起来像这样：

<?php
$version = 'some version string';

然后将文件包含在脚本中，就像设置文件一样。

如果您愿意，也可以使用 git describe --all --long 作为版本字符串，出于我的目的，我更喜欢 git-ref-parse --short HEAD 中的 git-hash。

或者作为一个可能更好的常数：

sed -i.bak "s/define('VERSION','.*');/define('VERSION','`git describe --all --long | cut -d "-" -f 3`');/g" version.php

和version.php：

<?php
define('VERSION','some version string');

Answer 5

注意：看看 Git 自己如何计算自己的内部版本号很有趣。
这刚刚在 Git 2.12（2017 年第一季度）中发展

见commit a765974（2016 年 12 月 4 日）Ramsay Jones (``)。
帮助者：Jeff King (peff).
^{（由 Junio C Hamano -- gitster -- 合并于 commit 0a45050，2016 年 12 月 19 日）}

GIT-VERSION-GEN 

VN=$(git describe --match "v[0-9]*" HEAD 2>/dev/null) 
# instead of
VN=$(git describe --match "v[0-9]*" --abbrev=7 HEAD 2>/dev/null)

GIT-VERSION-GEN：不要强制'describe'使用的缩写长度

Git 二进制文件的默认版本名称是通过在生成二进制文件的提交上运行“git describe”来计算的，基于名称与“v[0-9]*”匹配的标签，例如v2.11.0-rc2-2-g7f1dc9.

在很早的时候，9b88fce ("Makefile: use git-describe to mark the git version.", 2005-12-27)，我们用“--abbrev=4”来获取 缩写提交对象名称的绝对最小数量。
后来更改为将默认最小值 7 与 bf50515 ("Git 1.7.10.1", 2012-05-01) 匹配。

如今，“默认最小值”会自动缩放，具体取决于 存储库的大小，指定一个没有意义 特定的缩写长​​度；自 Git 1.7.10.1 以来我们想要的一切 days 是为了得到“我们默认使用的合理的东西”。

（这是在 Git 2.11 中引入的：参见“How much of a git sha is generally considered necessary to uniquely identify a change in a given codebase?”的最后部分）

只需从“git describe”的调用中删除“--abbrev=<number>” 并让命令选择它认为合适的，采取 考虑最终用户的配置和存储库内容。

Answer 6

我就是这样做的。注意：获取修订的 Python 代码来自this 帖子。

BuildInfo.hpp

#ifndef BUILDINFO_HPP_
#define BUILDINFO_HPP_

struct BuildInfo
{
    static const char Name[];
    static const char GitRevision[];
};

#endif

（自动生成）BuildInfo.cpp

#include "BuildInfo.hpp"

const char BuildInfo::Name[] = "MyAppNAme";
const char BuildInfo::GitRevision[] = "5e854351b342acff6a3481d9106076df379c449a";

生成BuildInfo.py。用于生成 BuildInfo.cpp 的 Python 脚本。请注意，这可以很容易地适应获取短或长的修订号或其他存储库信息。它也可以转换为生成 C 代码而不是 cpp，因此两者都兼容。

import sys
import os
import subprocess

#args: [0]: this script path [1]: Output file name [2]: Application name string

# Return the git revision as a string
def git_version():
    def _minimal_ext_cmd(cmd):
        # construct minimal environment
        env = {}
        for k in ['SYSTEMROOT', 'PATH']:
            v = os.environ.get(k)
            if v is not None:
                env[k] = v
        # LANGUAGE is used on win32
        env['LANGUAGE'] = 'C'
        env['LANG'] = 'C'
        env['LC_ALL'] = 'C'
        out = subprocess.Popen(cmd, stdout = subprocess.PIPE, env=env).communicate()[0]
        return out

    try:
        out = _minimal_ext_cmd(['git', 'rev-parse', 'HEAD'])
        GIT_REVISION = out.strip().decode('ascii')
    except OSError:
        GIT_REVISION = "Unknown"

    return GIT_REVISION

if len(sys.argv) < 2 :
    exit("No output file name argument provided")
elif len(sys.argv) >= 3 :
    name = sys.argv[2]
else :
    name = ""

revision = git_version()
if (revision == "Unknown") :
    exit("Cant get git revision")

with open(sys.argv[1], "w") as f :
    f.write('#include "BuildInfo.hpp"\r\n\r\n')
    f.write('const char BuildInfo::Name[] = "' + name + '";\r\n')
    f.write('const char BuildInfo::GitRevision[] = "' + revision + '";\r\n')
    f.close()

使用构建信息

#include "BuildInfo.hpp"
...
PrintRevision(BuildInfo::GitRevision);

要生成 BuildInfo.cpp，在我调用的后期构建步骤中（在本例中来自 eclipse IDE）

python ${ProjDirPath}/build/GenerateBuildInfo.py ${ProjDirPath}/src/BuildInfo.cpp ${ProjName}