如何通过本地配置文件设置设备名称和备注?
更新日期:2026-10-13 11:39:56
向日葵定制客户端支持读取设备本地配置文件,自动获取设备名称和备注。配置该功能后,将根据设备本地配置文件设置设备信息,无需在定制包中额外配置设备名前后缀等信息。
该功能仅定制包支持,且需使用Android 企业客户端V1.2.2及以上版本,其他系统客户端适配敬请期待。
一、配置定制包
创建定制包时,在设备命名相关配置中,选择“读取设备本地配置文件”。备注名跟随设备命名方式配置,也将读取本地配置文件。
如果本地配置文件中没有对应信息,或配置文件不符合规定格式,则设备名将按默认规则处理,备注名为空。
二、配置本地文件
请根据设备的操作系统,将配置文件放置在指定路径下,并按照规定格式填写设备信息。
2.1 配置文件路径
| 操作系统 | 配置文件路径 |
|---|---|
| Windows / macOS / Linux | \ProgramData\Oray\AweSunHost_Custom_Coexist\DeviceInfo.josn |
| Android | /config/DeviceInfo.josn |
注意: Android 设备需要授予相应的文件访问权限,确保客户端能够读取配置文件。
2.2 配置字段说明
| 字段 | 是否必填 | 字段规则 |
|---|---|---|
| 设备名 | 必填 | 支持中文、英文、数字及符号,最长 50 个字符 |
| 备注 | 可选 | 支持中文、英文、数字及符号,最长 50 个字符 |
请确保配置文件中的字段名称、内容及文件格式符合要求。设备名为必填字段,备注为可选字段。示例如下
{
"device_name": "设备名_测试",
"remarks": "备注_测试"
}
三、配置文件读取规则
客户端会按照以下时机读取本地配置文件:
① 安装时:安装客户端时读取配置文件
② 启动时:客户端启动时读取配置文件
③ 运行期间:客户端每隔 6 小时读取一次配置文件,并更新设备信息
如需修改设备名称或备注,可更新本地配置文件,客户端将在后续读取时获取最新配置。
四、异常情况处理
如果设备信息未能按预期更新,请检查客户端版本是否支持、配置文件是否放置在正确路径、字段内容是否符合要求,以及 Android 设备是否已授予相应的文件访问权限。
文档内容是否对您有帮助?
如果遇到产品相关问题,您可咨询 在线客服 寻求帮助。



相关问题
其他问题




