打包工具

工具下载

工具为单文件可执行程序，无需安装，apktool、apksigner 等依赖已内置。最新版本以控制台「批量打包 → 本地打包」页面提供的下载地址为准。

环境要求

• Java：需安装 JDK/JRE 并配置到 PATH（macOS 与 Windows 均需要），终端执行 java -version 确认可用；工具内的 apktool/apksigner 依赖 java 运行。
• 操作系统：macOS 12 及以上，或 Windows 10 及以上（64 位）。
• 路径：工具与母包尽量放在较短的目录路径下，Windows 下路径过长可能导致打包失败。
• 网络：工具需访问 GravityDock 服务端拉取游戏与渠道打包配置，请保证网络可达。

参数示意

工具启动后使用游戏 token 从服务端拉取当前已配置完整的渠道列表，再按上述筛选参数逐渠道出包。

产物说明

• 渠道 APK 输出到母包所在目录，按渠道命名；签名未成功的产物会追加 -unsigned 后缀，需排查签名配置后重打。
• 工具在自身所在目录维护 .temp 缓存，请保证目录可写，不要把母包直接放在临时解压目录。

示例调用脚本

GravityDockAutoBuildApkTool 和 GravityDockAutoBuildApkTool.exe 替换为本地电脑上工具解压后的具体路径

macOS（bash）：

chmod +x GravityDockAutoBuildApkTool \
  -t YOUR_GAME_TOKEN \
  -a /path/to/base.apk \
  -mt 2

Windows（bat）：

GravityDockAutoBuildApkTool.exe ^
  -t YOUR_GAME_TOKEN ^
  -a C:\path\to\base.apk ^
  -mt 2

快速测试时可以先只打部分渠道，例如仅打 xiaomi、developer 两个渠道：

./GravityDockAutoBuildApkTool -t YOUR_GAME_TOKEN -a /path/to/base.apk -jc xiaomi,developer

推荐直接复制控制台「本地打包」页面生成的完整命令执行，避免手工拼写 token、服务地址和凭证出错。

注意事项

• 完整命令包含游戏 token 和登录凭证，应仅在受控机器使用，不要提交到代码仓库或群聊。
• 打包完成后校验产物包名、版本与证书，并按上线验收流程实际测试登录与支付。