用途:该技能面向明道云 HAP 自定义视图插件开发,提供从项目初始化到调试运行的完整工作流程与开发规范,触发场景包括提到 HAP 视图插件、自定义视图、mdye、视图开发、插件开发、初始化视图项目、启动视图调试等。
主要能力:通过 mdye-cli 脚手架创建 React 基础示例模板项目,安装依赖并启动本地开发环境;提供 API 使用指南,包括获取 env 环境变量与 config 配置、数据获取(getFilterRows、getRowDetail、getRowRelationRows)、数据操作(addWorksheetRow、updateWorksheetRow、deleteWorksheetRow)、工具函数(openRecordInfo、openNewRecord、selectUsers、selectDepartments、selectLocation、selectRecord)以及事件监听(filters-update、new-record)。同时给出字段类型对照与解析函数,涵盖单选、多选、成员、附件、定位、关联记录等特殊字段处理。
使用方式:前置条件为 Node.js 16.20 或更高版本、明道云开发者账号与插件开发权限、基本 React 知识。安装工具:mdye --version 检查,未安装时 Mac 使用 sudo npm install -g mdye-cli,Windows/Linux 使用 npm install -g mdye-cli。初始化项目:mdye init view --id <插件ID> --template React,随后 cd 进入项目目录并执行 npm i,再运行 mdye start 启动开发服务器,将 http://localhost:3000/bundle.js 粘贴到明道云视图配置开发调试输入框。
适用场景:开发明道云 HAP 自定义视图插件,需要快速搭建 React 项目、调用平台 API 读写数据、复用原生记录详情组件或处理复杂字段类型时。
限制:资料未提供收费、价格、平台兼容范围、性能指标或效果承诺;部分字段类型仅支持 API 返回而不支持创建,字段类型编号与文档枚举存在差异,需以实际 V3 定义为准。