当前位置:首页 > 谈天说地

linphone-sdk-android版本号生成解析

34资源网2022-09-19473

前言

好久没写 linphone-sdk-android 相关的文章了,本文记录下笔者分析 linphone-sdk 版本号生成的过程。

分析

注:以下源码基于 linphone-sdk-android 4.5.26。

修改完 linphone-sdk 的源码后总是要编译的,编译完成后我们就可以得到一个带有版本号的 aar 包,那么这个版本号是从哪里来的呢?

编译产物

首先看下编译完成后 build 目录下的产物,会发现有两个 gradle 脚本文件:build.gradle 和 upload.gradle,打开 upload.gradle 脚本文件,在里面发现如下代码:println("aar artefact group is: " + artefactgroupid + ", sdk version 4.5.27"),其中 4.5.27 就是 linphone-sdk 的版本号。

根据前面文章的分析,编译产物一般是自动生成的,所以笔者在 linphone-sdk 目录下搜索 upload.gradle :find . -name '*upload.gradle*':

 ./cmake/android/gradle/upload.gradle.cmake
 ./build/upload.gradle

果然找到了,其中第2行是笔者刚才打开的文件,找到并打开第1行的文件 upload.gradle.cmake,与第2行的文件对比,发现前者就是后者的模板文件,在 upload.gradle.cmake 文件中发现:println("aar artefact group is: " + artefactgroupid + ", sdk version @linphonesdk_version@"),其中 @linphonesdk_version@ 就是 linphone-sdk 的版本号了。因为此文件后缀是 .cmake,那么联想 @linphonesdk_version@ 应该是个 cmake 参数。

接下来在 linphone-sdk 目录下搜索包含 linphonesdk_version 字样的文件:find . -type f | xargs grep 'linphonesdk_version',本次查找结果较多,就不贴出来了,经过笔者的对比分析,锁定了最后一行结果:./cmakelists.txt:bc_compute_full_version(linphonesdk_version)。

cmake

打开 ./cmakelists.txt,在前几行就可以找到如下代码:

 include(bctoolbox/cmake/bctoolboxcmakeutils.cmake)
 bc_compute_full_version(linphonesdk_version)

其中第2行代码 bc_compute_full_version 就是计算 linphone-sdk 版本号的函数,其定义在第1行代码中的 bctoolboxcmakeutils.cmake 中,打开 bctoolboxcmakeutils.cmake 文件并找到 bc_compute_full_version 函数:

 function(bc_compute_full_version output_version)
     # 查找 git 程序
     find_program(git_executable git names git cmake_find_root_path_both)
     # 如果找到 git 程序
     if(git_executable)
         # 执行 git describe 命令
         execute_process(
             command "${git_executable}" "describe"
             output_variable git_describe_version
             output_strip_trailing_whitespace
             error_quiet
             working_directory "${cmake_current_source_dir}"
         )
         # parse git describe version
         # 解析 git describe 的返回值作为版本号, 通过正则表达式的分组匹配进行解析:4.5.26-alpha-9-gb342a93
         # 如果没有解析到, 输出错误信息
         if (not (git_describe_version matches "^([0-9]+)[.]([0-9]+)[.]([0-9]+)(-alpha|-beta)?(-[0-9]+)?(-g[0-9a-f]+)?$"))
             message(fatal_error "invalid git describe version: '${git_describe_version}'")
         endif()
         # 设置分组1为主要版本: ([0-9]+) -> 4
         set(version_major ${cmake_match_1})
         # 设置分组2为次要版本: ([0-9]+) -> 5
         set(version_minor ${cmake_match_2})
         # 设置分组3为补丁版本: ([0-9]+) -> 26
         set(version_patch ${cmake_match_3})
         # 如果解析到分组4: (-alpha|-beta)? -> -alpha, 则去掉前面的‘-', 得到后面的‘alpha|beta', 赋值给 version_prerelease
         if (cmake_match_4)
             string(substring "${cmake_match_4}" 1 -1 version_prerelease)
         endif()
         # 如果解析到分组5:(-[0-9]+)? -> -9, 则去掉前面的‘-', 得到后面的‘9', 赋值给 version_commit
         if (cmake_match_5)
             string(substring "${cmake_match_5}" 1 -1 version_commit)
         endif()
         # 如果解析到分组6: (-g[0-9a-f]+)? -> -gb342a93, 则去掉前面的‘-g', 得到后面的‘b342a93', 赋值给 version_hash
         if (cmake_match_6)
             string(substring "${cmake_match_6}" 2 -1 version_hash)
         endif()
         # interpret untagged hotfixes as pre-releases of the next "patch" release
         # 如果没有 version_prerelease, 但是有 version_commit, 认为是此补丁程序是下一个补丁版本的预发版本, 即将补丁版本号+1
         # 并设置 version_prerelease 为 "pre"
         if (not version_prerelease and version_commit)
             math(expr version_patch "${version_patch} + 1")
             set(version_prerelease "pre")
         endif()
         # format full version
         # 拼接主、次、补丁版本号
         set(full_version "${version_major}.${version_minor}.${version_patch}")
         # 如果有 version_prerelease
         if (version_prerelease)
             # 版本号追加 "-pre"
             string(append full_version "-${version_prerelease}")
             # 如果有 version_commit
             if (version_commit)
                 # 版本号追加 ".9+b342a93"
                 string(append full_version ".${version_commit}+${version_hash}")
             endif()
         endif()
         # 省略其他检查逻辑
         # 设置版本号为cmake缓存参数, 完整版本号: 4.5.27-pre.9+b342a93
         set(${output_version} "${full_version}" cache string "" force)
     endif()
 endfunction()

下面就是分析 bc_compute_full_version 函数了。

首先查找 git 程序,如果找到 git 程序,函数才会继续,否则无法计算版本号。

找到 git 程序后会执行 git describe 命令,此命令会基于当前可用的 ref 给一个人类可读的名称。

  • 如果当前最新的 commit 上有 tag,且 tag 必须有描述信息或者带有 -- tags 参数,此命令则返回此 tag 名称:4.5.26,
  • 否则返回离当前最近的 tag 名称 + 此 tag 之后的提交次数 + 当前的 commit hash 值前 7 位:4.5.26-9-gb342a93,其中 'g' 表示是 git,

具体可查看 git-describe。

假设 git describe 命令返回的是:4.5.26-alpha-9-gb342a93,接下来通过正则表达式的分组匹配解析返回的结果。

正则表达式:

^([0-9]+)[.]([0-9]+)[.]([0-9]+)(-alpha|-beta)?(-[0-9]+)?(-g[0-9a-f]+)?$,

其分为以下 6 组:

  • ([0-9]+) 为第一组 cmake_match_1,对应 4,
  • ([0-9]+) 为第二组 cmake_match_2,对应 5,
  • ([0-9]+) 为第三组 cmake_match_3,对应 26,
  • (-alpha|-beta)? 为第四组 cmake_match_4,可为空,对应 -alpha,
  • (-[0-9]+)? 为第五组 cmake_match_5,可为空,对应 -9,
  • (-g[0-9a-f]+)? 为第六组 cmake_match_6,可为空,对应 gb342a93,

分组一、分组二和分组三分别作为主要版本、次要版本和补丁版本:4.5.26。

如果解析到分组四: -alpha,则去掉前面的 -,得到后面的 alpha,并赋值给 version_prerelease 变量;如果解析到分组五: -9,则去掉前面的 -,得到后面的 9,并赋值给 version_commit 变量;如果解析到分组六: -gb342a93,则去掉前面的 -g,得到后面的 b342a93,并赋值给 version_hash 变量。

如果没有 version_prerelease 变量,但是有 version_commit 变量,则认为此补丁程序是下一个补丁版本的预发布版本,即将补丁版本号增加一个版本并赋值version_prerelease 变量为 pre。

拼接主要版本、次要版本和补丁版本为:4.5.27,并赋值给 full_version 变量。

如果有 version_prerelease 变量,则 full_version 变量追加 -pre,此时版本号为:4.5.27-pre;如果有 version_commit 变量,则版本号再追加 version_commit 和 version_hash 变量的值 .9+b342a93,得到版本号:4.5.27-pre.9+b342a93。

最终得到 linphone-sdk 的版本号:4.5.27-pre.9+b342a93。

总结

本文记录了笔者查找 linphone-sdk 生成版本号的过程,同时分析了版本号的生成逻辑,linphone-sdk 通过获取 git 提交记录和 tag 来生成版本号:

  • 执行 git describe 命令获取可读 git 提交信息,
  • 通过正则表达式的分组配置模式解析得到的 git 提交信息,
  • 最后根据分组信息修正并拼接得到完整的版本号。

利用 git 提交信息来生成版本号这种方式,我们在写 sdk 时或许可以借鉴下。

以上就是linphone-sdk-android版本号生成解析的详细内容,更多关于linphone sdk android 版本号的资料请关注萬仟网其它相关文章!

版权声明:34楼发布

本文链接:https://www.34l.com/post/22278.html

分享给朋友:

相关文章

天上的孩子电影好看吗?看豆瓣网友如何评价的吧

天上的孩子电影好看吗?看豆瓣网友如何评价的吧

由胡玫监制许磊导演编剧的电影《天上的孩子》。电影主要讲述了来自贵州的夫妻老何、玲霞5岁的独子查出绝症,不久于人世。为了让儿子的名字刻在纪念碑上,夫妻俩决定捐献儿子的器官却困难重重。…

分享30句用被刺造句的句子

分享30句用被刺造句的句子

1、黄昏已经谢去,夜幕早已铺开。高高的法国梧桐,被刺眼的白色路灯照亮。在黑色的夜空里镶了一圈又一圈攫绿,有时被拂过的夜风飘动,发出轻轻的沙沙声,只那么一阵,就消失在无限的宁静之中。…

电脑微信可以发多大的视频(视频超过40分钟发送步骤)

电脑微信可以发多大的视频(视频超过40分钟发送步骤)

虽然腾讯在短视频领域迟迟未能取得优势,微视也很难撼动抖音、快手等头部APP的地位,但一直以来都未放弃这块蛋糕。 2021年二季度,随着微信以及Wechat活跃用户账户达到12.5亿,微信视频号的成长空间也被进一步拉大。而腾讯也很可能在短视频…

小型电冰箱什么牌子好?现在口碑最好的冰箱推荐

小型电冰箱什么牌子好?现在口碑最好的冰箱推荐

海尔冰箱全球公认的质量很不错的冰箱,海尔冰箱优点是:微霜,制冷效果不错;节能省电,保湿效果不错;海尔冰箱是十大品牌之首,全球销量的第一梯队的佼佼者。海尔冰箱外观十分好看,海尔冰箱款式几乎都很新颖,质量好,制冷情况好,用了一段时间,制冷情况稳…

裁员,爱奇艺穿越生死线

裁员,爱奇艺穿越生死线

图源:摄图网 编者按:本文来自微信公众号霞光社(ID:Globalinsights)),作者:麻吉、郭照川、韩夏,创业邦经授权转载 霞光社从多位爱奇艺员工处了解到,本轮裁员罕见覆盖了爱奇艺所有部门,从影业、IP、游戏、电商部门,甚至到经纪公…