一、分发链路需要覆盖什么
把内测分发当成一个系统来看,它至少包含四个可独立设计的模块:
1. 上传与元信息解析
构建产物上传后,需要解析出应用名称、版本号、图标、Bundle ID / Package Name。
- Android:解析
AndroidManifest.xml - iOS:解析
Info.plist
这一步决定了后续下载页能否自动生成。如果靠人工填表,版本一多就容易出现信息错位。
2. 下载页与安装引导
Android 相对简单,提供 APK 直链即可。iOS 需要生成 .plist 清单文件,通过 itms-services:// 协议触发安装。
一个简化的 iOS 安装链接结构:
text
itms-services://?action=download-manifest&url=https://example.com/app.plist
.plist 中需要包含 IPA 下载地址、Bundle ID、版本号、图标地址等信息。这部分如果靠手工维护,很容易出现版本和 plist 不一致的情况。
3. 访问控制
内测包不是公开资源,访问控制至少要支持三种策略,并且能按项目独立配置:
- 密码保护:下载页验证密码后才展示下载入口
- 次数限制:总下载次数达到阈值后自动失效
- 有效期:到期自动下架
客户演示包和内部日常测试包,管控粒度完全不同,全局一刀切的策略不够用。
4. 版本管理与数据回传
历史版本需要可归档、可下架,避免测试人员装错包。下载量、访问量、设备信息等数据需要能回传,用于判断传播是否符合预期。一旦某个版本下载量异常,需要能第一时间发现并处置。
二、自建方案的成本结构
自建分发系统的吸引力在于“完全可控”。但实际成本主要不在开发,而在长期维护:
| 成本项 | 说明 |
|---|---|
| 服务器与带宽 | 下载速度直接影响测试体验,带宽是持续支出 |
| HTTPS 证书 | 到期续期,遗漏即全员无法下载 |
| iOS 签名管理 | 证书、描述文件、UDID 维护,掉签需紧急处理 |
| 安装页兼容性 | 不同 iOS 版本、不同厂商浏览器的行为差异 |
| 统计与告警 | 下载量监控、异常告警需要额外开发 |
| 安全加固 | 访问日志、防刷、限流 |
对于没有专门运维支持的中小团队,这些维护工作会持续侵占研发时间。这也是为什么很多团队明明有服务器,最后还是回到了手动传包。
三、接入第三方平台:以 API 驱动分发
如果希望把分发动作接入 CI,第三方平台需要具备可编程的接口能力。以 海哈游分发 为例,它提供了应用托管与分发能力,支持 APK/IPA 上传、访问控制和数据统计。具体接口形式以其官方文档为准,这里用伪代码示意接入思路。
1. 构建完成后自动上传
假设构建产物已经生成,在流水线末尾增加一个上传步骤:
bash
# 伪代码,具体参数以平台文档为准
curl -X POST "https://api.example.com/upload" \
-H "Authorization: Bearer $TOKEN" \
-F "file=@app-release.apk" \
-F "project_id=$PROJECT_ID"
上传成功后,接口通常会返回应用 ID、下载短链、二维码地址等信息。把这些信息写入构建日志或制品元数据,便于后续追溯。
2. 配置访问策略
上传后可以通过接口或控制台按项目设置:
- 下载密码
- 下载次数阈值
- 有效期
如果团队有多个测试渠道(内部、客户、外包),建议按项目隔离,避免包串用。海哈游分发的控制台支持独立项目管理,这一点在同时维护多个 App 时比较实用。
3. 数据回传与监控
部分平台提供下载数据查询接口,可以定时拉取并写入内部监控系统。例如:
bash
# 伪代码:查询某应用下载量
curl "https://api.example.com/apps/$APP_ID/stats" \
-H "Authorization: Bearer $TOKEN"
返回数据可以用于判断传播是否符合预期,或在下载量异常时触发告警。
4. iOS 签名管理的边界
需要明确一点:分发平台解决的是“送达与控制”,不解决签名本身的有效性问题。 IPA 能否安装,首先取决于签名方式是否覆盖测试设备 UDID,或者证书是否被系统信任。海哈游分发提供了企业签名、超级签名、TF 签名等多种方式的管理入口,但签名本身的约束依然存在。接入前需要把“签名”和“分发”这两层分开评估。
四、流水线集成示意
以下是一个简化的 GitHub Actions 片段,展示分发步骤在流水线中的位置:
yaml
name: Build and Distribute
on:
push:
branches: [ develop ]
jobs:
build:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- name: Build APK
run: ./gradlew assembleRelease
- name: Upload to Distribution Platform
run: |
curl -X POST "$UPLOAD_URL" \
-H "Authorization: Bearer ${{ secrets.DIST_TOKEN }}" \
-F "file=@app/build/outputs/apk/release/app-release.apk" \
-F "project_id=${{ vars.PROJECT_ID }}"
实际接入时,需要根据平台文档调整参数和鉴权方式。如果平台提供 CLI 工具,也可以封装成脚本,减少流水线配置的复杂度。
五、实践中的几个注意点
1. 版本号以平台记录为准
接入自动化后,建议把平台返回的版本信息写入构建日志或制品库。测试反馈问题时,以平台记录为准,而不是靠群文件命名来辨认。
2. 密码策略
避免使用简单数字,建议“内测+日期”或随机字符串,并定期更换。密码和下载次数限制配合使用,控制效果更好。
3. 旧版本及时下架
测试结束后及时下架旧版本,减少装错包和泄露风险。历史版本保留归档,便于问题回溯。
4. Android 安装引导前置
不同厂商手机的“未知来源应用”设置路径不同。把引导说明放在下载页上,比在群里反复回答更省事。
六、适用边界
这套方案有明确的适用范围:
- 适合:独立开发者或中小团队,内测频率高于每周一次,测试者包含非技术人员,对分发范围有基本管控需求,且希望把分发动作接入现有流水线。
- 需要额外评估:海外测试者占比较高时,下载速度需要实测;iOS 依赖企业签名时,掉签风险由签名方式本身决定;对数据驻留有要求的团队,需要确认平台的数据存放策略。
- 不一定适合:一个月只发一次包、测试者全部是能自己处理 plist 的工程师,手动传包的时间成本可能确实低于接入新工具的学习成本。
七、总结
内测分发值得被当成一个工程问题来处理。它的优化收益不在代码层面,而在每个迭代周期里被反复切碎的专注时间。把传输、安装引导、版本追溯、访问控制收敛到一个可配置的链路里,减少的是隐性摩擦,留下的是可复现的发布节奏。
海哈游分发是这个方向上的一个可选项,可通过搜索“海哈游分发”了解其具体能力与接口文档。本文基于公开信息与流程实践整理,具体功能、限制及收费以官网说明为准。