通過npm包管理工具安裝Link SDK

1. 將Link SDK安裝到Node.js項目所在目錄。

   適用于開發者已創建自己的項目，然后集成阿里云的Link SDK：

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

2. 將Link SDK進行全局安裝。

   適用于開發者直接編寫了一個js文件（該文件引用了阿里云的Link SDK），然后直接使用node xxx.js運行該js程序的場景。這種情況需要將Link SDK進行全局安裝，命令如下所示：

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

   全局安裝后運行程序常見錯誤：

   • 如果在Windows下運行js程序時提示Error: Cannot find module 'alibabacloud-iot-device-sdk，請在環境變量中增加NODE_PATH變量，其值設置為Link SDK安裝所在的目錄。如下圖所示：

     說明

     下圖中的NODE_PATH的變量值需要修改為開發者自己設備上Link SDK安裝所在的目錄。

     

   • 如果在Linux下直接使用Node命令運行指定的js程序時，提示Error: Cannot find module 'alibabacloud-iot-device-sdk'，也是由于沒有設置NODE_PATH變量引起，可以運行命令 npm root -g 獲取npm的模塊安裝目錄，并將該目錄設置到NODE_PATH環境變量并生效（比如重啟Linux）后再次使用Node命令加載js程序。

源碼下載

目前Node.js Link SDK已經開源，請參見alibabacloud-iot-device-sdk。

如何引用Link SDK

• node程序引用Link SDK。

  使用Link SDK提供的API需要在js代碼中加入對SDK的依賴，如下所示：

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

• 瀏覽器、支付寶小程序等場景集成Link SDK。

  說明

  如果支付寶版本升級后導致支付寶小程序無法使用alibabacloud-iot-device-sdk.js，請使用支付寶定制版本alibabacloud-iot-device-sdk-1.2.8-alimin-compatible.js，該文件位于dist目錄下。

  const iot = require('./dist/alibabacloud-iot-device-sdk.js'); //引用路徑以實際為準
  // 支付寶小程序請使用./dist/alibabacloud-iot-device-sdk-1.2.8-alimin-compatible.js            

  js文件下載地址：

  • GitHub下載：GitHub下載

  • CDN下載：

    • alibabacloud-iot-device-sdk.js下載

    • 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

  • 增加設備標簽上報功能。

  • 增加刪除標簽功能。

  • 增加了設備動態注冊功能。

  • 增加設備影子相關功能。

  • 增加獲取設備配置功能。