全部产品
云市场

环境要求与配置

更新时间:2019-06-25 09:45:26

注:目前的JS版本的Link Kit SDK最新版本号为1.2.7

环境配置

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

通过 npm 包管理工具安装SDK

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

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

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

将SDK进行全局安装

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

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

node程序引用SDK

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

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

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

  1. const iot = require('./dist/alibabacloud-iot-device-sdk.js'); //引用路径以实际为准

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

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

1.0.1

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