DEVELOPER DOCUMENTATION
一次清晰交付,衔接跨平台渠道发行
游戏方完成 Android / iOS / H5 SDK 集成后,将母包和发行资料交付平台云端分包引擎处理。
交付资料
| 资料 | 要求 |
|---|---|
| 游戏母包 | 已接入 SDK 的 Android (.apk)、iOS (.ipa) 或 H5/小游戏 (.zip) 母包,附文件 SHA-256。 |
| 版本资料 | 包名/BundleID、versionCode、versionName、最低系统版本和更新说明。 |
| 签名资料 | 证书指纹、既有发行版本的签名兼容要求与签名授权说明。 |
| 渠道需求 | 游戏 ID、渠道列表、渠道自定义 JSON 配置、应用名称、图标及包名需求。 |
| 接入节点 | 登录、实名认证、收银台、活跃、角色创建和等级变化的调用位置与操作步骤。 |
| 验收资料 | 验收账号、区服、目标设备及角色操作路径。 |
云端分包引擎跨平台注入规范 (pack-worker)
| 母包格式 | 写入渠道标识路径 | 写入渠道配置路径 | 支持的元数据修改 |
|---|---|---|---|
Android (.apk) | assets/qufutong/channel_id.txt | assets/qufutong/channel_config.json | AndroidManifest.xml 包名、应用名、版本号及应用图标替换,apksigner V1/V2 签名验签 |
iOS (.ipa) | Payload/*.app/qufutong/channel_id.txtQufutong/ChannelID/{channel}/channel_id.txt | Payload/*.app/qufutong/channel_config.jsonQufutong/ChannelID/{channel}/channel_config.json | Payload/*.app/Info.plist 的 CFBundleIdentifier、CFBundleShortVersionString、CFBundleDisplayName |
H5 / 小游戏 (.zip) | qufutong/channel_id.txt | qufutong/channel_config.jsonqufutong/channel_env.js | manifest.json / game.json / package.json 的 package_name / appid / name / version |
交付与分包流程
- 研发交付 APK / IPA / H5 ZIP 母包和版本资料。
- 运营上传母包并自动解析核对包名、版本及文件哈希。
- 配置渠道参数、渠道 JSON 配置、包名、应用名、图标与签名方案。
- 创建分包任务,由隔离 Worker 执行注入与重签名,核对任务结果和渠道产物。
- 安装或部署渠道包,完成启动、登录、实名认证、收银台和角色上报核验。
同一应用的版本升级需匹配既有签名。签名私钥通过双方约定的受控方式管理,不放入公开文档、APK 或普通资料附件。
交付验收清单
- 渠道包可以安装、启动,原有游戏功能正常。
- 游戏 ID、渠道编码与包 ID 与发行记录一致。
- 登录事件未重复计数,角色区服和等级正确。
- 断网补传、重启恢复和会话续期可用。
- 两个账号及不同区服的角色数据互不覆盖。
- 产物哈希、签名指纹和母包版本可追溯。
验收通过记录应包含日期、设备系统、母包版本、包 ID、操作与后台核对结果。