海外经销商说现场网络不稳定,希望研发先发一份“离线安装包”。这句话听起来很明确,很多团队的处理也很直接:从构建目录里找到 APK,改个文件名,发到邮件或聊天群。
文件当天能安装,事情似乎就结束了。但过几个月,经销商把同一个 APK 转给另一家维修企业;工业内窥镜已经换过硬件批次,配套 App 也更新了连接逻辑。新客户安装后无法识别设备,售后只能在群聊里继续寻找“更新一点的包”。
问题不在离线安装本身,而在于团队把“一个文件”误当成“完整交付”。
一个裸 APK,离开研发群就开始失真
APK 离开研发环境后,至少有五项背景会逐渐消失:它对应哪个产品型号、适配什么固件、在哪些 Android 版本验证过、由哪次正式构建产生,以及出现问题时应该回退到哪里。
文件名可以写版本号,却无法承载全部关系。经销商为了方便还可能再次改名,邮件附件和聊天记录也不会随官方版本更新。几轮转发以后,售后看到的只是一个“能安装的文件”,却不知道它是不是当前设备应该使用的文件。
离线交付不能只有 APK 文件
工业内窥镜常被维修企业、工厂或工程团队长期使用,同一客户可能同时保有多个硬件批次。“最新版”并不天然等于“最适合”,只发最新 APK 反而可能把兼容问题带到现场。
交付单上必须回答的五个问题
1. 安装包与校验信息
记录正式文件名、App 版本、构建时间和文件校验值。校验值用于确认文件在下载、复制和转发后是否保持完整,不能只凭文件大小判断。
2. 型号、固件与 App 的适配关系
明确安装包适用于哪些工业内窥镜型号和固件区间。如果一个 App 覆盖多款设备,也要标记不支持的旧批次或特殊项目版本。
3. 安装前提与使用边界
说明支持的 Android 系统范围、Bluetooth 或 Wi-Fi 连接方式、必要权限和安装步骤。所谓离线安装通常只是文件获取不依赖应用商店,并不代表设备首次连接、登录或后续功能全部无需网络。
4. 长期官方入口
离线包用于解决特定现场的即时安装,长期入口则负责承接以后版本。经销商可以临时保存安装包,但售后和新客户仍应回到厂商维护的统一来源。
5. 更新与回退办法
写清新版由谁通知、旧包何时停止使用,以及安装异常时可以回退到哪个稳定版本。没有回退信息的离线交付,只完成了安装,没有完成维护。
离线包解决当下,长期入口负责以后
这两种交付方式并不冲突。离线包服务于工厂、展会、企业内网或弱网现场;长期入口解决版本更新、用户换机和多年后的软件找回。
厂商可以把配套 App 托管在蒲公英开发者服务平台,用长期入口统一承接当前版本、历史版本和产品资料。海外经销商不必把群里的附件当作永久软件仓库,研发更新 App 后,也不需要逐个追回已经发出的旧文件。
离线安装包与长期入口的分工
蒲公英的版本管理与历史版本可用于保留可追溯安装包;下载页可以展示适配硬件、型号、连接方式、使用要求与兼容信息;全球 CDN 和多语言页面分别改善海外获取与阅读体验。具体型号、固件和 App 的对应关系,仍需要厂商自己准确维护。
如果研发已有稳定流水线,还可以通过 API/CI-CD 集成发布经过审批的新版本。自动化应发生在测试和审批之后,不能因为能够自动上传,就跳过兼容验证。
这张交付单可以直接照着做
我更建议把离线包放进一个有编号的交付单,而不是随手写一封邮件。交付单至少记录项目、产品型号、固件范围、App 版本、校验值、发布日期、安装前提、官方入口、回退版本和负责人。
经销商离线安装包交付单示意
渠道可以保存这张交付单用于现场操作,但不自行修改适配说明;研发维护版本来源和变更记录;售后根据型号与固件选择版本;品牌方则确保长期入口和账号不依赖某个员工。
发出文件前,让第二个人复核
- 这个 APK 是否来自已审核的正式构建?
- 是否写明适用型号、固件区间和 Android 要求?
- 是否提供校验值,便于确认文件完整性?
- 经销商是否同时拿到长期官方入口,而非只保存附件?
- 是否明确更新通知、停止使用和回退规则?
经销商最常追问的两个细节
问:经销商已经拿到离线包,为什么还需要长期入口?
因为离线包是某个时间点的版本快照,不会自动更新。长期入口负责让渠道和用户以后仍能找到厂商维护的版本与资料。
问:可以让经销商自己维护一个网盘吗?
可以作为现场缓存,但不应成为唯一官方来源。否则版本更新、权限交接和人员变动都会重新制造来源不明的问题。
经销商索要离线安装包,通常是在解决真实的现场限制。研发不必拒绝,但要把交付对象从“一个 APK”升级为“一个可核验、可适配、可更新、可回退的软件包”。
对工业内窥镜这类长期服役设备来说,文件能安装只是第一步。几年后渠道还能确认它从哪里来、适配什么设备、应该如何更新,才算真正完成软件交付。