Oracle Retail Xstore 如何正确创建.mnt文件及相关规范咨询

基本定义 #

.mnt是Oracle Retail Xstore POS系统专属的模块挂载配置文件，作用是告知Xstore运行时需要加载的自定义扩展资源的基础信息、依赖关系、权限要求等，是Xstore二次开发中扩展功能的必备配置文件。

格式规范 #

.mnt文件本质是标准Properties格式的配置文件，遵循以下规则：

• 采用UTF-8无BOM编码
• 每行定义一个配置项，键与值之间用等号=分隔，前后不保留多余空格
• 注释行以#开头，运行时会自动被系统忽略
• 文件名建议和模块唯一标识保持一致，便于管理

核心配置项说明 #

带*的为必填配置项：

• *module.id：自定义模块的全局唯一标识，建议采用反域名规则命名，避免和官方模块冲突，示例：com.yourbrand.xstore.promotion.custom
• *module.name：模块的可读名称，用于后台管理模块的展示
• *module.version：模块的版本号，遵循语义化版本规范，示例：1.0.0
• *module.entry.point：模块初始化入口类的全限定名，Xstore启动时会自动调用该类的初始化方法
• *module.resource.path：模块的静态资源、子配置文件的存放相对路径，根路径为Xstore安装目录下的extensions文件夹
• module.dependency：可选配置，声明模块依赖的其他模块标识及最低版本要求，多个依赖用英文逗号分隔
• module.permission：可选配置，声明模块需要申请的系统权限，多个权限用英文逗号分隔

示例文件 #

# 自定义会员折扣模块挂载配置
module.id=com.xxx.retail.promotion.member.discount
module.name=会员专属折扣模块
module.version=1.2.1
module.entry.point=com.xxx.retail.promotion.MemberDiscountInitializer
module.resource.path=/custom/promotion/member/
module.dependency=com.oracle.retail.xstore.core.promotion:19.0.0
module.permission=order.discount.adjust:allow,member.info.query:allow

补充说明 #

你之前查阅的系统设置章节仅覆盖Xstore前台运行参数配置，.mnt文件的完整规则收录在《Oracle Retail Xstore POS Extensions Developer Guide》的「自定义模块挂载」章节中，你可以在Oracle官方文档中心的Xstore 19.x版本开发分类下检索对应文档。

内容的提问来源于stack exchange，提问作者Denys Maksiura