Q衢付通开发者中心控制台 ↗

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.txtassets/qufutong/channel_config.jsonAndroidManifest.xml 包名、应用名、版本号及应用图标替换,apksigner V1/V2 签名验签
iOS (.ipa)Payload/*.app/qufutong/channel_id.txt
Qufutong/ChannelID/{channel}/channel_id.txt
Payload/*.app/qufutong/channel_config.json
Qufutong/ChannelID/{channel}/channel_config.json
Payload/*.app/Info.plist 的 CFBundleIdentifier、CFBundleShortVersionString、CFBundleDisplayName
H5 / 小游戏 (.zip)qufutong/channel_id.txtqufutong/channel_config.json
qufutong/channel_env.js
manifest.json / game.json / package.json 的 package_name / appid / name / version

交付与分包流程

  1. 研发交付 APK / IPA / H5 ZIP 母包和版本资料。
  2. 运营上传母包并自动解析核对包名、版本及文件哈希。
  3. 配置渠道参数、渠道 JSON 配置、包名、应用名、图标与签名方案。
  4. 创建分包任务,由隔离 Worker 执行注入与重签名,核对任务结果和渠道产物。
  5. 安装或部署渠道包,完成启动、登录、实名认证、收银台和角色上报核验。
同一应用的版本升级需匹配既有签名。签名私钥通过双方约定的受控方式管理,不放入公开文档、APK 或普通资料附件。

交付验收清单

  • 渠道包可以安装、启动,原有游戏功能正常。
  • 游戏 ID、渠道编码与包 ID 与发行记录一致。
  • 登录事件未重复计数,角色区服和等级正确。
  • 断网补传、重启恢复和会话续期可用。
  • 两个账号及不同区服的角色数据互不覆盖。
  • 产物哈希、签名指纹和母包版本可追溯。

验收通过记录应包含日期、设备系统、母包版本、包 ID、操作与后台核对结果。