注:目前的JS版本的Link SDK最新版本号为1.2.8。

安装 Node.js 运行环境,版本需要 >=4.0.0

通过 npm 包管理工具安装SDK

将SDK安装到Nodejs项目所在目录

适用于开发者已创建自己的项目,然后集成阿里云的Link SDK:

npm install alibabacloud-iot-device-sdk --save
			

将SDK进行全局安装

适用于开发者直接编写了一个js文件(该文件引用了阿里云的Link SDK)、然后直接使用node xxx.js运行该js程序的场景。这种情况需要将SDK进行全局安装,命令如下所示:

npm install -g alibabacloud-iot-device-sdk
			

注:不推荐全局安装的方式,因为扩展性不好。

全局安装后运行程序常见错误:

  • 如果在windows下运行js程序时提示“Error: Cannot find module 'alibabacloud-iot-device-sdk'”,请在环境变量中增加"NODE_PATH"变量,其值设置为SDK安装所在的目录。如下图所示:
注:上图中的“NODE_PATH”的变量值需要修改为开发者自己设备上SDK安装所在的目录。
  • 如果在Linux下直接使用node 运行指定的js程序时,提示“Error: Cannot find module 'alibabacloud-iot-device-sdk'”,也是由于没有设置NODE_PATH变量引起,可以运行命令 npm root -g 获取npm的模块安装目录,并将该目录设置到NODE_PATH环境变量并生效(比如重启Linux)后再次使用node加载js程序。

源码下载

目前js版本sdk已经开源,项目地址:https://github.com/aliyun/alibabacloud-iot-device-sdk

如何引用Link SDK

node程序引用SDK

使用SDK提供的API需要在js代码中加入对SDK的依赖,如下所示:

const iot = require('alibabacloud-iot-device-sdk');
			

浏览器、微信小程序、支付宝小程序集成SDK

const iot = require('./dist/alibabacloud-iot-device-sdk.js'); //引用路径以实际为准
// 支付宝小程序请使用./dist/alibabacloud-iot-device-sdk-1.2.8-alimin-compatible.js            
说明 支付宝最新版本容器升级后导致支付宝小程序无法使用 'alibabacloud-iot-device-sdk.js' ,请使用支付宝定制版本 'alibabacloud-iot-device-sdk-1.2.8-alimin-compatible.js', 该文件位于dist目录下

JS版本下载地址

github下载:https://github.com/aliyun/alibabacloud-iot-device-sdk/tree/master/dist

cdn下载:

alibabacloud-iot-device-sdk.js 下载地址https://unpkg.com/alibabacloud-iot-device-sdk@1.2.4/dist/alibabacloud-iot-device-sdk.js

alibabacloud-iot-device-sdk.min.js 下载地址 https://unpkg.com/alibabacloud-iot-device-sdk@1.2.4/dist/alibabacloud-iot-device-sdk.min.js

版本变更

记录各个版本的主要变动

1.2.8

解决支付宝最新版本容器升级后导致支付宝小程序无法使用的问题

1.2.7

  • 修改了事件上报、属性上报中给出参数的定义
  • 增加onProps对属性设置进行处理
  • 包名的修改,从 aliyun-iot-device-sdk 正式改名为 alibabacloud-iot-device-sdk
  • 增加对微信小程序、支付宝小程序、浏览器的支持
  • 增加onService中reply函数,并支持同步和异步调用
  • 增加onConfig方法用于订阅云端远程配置更新
  • 增加部分功能的example
  • 重写了网关子设备subdevice的实现

1.0.1

  • 增加设备标签上报功能
  • 增加删除标签功能
  • 增加了设备动态注册功能
  • 增加设备影子相关功能
  • 增加获取设备配置功能