标签 Windows 下的文章

一场关于“何时发布版本”的论战

气氛太平静,投石起波澜。

昨天下午无意中在内部发起了一场关于"何时发布版本"的论战。
 
论战的背景是这样的:部门内部有这样的一个项目A,它的目标是开发出可被其他项目或产品复用的组件(这里就暂称之为组件吧,我们内部称这类组件为可复用资产)。这个项目已经开发了大半年了,目前处于收尾阶段,绝大部分开发工作已经完成。测试(包括压力测试等)已经测试过至少一轮了;我们的产品线近期准备复用项目A成产出的这些组件,我们希望得到这些组件的某个发布版本。
 
论战的导火索是我就这件事情回复的一封mail。mail的大致意思是希望项目A能采用可复用资产的方式对组件进行发布管理,尽早在内部公开发布组件版本,以利于其他计划或正在复用这些组件的项目能够尽早的集成,发现问题,反馈意见和建议。
 
项目A负责人就我的建议回复的mail拉开了这场论战的大幕,其mail的大致内容是:"在项目A结项前,相关成果物暂不发布,不通过组织内部可复用资产的方式进行管理"。在接下来的mail中他阐述了几点理由:
 
(1) 项目A开发工作尚未完全结束,代码每天依旧在修改,手册、测试均未完成;
(2) 项目组人员有限,发布牵扯到开发人员的工作量,无法集中精力于开发工作;
(3) 欲复用这些组件的开发组可以从项目A的配置人员那里获取代码,配置人员发布的版本都是经过基本功能测试的,而且API接口部分已经基本稳定,可以进行研发。等项目完全结束后会加入到部门可复用资产库中的。
 
如果是按照传统项目的管理方式,以上理由可能无可厚非,但恰恰项目A所生产的组件并非传统项目的成果物类型,所以我针对上面的理由做了进一步的回复,大致意思如下:
 
(1) 就因为组件开发尚未完全结束,才应该制定阶段发布计划,不能等到最后再发布,否则一旦存在与其他项目的集成问题,修改起来就更加费力,而且还可能导致各个项目延期;另外提早内部公开发布阶段性版本才可以"扩大"组件的使用和测试范围,去"Eating your own dog food",有利于尽早更多地发现问题;
(2) 产品发布就是开发过程的一部分,不要割裂开来;
(3) 显然项目A是有自己的版本管理的,但没有在显式的位置公开发布版本信息,这些版本对外均不可知;而且在没有外部监督的前提下,内部版本管理可能较为随意,可能后续不便于外部项目对组件问题的跟踪与管理。
(4) 由于组件的需求和设计阶段已经结束,我的建议主要针对组件实现以及之后的生命周期。
 
显然项目组A负责人认为项目过程中的评审比尽早发布版本后收到的反馈更为重要,于是他发出了下面Mail:“需求阶段和设计阶段的评审更重要,实现阶段和测试阶段会举行例如手册、测试方案的评审,代码评审叫你们,你们有时间参加不?”。
 
有些火药味儿了^_^。我的回答是:"我真不知道什么样的好产品是内部坐着评审出来的,哪个好产品不是在使用后反复修改出来的。如果评审能缔造好产品,那大家就都评审好了! "。
 
随后我又举了一个形象的例子,拿一个场景说明提前内部公开发布的必要性。
 
以微软为例,两个部门:Windows开发部门(以下简称Win)和visual studio开发部门(以下简称VS)。Wins部门正在开发WIN8,与此同时VS部门正在开发visual studio 11。下面有两种场景:
 
第一种:WIN部门在需求、设计阶段召开了大量会议,也采纳了VS部门的建议,但就是后期迟迟不发布版本。而VS部门急着要与最新的WIN8版本集成,看是否会有集成问题。WIN部门的回复是:等吧,2012年10月WIN8发布时,你们就可以测试了。VS部门也要在10月份发布VS11,无奈VS部门只能暗中找到WIN部门的人偷偷搞到一个WIN8的beta版(例如,build 2012),然后赶紧做集成。结果发现了大量不兼容问题。VS部门感叹:多亏提前做了,否则10月份又要被Steve Ballmer甩椅子了。
 
第二种:WIN部门在需求、设计阶段召开了大量会议,也采纳了VS部门的建议,并且WIN部门在开发阶段就定期发布alpha1~alpha10版本,供其他各个部门的新产品集成,及时收集问题反馈,及时修正问题。10月份时,WIN8和VS11都高质量顺利上线。
 
大家觉得哪种更好些呢?
 
我举的例子也有些激进(特别是场景1),这下彻底激怒了那位兄弟。其回复说:"有很多问题,很多bug的版本也可以发布?不稳定的版本发布了有何用?谁会用?"。我的回答是"Windows每个alpha版本发布后仍然可能有数千个bug。但它也要内部发布,注意是内部发布,为的是更早的与其他应用集成,发现问题"。
 
论战到这里,我觉得我的意思基本上算是表达清楚了,于是终止了这略有火药味儿的讨论。
 
我们的组织内部很少有这种带有火药味儿的激烈争论,但我个人觉得在对团队团结无损害的前提下,这类争论应该多多益善,这样才能产生思维碰撞,产生火花,促进思考,推动改进。
 
部门经过十几年的发展,固化下来一些目前来看并不合理的惯例,很多人(甚至也包括我自己)的思路尚停留在老路上。所以我经常用下面两句话来督促自己,让自己始终保持OPEN的心态:
 
(1)、忠言逆耳利於行;
(2)、向前迈出一步总比原地踏步强。也许迈出这一步后,摆在你面前的是另一番别有洞天的景色。

使用autoconf解决可移植性问题

昨天在编译项目代码时遇到了这样一个错误:

xx_base.h:72:2: 错误:#error "One of _BIG_ENDIAN or _LITTLE_ENDIAN must be defined."

这是预编译器的错误输出。原因很明显:预编译器在处理xx_base.h时没有发现_BIG_ENDIAN或_LITTLE_ENDIAN的定义,#error预处理宏输出了如上错误。下面是出现错误位置的源码片断:

/* xx_base.h*/
#if defined(_BIG_ENDIAN)
… …
#elif defined(_LITTLE_ENDIAN)
… …
#else
#error "One of _BIG_ENDIAN or _LITTLE_ENDIAN must be defined."
#endif

xx_base.h是部门一基础库中的一个头文件,上面的做法对于基础库自身来说并无太大问题。基础库的Makefile通过检测CPU类型定义了对应的字节序宏,并在编译时作为gcc的命令行选项传入:

/* Makefile */
ifeq ($(CPU), x86)
        DEFS += -D_LITTLE_ENDIAN
else ifeq ($(CPU), sparc)
        DEFS += -D_BIG_ENDIAN
else
        $(error $(CPU) is not supported!)
endif

但是一旦这个基础库被某项目复用,且该xx_base.h文件被项目代码引用,编译就会出现问题,因为各个项目的Makefile中并没有定义_LITTLE_ENDIAN或_BIG_ENDIAN宏。如果基础库不做修改,那么复用该基础库的项目代码中就都需要考虑这两个宏的定义问题。这未免有些"强加"的意味,对于一个几乎被所有项目复用的基础库而言,这样的做法显然不妥。

那如何解决这个问题呢?一个思路是如果基础库在发布后依旧携带这些宏的定义,那就可以避免这样的问题了。在很多使用autotools(包括autoconf, automake, libtool等)协助进行代码构建的开源包中经常会看到一个名为config.h的源文件,那里面包含了与移植相关的宏定义。这个config.h是configure脚本根据config.h.in模板自动生成的。

我们的基础库如果完全用autotools改造显然也可以解决这个问题,但这样一来以前编写的一些构建脚本就要被全部抛弃,能否折中一下呢:利用autoconf生成config.h,但不输出Makefile,依旧使用原先的Makefile?

实验证明这样是可以的。只需对configure.in(或configure.ac)做一些调整即可,将类似AC_CONFIG_FILES([Makefile src/Makefile src/example/Makefile])这样的代码从configure.in中移除即可:

#                                               -*- Autoconf -*-
# Process this file with autoconf to produce a configure script.

AC_PREREQ([2.64])
AC_INIT([baselib], [1.0.0], [xx@gmail.com])

AC_CONFIG_HEADERS([include/config.h])

# Checks for header files.
AC_CHECK_HEADERS([stddef.h stdlib.h string.h])

# Checks for typedefs, structures, and compiler characteristics.
AC_TYPE_SIZE_T

# Checks for library functions.
AC_FUNC_MALLOC
AC_CHECK_FUNCS([memset])

AC_OUTPUT

AC_CONFIG_HEADERS这句是关键!修改完configure.in后,执行autoheader,我们就会在include下发现config.h.in模板文件被生成了出来。执行autoconf生成的configure脚本后,我们在include下就得到了config.h。

下面就是在config.h中加入我们期望的宏。在我们的问题中,我们希望在configure时可以探测到当前host所用的字节序(endianess),并将结果反映到config.h中。幸运的是autoconf内置了字节序的测试宏AC_C_BIGENDIAN。增加了AC_C_BIGENDIAN测试宏的configure.in经过autoheader处理后得到的config.h.in文件中多了如下这组代码:

/* Define WORDS_BIGENDIAN to 1 if your processor stores words with the most
   significant byte first (like Motorola and SPARC, unlike Intel). */
#if defined AC_APPLE_UNIVERSAL_BUILD
# if defined __BIG_ENDIAN__
#  define WORDS_BIGENDIAN 1
# endif
#else
# ifndef WORDS_BIGENDIAN
#  undef WORDS_BIGENDIAN
# endif
#endif

在Sun SPARC小机上运行configure,我们得到的config.h中有关字节序的宏定义代码如下:
/* Define WORDS_BIGENDIAN to 1 if your processor stores words with the most
   significant byte first (like Motorola and SPARC, unlike Intel). */
#if defined AC_APPLE_UNIVERSAL_BUILD
# if defined __BIG_ENDIAN__
#  define WORDS_BIGENDIAN 1
# endif
#else
# ifndef WORDS_BIGENDIAN
#  define WORDS_BIGENDIAN 1
# endif
#endif

config.h中定义了WORDS_BIGENDIAN宏,说明Sun Sparc小机采用的是BigEndian。这样只要基础库的头文件都在最开始包含了config.h,那么上面的问题就解决了。

不过有些朋友不喜欢WORDS_BIGENDIAN这个宏的命名,想自己给标识字节序的宏命名,比如BASELIB_IS_BIGENDIAN。那么我们如何来支持呢?这里我也找到了一个办法:

首先,就是手工编辑config.h.in(注意这之后你就不要通过autoheader生成config.h.in了),在结尾加上这样一行:
#undef BASELIB_IS_BIGENDIAN

然后,修改configure.in,通过AC_DEFINE来定义一个新的BASELIB_IS_BIGENDIAN宏:

AC_C_BIGENDIAN
if test $ac_cv_c_bigendian = yes; then
    AC_DEFINE(BASELIB_IS_BIGENDIAN, 1)
fi

我们通过AC_C_BIGENDIAN的检测结果来确定是否定义BASELIB_IS_BIGENDIAN宏,ac_cv_c_bigendian显然是AC_C_BIGENDIAN内置的一个变量,如果需要,我们也可以模仿其命名规则得到其他测试宏内置的变量。

最后,执行autoconf和configure,我们就可以在include/config.h的结尾看到这样一行定义:
#define BASELIB_IS_BIGENDIAN 1

AC_DEFINE不一定非要与测试宏绑定在一起,它的用法很灵活。如果我们的代码中需要根据不同操作系统的类型来调用不同的代码,那么我们需要在config.h中放置几个标识操作系统类型的宏,比如BASELIB_LINUX和BASELIB_SUNOS。和BASELIB_IS_BIGENDIAN一样,我们首先需要手工编辑config.h.in,增加如下两行代码:

#undef BASELIB_LINUX
#undef BASELIB_SUNOS

然后,修改configure.in,加入自定义的OS测试代码,并且定义对应的宏:

os=`uname -s`
case $os in
    Linux)
        AC_DEFINE(BASELIB_LINUX, 1)
        ;;
    SunOS)
        AC_DEFINE(BASELIB_SUNOS, 1)
        ;;
    *)
        AC_ERROR([host is unsupported.])
        ;;
esac

最后,执行autoconf和configure。如果我们在redhat上,我们就会在config.h中看到如下代码:

#define BASELIB_LINUX 1
/* #undef BASELIB_SUNOS */

autoconf也内置了一系列系统类型测试宏,比如AC_CANONICAL_SYSTEM(依赖install-sh、config.sub和config.guess三个脚本),其测试后的结果放在了$host变量中,你也可以通过判断$host变量来确定到底在config.h中定义哪个宏。

如发现本站页面被黑,比如:挂载广告、挖矿等恶意代码,请朋友们及时联系我。十分感谢! Go语言第一课 Go语言精进之路1 Go语言精进之路2 Go语言编程指南
商务合作请联系bigwhite.cn AT aliyun.com

欢迎使用邮件订阅我的博客

输入邮箱订阅本站,只要有新文章发布,就会第一时间发送邮件通知你哦!

这里是 Tony Bai的个人Blog,欢迎访问、订阅和留言! 订阅Feed请点击上面图片

如果您觉得这里的文章对您有帮助,请扫描上方二维码进行捐赠 ,加油后的Tony Bai将会为您呈现更多精彩的文章,谢谢!

如果您希望通过微信捐赠,请用微信客户端扫描下方赞赏码:

如果您希望通过比特币或以太币捐赠,可以扫描下方二维码:

比特币:

以太币:

如果您喜欢通过微信浏览本站内容,可以扫描下方二维码,订阅本站官方微信订阅号“iamtonybai”;点击二维码,可直达本人官方微博主页^_^:
本站Powered by Digital Ocean VPS。
选择Digital Ocean VPS主机,即可获得10美元现金充值,可 免费使用两个月哟! 著名主机提供商Linode 10$优惠码:linode10,在 这里注册即可免费获 得。阿里云推荐码: 1WFZ0V立享9折!


View Tony Bai's profile on LinkedIn
DigitalOcean Referral Badge

文章

评论

  • 正在加载...

分类

标签

归档



View My Stats