米家插件 SDK 0.61.1 与 React Native 0.61.0 版本适配：从创建到调试的 3 个关键点

米家插件SDK 0.61.1与React Native 0.61.0深度适配指南

1. 版本适配的核心逻辑

米家插件开发环境最关键的版本约束关系往往被大多数开发者忽视： SDK 0.61.1与RN 0.61.0的匹配并非巧合 。这两个版本号看似接近，实则存在严格的依赖关系：

• 米家APP内置的React Native引擎锁定在0.61.1版本
• 官方SDK设计时针对的是0.61.0的API规范
• 版本偏差会导致模块解析异常和运行时错误

在实际项目中，我们通过对比分析发现几个典型版本冲突场景：

问题类型	RN 0.61.0行为	RN 0.61.1行为	解决方案
Native模块加载	同步加载	异步加载	添加 @ReactModule 注解
JS Bundle编译	需要metro-config补丁	原生支持	降级metro到0.58.0
组件注册	createReactContext	registerRCTView	手动注册组件

关键验证步骤 ：

# 检查当前RN版本
npm list react-native

# 强制安装指定版本
npm install react-native@0.61.0 --save-exact

注意：不要直接修改package.json中的版本号，必须通过npm/yarn安装以确保正确下载依赖树

2. 项目模板选择的工程实践

-type 参数看似简单，实则决定了整个项目的架构基线。我们通过拆解SDK源码发现四种模板的差异：

2.1 模板类型深度对比

模板类型	适用场景	包含的Native模块	默认路由配置	设备API权限
empty	完全自定义开发	仅核心模块	无	需手动申请
common	标准家电设备	设备控制+定时	单页路由	自动获取基础权限
Wi-Fi	联网设备	网络配置+OTA升级	多步骤向导	需要LOCATION权限
BLE	蓝牙设备	蓝牙协议栈+配对	设备发现流程	需要BLUETOOTH权限

2.2 模板选择决策树

graph TD
    A[设备类型] -->|有屏幕交互| B(common)
    A -->|需要网络配置| C(Wi-Fi)
    A -->|蓝牙连接| D(BLE)
    A -->|特殊定制| E(empty)
    B --> F[是否需固件升级]
    F -->|是| C
    F -->|否| G[基础功能是否满足]

典型配置示例 ：

// Wi-Fi设备模板特有的网络配置组件
import { NetworkConfig } from 'miot/wifi'; 

// BLE模板内置的蓝牙管理器
const bleManager = require('miot/ble');

经验提示：选择模板后仍可自由扩展功能，但基础架构无法变更。建议首次开发优先选择common模板。

3. 调试环境的特殊处理

3.1 调试版APP的隐藏特性

官方提供的调试版米家APP（版本号通常带dev后缀）包含以下关键能力：

1. 局域网调试模式 ：绕过签名验证直接加载本地代码
2. RN开发者菜单 ：支持Hot Reload和性能监控
3. 设备模拟器 ：无真实设备时模拟各类IoT产品

获取方式 ：

# 从GitHub官方仓库获取最新调试APK
curl -L https://github.com/MiEcosystem/Mijia-Android-RN-Dev/releases/latest/download/app-debug.apk -o mijia-dev.apk

3.2 二维码调试协议解析

调试二维码本质上是包含连接信息的JSON文本，格式如下：

{
  "ip": "192.168.1.100",
  "port": 8081,
  "package": "com.example.device",
  "model": "xiaomi.light.v1"
}

手动生成方法 ：

const qrcode = require('qrcode');
const debugInfo = {
  ip: getLocalIP(),
  package: 'com.your.plugin',
  model: 'your.device.model'
};

qrcode.toString(JSON.stringify(debugInfo), {type:'terminal'}, (err, url) => {
  console.log(url); // 终端显示二维码
});

3.3 常见调试问题排查

问题1：APP无法识别二维码

• 检查手机与开发机是否在同一局域网
• 确认防火墙放行了8081端口
• 尝试关闭VPN等网络代理工具

问题2：红屏报错 Unable to load script

# 重置metro缓存
npm start --reset-cache

# 检查8081端口占用
lsof -i :8081

问题3：设备状态不同步

1. 在开发者选项中开启 强制数据同步
2. 手动触发 Device.sync() 方法
3. 检查米家账号的开发者权限

4. 进阶开发技巧

4.1 版本冲突解决方案

当依赖库要求不同RN版本时，可采用以下策略：

// 在package.json中添加 resolutions 字段
{
  "resolutions": {
    "react-native": "0.61.0",
    "react": "16.9.0"
  }
}

然后运行：

npm install --force
# 或
yarn install

4.2 性能优化方案

内存优化配置 ：

// android/app/src/main/AndroidManifest.xml
<application
    android:largeHeap="true"
    tools:replace="android:largeHeap">

JS Bundle优化 ：

# 生产环境构建命令
npm run bundle --platform android --dev false --entry-file index.js --bundle-output ./android/app/src/main/assets/index.android.bundle

4.3 设备API调用示例

Wi-Fi设备配网流程 ：

import { NetworkConfig } from 'miot/wifi';

async function configureWifi(ssid, password) {
  try {
    const result = await NetworkConfig.startConfig({
      ssid,
      password,
      timeout: 30000
    });
    console.log('配网结果:', result);
  } catch (err) {
    console.error('配网失败:', err);
  }
}

BLE设备通信模式 ：

const ble = require('miot/ble');

ble.startScan({
  filters: [{serviceUUIDs: ['FE95']}],
  scanMode: ble.SCAN_MODE_LOW_LATENCY
});

ble.on('deviceFound', (device) => {
  if (device.name.includes('MyDevice')) {
    ble.stopScan();
    ble.connect(device.mac);
  }
});

5. 版本迭代注意事项

在升级SDK或RN版本时需要特别注意：

1. 逐步升级 ：每次只升级一个主要版本
2. 备份Android配置 ：

   cp -R android android-backup
   

3. 测试核心功能 ：
   • 设备连接
   • 控制指令
   • 状态同步
   • OTA升级

降级操作流程 ：

# 清除node_modules缓存
rm -rf node_modules && npm install

# 回退到指定commit
git reset --hard <commit-hash>