在APP内测分发场景中，同时覆盖安卓用户和苹果用户是高频需求。传统的做法是分别生成两个下载链接、二维码，测试团队成员经常下错安装包，运营人员也要维护两套分发记录。
合并分发功能正是为了解决这个痛点：上传 APK 和 IPA 后，系统自动生成同一个二维码，用户扫码后，设备自动识别系统类型，跳转到对应的安装包下载地址。
什么是合并分发？
合并分发（又称"合并应用"）是将同一个 APP 的安卓安装包（APK）和苹果安装包（IPA）绑定，生成统一的分发入口的技术方案。用户无需判断自己该扫哪个码、点哪个链接，扫码后系统自动完成判断和下载。
这一功能在内测场景中尤为实用：
- 测试团队：成员设备混杂（安卓+iOS），一个二维码就能覆盖全部测试机。
- 产品演示：对外展示时，一份材料同时服务两类用户，体验更流畅。
- 版本对照：方便 QA 同时验证同一功能在双端的表现是否一致。
合并分发能力可在 虾分发控制台 直接使用，无需额外开发。
合并分发操作步骤
1. 准备安装包
在开始合并之前，请确保已准备好以下材料：
- 安卓安装包：
.apk文件 - 苹果安装包：
.ipa文件 - 两个安装包的版本号（Version）需保持一致
- 两个安装包的 Bundle ID（包名）需保持一致
- 苹果安装包需使用有效签名的证书/描述文件，否则用户安装时会报错
建议：上传前在 iOS 证书检测工具 中验证 IPA 文件的证书状态，确保签名有效再进行合并。
2. 上传安装包
- 登录 虾分发控制台，进入【我的应用】。
- 点击【上传安装包】，分别上传 APK 和 IPA 文件。
- 系统会自动解析安装包信息，提取版本号、Bundle ID、应用图标等数据。
3. 创建合并应用
- 在【应用列表】中找到已上传的 APK 和 IPA（它们应属于同一 APP）。
- 选中这两个安装包，点击【合并应用】按钮。
- 系统会自动校验版本号和 Bundle ID 是否匹配：
- 若版本号不一致，会提示"版本不匹配，请确认是否继续"，建议返回重新上传一致版本
- 若 Bundle ID 不一致，无法合并，需确认上传的安装包是否属于同一 APP
- 合并成功后，系统生成统一的分发链接和二维码。
4. 配置分发参数（可选）
合并完成后，可按需配置以下安全与展示参数：
- 下载密码：设置后，扫码用户需输入密码才能下载安装包
- 二维码样式：上传自定义 Logo、更换配色
- 下载次数限制：限制单个链接的总下载次数
- 有效期：设置二维码/链接的有效期（会员版支持永久有效二维码）
5. 测试验证
建议在正式分享前，使用安卓手机和苹果手机各扫码测试一次，确认：
- 安卓手机跳转至 APK 下载页面
- 苹果手机跳转至 itms-services 安装流程
- 两个端展示的应用名称、图标、版本号一致
常见问题
| 问题 | 解答 |
|---|---|
| 合并后苹果端安装报错"不受信任的开发者"？ | 首次安装 IPA 需在手机【设置 → 通用 → VPN与设备管理】中信任企业证书后，才能正常打开 APP。 |
| 安卓手机扫码后没有反应？ | 确认链接是通过 HTTPS 协议访问的；部分浏览器需手动点击"下载"按钮触发 APK 安装。 |
| 版本号不一致可以合并吗？ | 可以合并，但可能导致用户对版本对应关系产生困惑，建议保持一致以减少测试和沟通成本。 |
| 合并后可以单独更新其中一个安装包吗？ | 可以。进入应用详情页，选择对应端单独上传新版本即可，二维码和分发链接保持不变。 |
| 免费版二维码有有效期限制吗？ | 免费版二维码有一定有效期；会员版支持永久有效二维码，建议长期内测项目开通会员避免链接失效。 |
总结
合并分发是内测分发中的高频需求，通过一个二维码同时覆盖安卓和苹果用户，可以显著降低测试团队的安装出错率，也提升对外演示的专业感。操作上只需确保双端版本号和 Bundle ID 一致，即可在 虾分发平台 快速完成合并配置。
如果合并后扫码体验与预期不符，建议优先检查 IPA 证书状态和 HTTPS 部署情况，这两项是苹果端安装失败最常见的原因。