网站上的安卓客户端是一个持续更新的东西:内容跟着站点的文章和产品参数一起更新,安装包每次发布都要换一个新的构建号。版本号和构建号如果对不上,现场会出现两种很典型的状况:手机上装的是旧版本,页面上显示的是新版本;或者下载链接指向的安装包和页面标注的版本不是同一个。用户判断不了这两者的区别,只会认为下载的东西不对。

两个数字分别管什么

版本号是给人看的,格式是年加上月加上日,例如 2026.11.03,它告诉用户这个包是什么时候做的。构建号是给系统看的,每发布一次就加一,装在同一台手机上的新包靠它和旧包区分。页面正文、结构化数据和实际安装包上的数字,三处必须来自同一份版本文件,不能各写各的。

下载链接本身也要跟着版本走。页面上给出的地址是一个站内相对路径:/download/yanneng-oil-filter.apk,版本号作为查询参数跟在后面。用户复制这个地址发给别人、在手机浏览器里打开、在内网环境里访问,都应该拿到同一个文件。

车间里一台黄色机组全景,右侧放着一卷用白色编织袋包装的软管,旁边有戴黑色帽子的工人正在操作设备
手机上的客户端和现场手上的设备是同一套资料的两种呈现:内容更新了,版本号也要跟着更新

发布一次要同时更新哪几处

一次发布至少牵动三处:版本文件里的构建号与版本号、页面上的显示内容,以及页面里给出的下载地址。少改一处,页面上就会出现自相矛盾的信息。还有第四处:结构化数据里标注的安装包大小。安装包大小是实打实的字节数,页面上写的和实际文件对不上的时候,用户能直接感觉到。

需要保持一致的项对不上会出现什么怎么核对
页面显示的版本号与安装包内版本用户装完发现不是页面说的那一版安装后看应用信息里的版本号
构建号与下载地址里的参数浏览器或系统缓存住旧安装包核对链接末尾的构建号是否与版本文件一致
页面标注的安装包大小与实际文件下载进度与页面提示对不上用实际文件的字节数核对页面标注
下载地址的写法部分环境下链接打不开确认地址是站内相对路径
客户端内的离线内容与站点内容离线看到的文章是旧版本更新后重新打开一次离线包

更新这件事对用户意味着什么

  • 更新采用覆盖安装,不需要先卸载,用户的数据和设置不会因为升级而丢失。
  • 页面上的下载地址在任何浏览器里打开都是同一个文件,不需要区分电脑端和手机端。
  • 安装包把站点内容整站离线打包,离线状态下也能翻看设备参数和技术文章,代价是安装包本身比普通的在线应用大一些。
  • 发现问题的时候,直接报版本号和构建号,比描述页面显示不对要快得多。
  • 站点内容更新之后,客户端里的离线内容会在下次打开时同步一次。
版本号这东西平时没人看,一旦对不上,用户就不知道手里装的是哪一版。先把它对齐,问题就不会出现。