周五下午六点,v2.3.1 打包完成,你要把它发给 20 个测试同学:Android 的用微信传 APK,iOS 的拉进 TestFlight。第二天收到的反馈却很一致——三个人说"文件已损坏",两个人说"打不开",还有一个装完之后发现还是上个版本。
包本身大概率没问题,卡住的是"从构建产物到用户设备"这一段链路。这段链路不长,但每一步都有坑。下面按顺序拆开讲。
一、先把三个概念分开
很多人把内测分发等同于"发文件",其实中间还有一层:
- 安装包:Android 是 APK,iOS 是 IPA。它们都带包名(bundle id / package name)、版本号、签名,这三样决定了"能不能装、会不会覆盖旧版"。
- 分发页:一个固定短链 + 一张二维码,落地页上展示版本信息并给出下载按钮。对外的传播,只需要这一个东西。
- 安装方式:Android 走"未知来源安装",iOS 走描述文件、TestFlight 或企业签名,路径完全不同。
把这三层混在一起,就会出现"我明明发了包,他说没收到"这类对不上的沟通。
二、Android 侧:四个高频卡点
- 未知来源权限。Android 8 以后是"按应用授权",用户点了安装但没给浏览器/文件管理器"安装未知应用"权限,表现就是点了没反应。
- 架构不匹配。只打了 x86 模拟器包发给真机,或者只保留 armeabi-v7a 却在 arm64 设备上跑,轻则闪退重则装不上。发内测包时建议至少包含 arm64-v8a。
- versionCode 没变。改了版本名(2.3.1)但没改 versionCode,系统认为"同版本",直接拒绝覆盖安装。这是"装完还是旧版本"最常见的原因。
- 厂商安全拦截。部分厂商 ROM 会对非应用商店来源的包做二次校验,弹窗文案各家不同,测试同学往往描述成"装不了"。
三、iOS 侧:IPA 不能双击安装
iOS 的安装约束比 Android 严格得多,IPA 必须先签名并配合描述文件才能落到设备上:
- Ad Hoc:需要提前把测试设备的 UDID 加进描述文件,设备换了就得重新打包。
- 企业签名:受 Apple 开发者协议约束,证书被吊销后已安装的应用会直接闪退。这类风险要提前和测试方说清楚。
- TestFlight:体验最接近正式版,但有审核与有效期,内测节奏紧的时候不一定等得起。
装完提示"不受信任的开发者",是设备还没信任证书,去「设置 → 通用 → VPN 与设备管理」里手动信任即可;打开就闪退,则多半是签名失效、描述文件过期或设备不在授权列表里。这里要强调一句:签名方案请严格遵守 Apple 的开发者协议,证书一旦被滥用而吊销,损失最大的恰恰是已经装上的用户。
四、下载页上该放什么
一个合格的内测下载页,信息量其实不大,但缺一项就会多一轮沟通:
- 包名、文件大小、版本号、更新时间
- 安装说明(尤其是 iOS 的信任步骤)
- 备案信息(对外分发时属于合规要求)
- 下载按钮与二维码
用短链而不是直链,理由很实际:换包不用换链接、可以带渠道参数、直链不会被随意转发。短链的另一个好处是"发一次,长期有效",省掉了每次发版重新通知的成本。
五、五类失败原因的对照表
| 现象 | 大概率原因 | 处理方式 |
|---|---|---|
| 提示"文件已损坏" | 传输过程被压缩/改名,或下载未完成 | 重新下载,核对文件大小 |
| "解析包时出现问题" | 不是真实 APK,或只改了后缀 | 用构建产物原文件重新上传 |
| "不受信任的开发者" | iOS 证书未信任 | 设置中手动信任描述文件 |
| 打开即闪退 | 签名失效、描述文件过期、架构不符 | 重新签名并核对设备列表 |
| 装完仍是旧版本 | versionCode 未递增 | 递增 versionCode 后重新打包 |
六、把链路固化成流程
排查过几轮之后,团队通常会沉淀出一套固定动作:每次发包先递增 versionCode,再核对下载页上的版本号与更新时间,短链保持不变,投放时给不同人群带不同渠道参数。这样"谁在测哪个版本"是可追溯的,而不是靠聊天记录回忆。
海哈游分发的「应用组」就是按这条链路设计的:一个应用组同时挂 Android 与 iOS 两个包,短码固定不变,下载页按访问设备自动展示对应平台。链路清楚了,分发就从玄学变成了可排查的工程问题。