基于cmake为项目自动获取git分支tag的版本号和commitid

#include <stdio.h>
#include "config.h"

int main()
{
    printf("version: %s\n", PROJECT_VERSION);
    printf("commit:  %s\n", GIT_COMMITID);
    printf("branch:  %s\n", GIT_BRANCH);
    printf("build time: %s\n", BUILD_TIME);
    printf("build no: %s\n", BUILD_NO);
    return 0;
}

#ifndef __CONFIG_H__
#define __CONFIG_H__

#define PROJECT_VERSION "0-1-9-alpha"
#define GIT_COMMITID    "51045662cffc38c5cf706090a6f0c3d16311d85e"
#define GIT_BRANCH      "test"
#define BUILD_TIME      "2024-07-10 10:45:29"
#define BUILD_NO        "10"

#endif

stone:build$ ./gitversion

version: 0-1-9-alpha
commit:  51045662cffc38c5cf706090a6f0c3d16311d85e
branch:  test
build time: 2024-07-10 10:45:29
build no: 10

cmake_minimum_required(VERSION 3.5 FATAL_ERROR)

project(gitversion C)

# 设置自定义模块文件的所在路径
list(APPEND CMAKE_MODULE_PATH "${PROJECT_SOURCE_DIR}/cmake/")

# 导入自定义模型文件
include(GitVersion)
include(BuildNumber)

# 获取程序的版本信息
fetch_version_from_git("GITVERSION")

# 获取程序的构建号
new_build_number("GITVERSION")

set(GITVERSION_VERSION "${GITVERSION_VERSION_MAJOR}-${GITVERSION_VERSION_MINOR}-${GITVERSION_VERSION_PATCH}-${GITVERSION_VERSION_STAGE}")

# 生成程序的构建时间
string(TIMESTAMP BUILD_TIME "%Y-%m-%d %H:%M:%S")

# 利用config.h.in模板文件自动生成config.h文件
configure_file("${PROJECT_SOURCE_DIR}/config.h.in"
            "${PROJECT_SOURCE_DIR}/config.h" @ONLY)

# 创建构建目标为可执行程序
add_executable(${PROJECT_NAME} test.c)

# This module defines the following variables utilizing
# git to determine the parent tag. And if found the macro
# will attempt to parse them in the github tag format
#
# Useful for auto-versioning in our CMakeLists
#
#  ${VARPREFIX}_VERSION_MAJOR - Major version.
#  ${VARPREFIX}_VERSION_MINOR - Minor version
#  ${VARPREFIX}_VERSION_PATCH - Patch number
#  ${VARPREFIX}_VERSION_STAGE - Stage version
#  ${VARPREFIX}_COMMITID      - Git commitid
#  ${VARPREFIX}_BRANCH        - Git branch
#
# Example usage:
#
# fetch_version_from_git("test")
#    message("        major=${test_VERSION_MAJOR}")
#    message("        minor=${test_VERSION_MINOR}")
#    message("        patch=${test_VERSION_PATCH}")
#    message("        stage=${test_VERSION_STAGE}")
#    message("        stage=${test_BRANCH}")

include(FindGit)

macro(fetch_version_from_git VARPREFIX)
    # set our defaults.
    set(${VARPREFIX}_VERSION_MAJOR 1)
    set(${VARPREFIX}_VERSION_MINOR 0)
    set(${VARPREFIX}_VERSION_PATCH 0)
    set(${VARPREFIX}_VERSION_STAGE "alpha-dev")

    find_package(Git)

    if (GIT_FOUND)
        # 获取git的提交号
        execute_process(
           COMMAND
                ${GIT_EXECUTABLE} rev-parse  HEAD
            WORKING_DIRECTORY
                ${PROJECT_SOURCE_DIR}
            RESULT_VARIABLE
                GITRET
            OUTPUT_VARIABLE
                ${VARPREFIX}_COMMITID
            OUTPUT_STRIP_TRAILING_WHITESPACE
        )

        if (NOT GITRET EQUAL 0)
            message(FATAL_ERROR "Failed to fetch current git commitid.")
        endif()

        # 获取git的分支名
        execute_process(
           COMMAND
                ${GIT_EXECUTABLE} rev-parse  --abbrev-ref HEAD
            WORKING_DIRECTORY
                ${PROJECT_SOURCE_DIR}
            RESULT_VARIABLE
                GITRET
            OUTPUT_VARIABLE
                ${VARPREFIX}_BRANCH
            OUTPUT_STRIP_TRAILING_WHITESPACE
        )

        if (NOT GITRET EQUAL 0)
            message(FATAL_ERROR "Failed to fetch current git branch name.")
        endif()

        # 通过git的tag获取工程的版本号
        execute_process(
            COMMAND
                ${GIT_EXECUTABLE} describe --abbrev=0 --always
            WORKING_DIRECTORY
                ${PROJECT_SOURCE_DIR}
            RESULT_VARIABLE
                GITRET
            OUTPUT_VARIABLE
                GITVERSION
            OUTPUT_STRIP_TRAILING_WHITESPACE
        )

        # 匹配(.、_、-)，并替换为;  即将字符串分割成字符串列表
        # 获取到的版本信息如：release-2.2.1-alpha, 总共5段
        string(REGEX REPLACE "[\\._-]" ";" VERSION_LIST "${GITVERSION}")
        if(VERSION_LIST)
            list(LENGTH VERSION_LIST VERSION_LIST_LENGTH)
        endif()

        if ((GITRET EQUAL 0) AND (VERSION_LIST_LENGTH EQUAL 5))
            list(GET VERSION_LIST 1 _MAJOR)
            list(GET VERSION_LIST 2 _MINOR)
            list(GET VERSION_LIST 3 _PATCH)
            list(GET VERSION_LIST 4 _STAGE)

            set(_DEFAULT_VERSION "${${VARPREFIX}_GIT___VERSION_MAJOR}.${${VARPREFIX}_GIT___VERSION_MINOR}.${${VARPREFIX}_GIT___VERSION_PATCH}-${${VARPREFIX}_GIT___VERSION_STAGE}")
            set(_GIT_VERSION     "${_MAJOR}.${_MINOR}.${_PATCH}-${_STAGE}")

            if (${_DEFAULT_VERSION} VERSION_LESS ${_GIT_VERSION})
                set(${VARPREFIX}_VERSION_MAJOR ${_MAJOR})
                set(${VARPREFIX}_VERSION_MINOR ${_MINOR})
                set(${VARPREFIX}_VERSION_PATCH ${_PATCH})
                set(${VARPREFIX}_VERSION_STAGE ${_STAGE})
            endif()
        endif()
    endif()
endmacro()

  ${VARPREFIX}_VERSION_MAJOR - Major version.
  ${VARPREFIX}_VERSION_MINOR - Minor version
  ${VARPREFIX}_VERSION_PATCH - Patch number
  ${VARPREFIX}_VERSION_STAGE - Stage version
  ${VARPREFIX}_COMMITID      - Git commitid
  ${VARPREFIX}_BRANCH        - Git branch

# This module defines the following variables to denote 
# new generated buildno
#
#  ${VARPREFIX}_BUILD_NUMBER  - New generated BuildNo
#
# If the build_number.txt file does not exist under 
# ${CMAKE_CURRENT_SOURCE_DIR} directory, a new build_number.txt 
# will be created and the build no will be set to 1, otherwise 
# the build no will increment one by one everytime cmake command 
# is executed.
#
# Example usage:
#
# new_build_number("test")
#    message("        buildno=${test_BUILD_NUMBER}")

macro(new_build_number VARPREFIX)
    if (EXISTS "${CMAKE_CURRENT_SOURCE_DIR}/build_number.txt")
        file(READ "${CMAKE_CURRENT_SOURCE_DIR}/build_number.txt" ${VARPREFIX}_BUILD_NUMBER)
        string(STRIP ${${VARPREFIX}_BUILD_NUMBER} BUILD_NUMBER)
    else()
        set(${VARPREFIX}_BUILD_NUMBER  1)
    endif()

    # 将 build number 加1
    math(EXPR NEW_BUILD_NUMBER "${${VARPREFIX}_BUILD_NUMBER} + 1")

    # 写入新的 build number 到文件
    file(WRITE "${CMAKE_CURRENT_SOURCE_DIR}/build_number.txt" "${NEW_BUILD_NUMBER}")

endmacro()