天天看點

30分鐘上手HaaS釘釘小程式開發

來源 | HaaS技術社群

1、小程式介紹

小程式是一種不需要下載下傳安裝即可使用的應用,它實作了應用“觸手可及”的夢想,使用者掃一掃或者搜一下即可打開應用。也展現了“用完即走”的理念,使用者不用關心是否安裝太多應用的問題。應用将無處不在,随時可用,但又無需安裝解除安裝。

對于開發者而言,小程式開發門檻相對較低,難度不及APP,能夠滿足簡單的基礎應用,适合生活服務類線下商鋪以及非剛需低頻應用的轉換。對于使用者來說,能夠節約使用時間成本和手機記憶體空間;對于開發者來說也能節約開發和推廣成本。

是以我們選用小程式作為HaaS生态的使用者端應用,以最低的開發成本幫助使用者快速打通雲端鍊路。

2、小程式開發者工具(IDE)

使用者可以前往

https://opendocs.alipay.com/mini/ide/overview

下載下傳小程式開發者工具(本文使用的版本是1.17.4)。除了支付寶小程式和釘釘小程式外,該工具還支援手機淘寶、天貓精靈、高德小程式等各種軟體版本小程式的開發。

30分鐘上手HaaS釘釘小程式開發

建立空白項目

30分鐘上手HaaS釘釘小程式開發
30分鐘上手HaaS釘釘小程式開發
30分鐘上手HaaS釘釘小程式開發

建立完成後的界面如下:

30分鐘上手HaaS釘釘小程式開發

我們打開側邊欄,在 pages/index/index.axml 中編輯代碼并儲存檔案,就可以在模拟器中看到HelloWorld。

<view>
  HelloWorld!
</view>           
30分鐘上手HaaS釘釘小程式開發

但至此并未結束,我們嘗試點選右上角的真機調試或預覽或上傳,會出現提示我們“關聯應用”。

30分鐘上手HaaS釘釘小程式開發

原來是在開發小程式之前,我們需要去對應的平台申請小程式的 AppID, 它是每個小程式的唯一辨別,有了它才能在真機上運作小程式。

3、支付寶小程式申請

在“關聯應用”視窗中點選小三角,點選建立小程式,進入支付寶開放平台。點選标題欄中的“控制台”。

在控制台中,點選 “建立應用” - “小程式”

30分鐘上手HaaS釘釘小程式開發

填寫必要資訊,即可完成建立。

30分鐘上手HaaS釘釘小程式開發
30分鐘上手HaaS釘釘小程式開發
30分鐘上手HaaS釘釘小程式開發

建立完成後,即可在小程式開發者工具左上角關聯剛剛建立的應用,然後點選“真機調試”,小程式就會自動顯示在手機的支付寶App的頁面上。

30分鐘上手HaaS釘釘小程式開發

3.1、真機運作結果

30分鐘上手HaaS釘釘小程式開發

4、釘釘小程式申請

為了使用釘釘小程式進行開發,我們首先需要将IDE的開發模式切換到釘釘小程式。點選左上角,選擇“管理”。

30分鐘上手HaaS釘釘小程式開發

選中“釘釘”小程式,點選确定。

30分鐘上手HaaS釘釘小程式開發

再次點選左上角,可以看到待選清單中有釘釘應用選項。這裡我們選擇企業内部應用。

30分鐘上手HaaS釘釘小程式開發

在“選擇關聯企業内部應用”中,選擇“建立企業内部應用”。

30分鐘上手HaaS釘釘小程式開發

點選右上角“注冊企業” (這裡實際是建立了一個虛拟的小程式開發小組,在釘釘應用程式内會多一個同名的聊天群組,可以在這個群組加入其它成員),根據提示完成注冊。

30分鐘上手HaaS釘釘小程式開發

進入“應用開發”頁面,選擇“企業内部開發”“小程式”,點選“建立應用”。

30分鐘上手HaaS釘釘小程式開發

填入對應小程式資訊。

30分鐘上手HaaS釘釘小程式開發

完成釘釘小程式建立。

30分鐘上手HaaS釘釘小程式開發

此時在IDE中,可以看到剛剛建立的小程式,并可以進行真機調試。

30分鐘上手HaaS釘釘小程式開發

5、HaaS雲端釘一體開發

本章節介紹如何使用SDK進行釘釘小程式的開發。首先是在github上下載下傳HaaS小程式開發SDK。

5.1、雲端釘一體小程式SDK擷取

git clone -b dev_3.1.0_haas https://github.com/alibaba/AliOS-Things.git           

SDK相關代碼及操作readme在application/miniapp/目錄下。

5.2、SDK目錄結構

/
├─ lib (存放依賴庫的檔案夾,使用者無需關心)
│    ├─ @alicloud/pop-core     (https://github.com/aliyun/openapi-core-nodejs-sdk)
│    ├─ kitx
│    └─ iot-packet.js              (封裝給使用者的檔案)
├─ pages                              (頁面檔案夾,使用者在這裡自定義頁面,示例持續更新中)
│    └─ index                        (首頁 選擇進入不同示例) 
│             ├─ index.axml         
│             ├─ index.js           
│             ├─ index.acss 
│             └─ index.json 
│    └─ HaasCar                    (示例1 HaaS小小蠻驢)
│             ├─ HaasCar.axml    (頁面布局檔案)
│             ├─ HaasCar.js        (控制邏輯,使用者在這裡定義互動行為)
│             ├─ HaasCar.acss    (頁面樣式)
│             ├─ HaasCar.json      (頁面配置,用于配置頁面标題等)
│             └─ HaasCar.TSL.json (示例對應的TSL檔案,使用者可以在物聯網平台上導入該檔案生成物模型)
│    └─ HaasFlower              (示例2 HaaS養花,目錄結構同 HaasCar)
├─ app.js                            (注冊小程式,在這裡進行全局參數配置,如 AccessKey)
├─ app.acss                         (小程式全局樣式)
├─ app.json                         (小程式全局配置,可以在這裡設定小程式打開的預設頁面)
└─ others           

5.3、SDK使用

使用小程式開發工具打開miniapp這個工程。

30分鐘上手HaaS釘釘小程式開發
  • step1 在app.js填寫AccessKeyID 以及 AccessKeySecret , 擷取雲端API調用權限
  • step2 填寫目标裝置 DeviceName 以及 ProductKey,這裡是待控制的裝置
// app.js
let accessKey = {
  accessKeyId: '<- accessKeyId ->',     // 填入阿裡雲物聯網平台生成的 assessKeyId 以及 Secret
  accessKeySecret: '<- accessKeySecret ->',
}
 
// HaasCar.js
let device = {
  DeviceName: '<- DeviceName ->',   // 填入目标裝置 DeviceName 以及 ProductKey
  ProductKey: '<- ProductKey ->'
}           

代碼中提到的幾個關鍵參數:

AccessKeyID AccessKeySecret

雲賬号AccessKey是使用者通路阿裡雲API的密鑰。(

https://usercenter.console.aliyun.com/#/manage/ak

安全起見,我們可以采取建立

RAM子賬号

的形式,來對權限進行分離。

30分鐘上手HaaS釘釘小程式開發

建立完成後,需要手動配置設定權限,點選右側,添權重限。我這裡直接選擇了 AdministratorAccess。 添加完成後如下。

30分鐘上手HaaS釘釘小程式開發

DeviceName ProducKey

這兩個參數在建立裝置時生成。

5.4、編譯驗證

點選小程式IDE右上角“真機調試”按鈕,等待二維碼生成後,使用釘釘APP掃碼,即可發起小程式。

30分鐘上手HaaS釘釘小程式開發

至此,完整的小程式就完全跑起來,并且可以跟阿裡雲物聯網平台互動。後續會有系列的 一步步打造HaaS執行個體小程式 的分享,敬請持續關注哦。謝謝

6、開發者技術支援

如需更多技術支援,可加入釘釘開發者群,或者關注微信公衆号

30分鐘上手HaaS釘釘小程式開發

更多技術與解決方案介紹,請通路阿裡雲AIoT首頁

https://iot.aliyun.com/