云控打包配置实战：一键打包 APK 分发脚本到多台设备

云控方案里最烦的一步往往不是部署平台，而是把脚本送到每一台设备上。几十台手机一台台装 APK、填地址、配参数——光想想就头大。

云控平台的打包配置就是解决这个的：把脚本打成企业版 APK，分发安装后自动连接云控，设备名称、云控地址都可以云端管理。这篇文章把三种打包模式讲清楚。

一、云控打包是什么

把脚本打包成 APK，设备安装后自动连接云控平台，实现批量部署：

• 支持动态域名打包，也支持静态域名打包；
• 一定要打企业版本的 apk（非调试版本）；
• 设备装好 APK 后自动接入云控，无需逐台配置。

二、EC 7.8.0+ 的打包规则

1. 从 EC 7.8.0 开始，非调试版本的域名只能从开发工具打企业版本包的时候输入，其他无输入途径；
2. 从 EC 7.8.0 开始，新增了云端直接动态改变 apk 内部域名功能；
3. 从 EC 7.8.0 开始，无需在 apk 中填写设备名称，直接在云端填写设备名称即可。

也就是说：域名在打包时定死（或走动态获取），设备名完全云端管理，APK 一份打天下。

三、三种打包域名配置

3.1 直连模式

直连模式是打包的 APK，通过打包的域名直接和云控链接。

打企业版本的包，填写云控地址即可。设备安装 APK 后直接连这个地址。

• 优点：最简单，填地址就完事；
• 缺点：换服务器要重新打包分发。

3.2 动态 DNS 解析域名模式（推荐）

该模式好处是使用域名指向 IP，但不需要域名备案：

• 只需要在 DNS 解析到 IP 即可；
• 原理：通过域名解析到 IP，再通过 IP 链接到服务器，避免更换服务器的问题；
• 具体操作：打包企业版本时，填写云控地址为域名+端口号，例如 ecloud.devicefarm.cn:8098；
• 获取链接模式选择 DNS解析IP后链接。

3.3 动态域名

动态域名模式是打包的 APK，先通过配置的 JSON 地址获取云控真实的地址，再通过真实地址去链接云控的服务器。

打企业版本的包，填写云控地址，例如 http://192.168.1.76:8099/remote.json——一定要以 json 结尾！

JSON 文件的获取与存放：

1. 这个 json 文件可以放到阿里云的 OSS 或者其他可以请求到的地方；
2. 也可以直接使用云控的站点管理 - 站点授权 - 云控链接地址设置功能（请进入站点看详细说明）；
3. json 文件的数据生成：进入云控的站点管理 → 站点授权 → 云控链接地址设置，填写域名后点击复制按钮，将复制的数据存储到本地 remote.json 文件，然后将 remote.json 放到阿里云 OSS 等存储即可。

生成的 JSON 格式如下：

{"data":"BggHBAcEBwADUQJWAlYDAQMJAwICVQMBAwYDCAJVAwECVQMHAwYDUQMIAwADCQMJAFEGCAcEBwQHAANRAlYCVgMBAwkDAgJVAwEDBgMIAlUDAQJVAwcDBgNRAwgDAAMJAwg="}

四、三种模式对比与选型

模式	原理	优点	适合场景
直连	APK 直接连打包时填的地址	最简单	服务器固定、不常迁移
动态 DNS 解析（推荐）	域名解析到 IP 再连 IP	免备案、换服务器不改包	有域名但不想备案、服务器可能迁移
动态域名	先请求 JSON 获取真实地址再连	云控地址随时可改（改 OSS 上的 JSON）	多地多址、地址动态变化

五、常见问题

打包一定要企业版吗？

是的，非调试版本（正式分发）的域名只能在打企业版本包时输入，调试版本不适用于正式分发场景。

换云控服务器要重新打包吗？

直连模式要重新打包；动态 DNS 模式只需把域名解析指到新 IP；动态域名模式只需更新 OSS 上的 remote.json，APK 都不用动。

remote.json 链接不上怎么办？

先确认 JSON 地址能以 http 方式访问（浏览器打开看是否返回 json）；再确认地址以 .json 结尾；最后检查云控的站点管理-云控链接地址设置里填写的域名是否正确。

六、总结

云控打包配置的本质是：让 APK 与云控地址解耦：

• 直连：最简，地址写死；
• 动态 DNS：免备案、地址可迁，推荐；
• 动态域名：地址完全云端可改，OSS 换 json 即可切换；
• 设备名云端化：7.8.0+ 打包不填设备名，云端命名管理。

把打包这关过了，云控的“批量部署”才算真正跑通：一份 APK 分发下去，设备自己找上云控，剩下的一切都在云端操作。