咨询Codename One的build hints配置是否支持添加注释
Codename One Build Hints 注释使用说明
明确结论:完全支持在Build Hints配置中添加注释,可满足标注配置含义、提升配置可维护性的需求
具体使用规则和注意事项如下:
- 注释语法:注释需要单独占一行,在行首写
#即可,该行内容会被构建系统自动识别为注释,不会参与构建逻辑解析。你可以自由在注释里标注配置项的作用、添加原因、生效范围、后续调整提示等内容。 - 编辑兼容性:
- 无论你使用可视化Build Hints编辑器添加配置,还是直接手动修改项目根目录下的
codenameone_settings.properties文件,#开头的注释行都会被完整保留,不会出现编辑器自动清空注释的问题 - 可视化编辑器和手动修改配置文件的操作双向同步时,注释格式不会被破坏
- 无论你使用可视化Build Hints编辑器添加配置,还是直接手动修改项目根目录下的
- 避坑提示:不要把注释写在键值对配置的同一行末尾,这种写法不会被识别为注释,反而会被当做配置值的一部分,导致配置生效异常,所有注释必须单独成行。
以下是实际配置的参考样例:
# iOS端配置ATS豁免,适配内部测试环境HTTP接口,待测试环境完成HTTPS部署后可移除 ios.plistInject=<key>NSAppTransportSecurity</key><dict><key>NSAllowsArbitraryLoads</key><true/></dict> # 安卓端开启旧版存储权限兼容,适配v2.8之前版本的本地离线数据格式,待全量用户完成数据迁移后删除该配置 android.enableLegacyStorage=true # 隐藏安卓端默认的顶部标题栏,适配项目自定义沉浸式导航栏设计 android.showTitleBar=false
内容的提问来源于stack exchange,提问作者Francesco Galgani
相关产品推荐
相关产品推荐

