miot-plugin-sdk v1.x 环境搭建：Windows 10/11 下 5 步完成 React Native 与 npm 配置

在智能家居生态蓬勃发展的今天，米家平台为开发者提供了强大的插件开发能力。本文将手把手带你完成 Windows 系统下的开发环境搭建，让你能够快速开始米家插件的开发之旅。

1. 环境准备与工具安装

开发米家插件需要准备以下基础工具链，这些工具共同构成了 React Native 开发的基础支撑：

• Node.js 16+：React Native 的运行环境基础
• Git：用于代码版本管理和 SDK 下载
• Python 2.7：部分原生模块构建需要
• JDK 8：Android 开发环境必备

1.1 安装 Node.js 与 npm

访问 Node.js 官网 下载 LTS 版本（建议 16.x）。安装时注意勾选以下选项：

• npm package manager：Node.js 自带的包管理工具
• Add to PATH：将 Node.js 加入系统环境变量

安装完成后，验证安装是否成功：

node -v npm -v

1.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 包

1. 访问 miot-plugin-sdk GitHub 仓库
2. 点击 "Code" → "Download ZIP"
3. 解压到合适的目录

3. 安装项目依赖

进入项目目录后，执行依赖安装：

npm install

常见问题处理：

注意：Windows 下如遇到 fsevents 警告可忽略，这是 Mac 专用的文件系统监控工具

4. 创建第一个插件项目

米家插件支持多种设备类型模板，根据你的设备类型选择合适的模板：

npm run create com.yourcompany.product.model -type [template]

可用模板类型：

• empty：空白模板
• common：通用设备模板
• wifi：Wi-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

1. 下载米家调试版 APK：
   • 官方发布地址： Mijia-Android-RN-Dev
2. 安装到测试手机
3. 开启开发者模式：
   • 进入米家 APP → 我的 → 设置 → 开发者选项
   • 开启 "RN 设备插件调试"

5.3 添加调试插件

在开发者选项中：

1. 点击 "+" 添加新插件
2. 填写插件信息：
   • Package Name：com.example.curtain.ble1
   • Device Model：example.curtain.ble1
3. 输入开发电脑的局域网 IP 地址
4. 点击 "直接" 开始调试

6. 进阶配置与优化

6.1 开发工具推荐

• VS Code：轻量级代码编辑器
  • 推荐插件：
    • React Native Tools
    • ES7 React/Redux snippets
• React Developer Tools：调试 React 组件层次
• Flipper：React Native 官方调试工具

6.2 性能优化技巧

1. 热重载配置：

   npm start com.example.curtain.ble1 --reset-cache

2. 日志分级：

   import { Logger } from 'miot'; Logger.log('Debug message', { level: 'debug' });

3. 代码分割：

   import dynamic from 'miot/dynamic'; const HeavyComponent = dynamic(() => import('./HeavyComponent'));

7. 常见问题排查

7.1 连接问题

现象：手机无法连接到开发服务器

解决方案：

1. 确保手机和电脑在同一局域网
2. 检查防火墙设置，允许 8081 端口通信
3. 尝试adb reverse命令：

   adb reverse tcp:8081 tcp:8081

7.2 插件不更新

现象：代码修改后插件界面无变化

解决方案：

1. 在米家 APP 中手动触发刷新
2. 清空 RN 缓存：

   npm start com.example.curtain.ble1 --reset-cache

3. 重启开发服务器

7.3 原生模块问题

现象：原生功能无法正常工作

解决方案：

1. 检查android/和ios/目录下的原生代码
2. 确保已正确安装所有原生依赖
3. 重新链接原生模块：

   cd projects/com.example.curtain.ble1 npm run android

通过以上步骤，你应该已经成功搭建了米家插件开发环境。在实际开发中，建议多参考官方文档和示例代码，逐步深入理解米家插件的开发模式和最佳实践。