miot-plugin-sdk v1.x 环境搭建Windows 10/11 下 5 步完成 React Native 与 npm 配置在智能家居生态蓬勃发展的今天米家平台为开发者提供了强大的插件开发能力。本文将手把手带你完成 Windows 系统下的开发环境搭建让你能够快速开始米家插件的开发之旅。1. 环境准备与工具安装开发米家插件需要准备以下基础工具链这些工具共同构成了 React Native 开发的基础支撑Node.js 16React Native 的运行环境基础Git用于代码版本管理和 SDK 下载Python 2.7部分原生模块构建需要JDK 8Android 开发环境必备1.1 安装 Node.js 与 npm访问 Node.js 官网 下载 LTS 版本建议 16.x。安装时注意勾选以下选项npm package managerNode.js 自带的包管理工具Add to PATH将 Node.js 加入系统环境变量安装完成后验证安装是否成功node -v npm -v1.2 配置 npm 镜像源为加速依赖下载建议将 npm 镜像源设置为国内镜像npm config set registry https://registry.npmmirror.com npm config set disturl https://npmmirror.com/dist提示如果遇到权限问题请使用管理员权限运行命令提示符2. 获取 miot-plugin-sdk米家插件 SDK 提供了开发所需的所有基础框架和接口。获取方式有两种方法一通过 Git 克隆推荐git clone https://github.com/MiEcosystem/miot-plugin-sdk.git cd miot-plugin-sdk方法二下载 ZIP 包访问 miot-plugin-sdk GitHub 仓库点击 Code → Download ZIP解压到合适的目录3. 安装项目依赖进入项目目录后执行依赖安装npm install常见问题处理问题现象解决方案ECONNREFUSED 错误检查网络连接重试或更换镜像源Python 找不到安装 Python 2.7 并添加至 PATH权限不足使用管理员权限运行命令提示符注意Windows 下如遇到 fsevents 警告可忽略这是 Mac 专用的文件系统监控工具4. 创建第一个插件项目米家插件支持多种设备类型模板根据你的设备类型选择合适的模板npm run create com.yourcompany.product.model -type [template]可用模板类型empty空白模板common通用设备模板wifiWi-Fi/BLE Mesh 设备模板ble蓝牙设备模板例如创建一个蓝牙设备插件npm run create com.example.curtain.ble1 -type ble项目创建成功后会在projects目录下生成对应的项目文件夹结构如下projects/ └── com.example.curtain.ble1/ ├── android/ # Android 原生代码 ├── ios/ # iOS 原生代码 ├── src/ # 业务逻辑代码 └── project.json # 项目配置文件5. 运行与调试插件5.1 启动开发服务器npm start com.example.curtain.ble1成功启动后终端会显示二维码和服务器地址┌──────────────────────────────────────────────────┐ │ │ │ Dev server running on: 192.168.1.100:8081 │ │ │ │ Scan QR code to load the plugin on device: │ │ │ │ ████████████████████████████████████████████ │ │ ████████████████████████████████████████████ │ │ ████████████████████████████████████████████ │ │ ████████████████████████████████████████████ │ │ │ └──────────────────────────────────────────────────┘5.2 配置米家调试版 APP下载米家调试版 APK官方发布地址 Mijia-Android-RN-Dev安装到测试手机开启开发者模式进入米家 APP → 我的 → 设置 → 开发者选项开启 RN 设备插件调试5.3 添加调试插件在开发者选项中点击 添加新插件填写插件信息Package Namecom.example.curtain.ble1Device Modelexample.curtain.ble1输入开发电脑的局域网 IP 地址点击 直接 开始调试6. 进阶配置与优化6.1 开发工具推荐VS Code轻量级代码编辑器推荐插件React Native ToolsES7 React/Redux snippetsReact Developer Tools调试 React 组件层次FlipperReact Native 官方调试工具6.2 性能优化技巧热重载配置npm start com.example.curtain.ble1 --reset-cache日志分级import { Logger } from miot; Logger.log(Debug message, { level: debug });代码分割import dynamic from miot/dynamic; const HeavyComponent dynamic(() import(./HeavyComponent));7. 常见问题排查7.1 连接问题现象手机无法连接到开发服务器解决方案确保手机和电脑在同一局域网检查防火墙设置允许 8081 端口通信尝试adb reverse命令adb reverse tcp:8081 tcp:80817.2 插件不更新现象代码修改后插件界面无变化解决方案在米家 APP 中手动触发刷新清空 RN 缓存npm start com.example.curtain.ble1 --reset-cache重启开发服务器7.3 原生模块问题现象原生功能无法正常工作解决方案检查android/和ios/目录下的原生代码确保已正确安装所有原生依赖重新链接原生模块cd projects/com.example.curtain.ble1 npm run android通过以上步骤你应该已经成功搭建了米家插件开发环境。在实际开发中建议多参考官方文档和示例代码逐步深入理解米家插件的开发模式和最佳实践。