一、概述

機智云的SDK日志中包含了大量的信息，極大的方便開發者定位問題，但很多開發者都看不懂這些日志，因此該份教程講述如何從SDK的日志中找到自己需要的信息以及定位問題。

該份文檔的閱讀前提是開發者已經具備獲取Android日志的條件和能力，并且已經熟悉機智云SDK相關使用方法。如不具備這些前提，請先參考網絡上的相關資料。

二、設置SDK級別

要查看SDK的日志，首先需要調用SDK設置日志級別的方法，將其設為所有級別，以及設置在后臺輸出二進制數據。

調用方法：

XPGWifiSDK.setLogLevel（XPGWifiLogLevel logLevel， String logFile， boolean bPrintDataInDebug）;

參數說明：

三、過濾日志

SDK的日志主要有兩個“TAG”，一個是“xpgc”，一個是“XPGWifiSDK”。一般情況下，LogCat的Log Tag 設置為“xpg”即可。

如圖：

“xpgc”代表該日志屬于SDK底層邏輯所打印的日志。

“XPGWifiSDK”代表該日志屬于SDK外部公共接口所打印的日志。

如圖：

四、日志分析

SDK在執行每一步操作的時候，都會打印出相關信息，具體信息課參考如下說明：

云端請求

SDK里包含的大量的云端交互操作，其中與云端交互部分，會以“W”（警告）級別打印，在Eclipse的Log Cat中會以橘黃色來標記。如下圖：

該日志包含了請求的相關信息，如請求的Header以及Body。

其中Header包含了AppID以及Token等比較重要的信息，App發布的時候請注意關閉日志輸出。

SDK內部使用的網絡接口都是使用機智云OpenAPI的相關接口，接口的詳情可參考官網的文檔。

根據該日志，可以看出發出自己的接口調用是否正確，例如缺少token或者缺少AppID等；同時也可以判斷自己的網絡質量，是否發起請求以后長時間未收到云端回復。

一些常見的問題分析會在該文檔后面再詳細描述。

云端響應

SDK發起請求后，在網絡正常的情況下，SDK會收到云端的響應，響應結果也會打印在日志中。如圖：

具體的reponse會以“W”級別標出。上圖是獲取賬號下綁定的設備的請求響應。一般情況下，開發者無需理會具體的網絡請求和響應，SDK會自行處理并作出回調。只有在網絡情況不好的情況下，開發者才需要從日志中分析網絡請求是否正常。

發現設備

SDK發現本地設備的過程實際上是UDP的收發過程。SDK會往路由器發送一個UDP廣播，燒寫了機智云模塊的設備在收到改廣播后，會回復一個響應幀到SDK端。具體的過程可由下圖看出來：

“xpgBroadcast（），port = 12414”該日志說明SDK向路由器的12414端口發送了一個UDP廣播，具體的指令內容可參考協議文檔。如果發送成功，SDK會打印“udp package send success”。

當設備收到了指定的UDP廣播以后，會回復相關響應幀，該響應幀包含了設備的Productkey、Did、IP地址、MAC地址等信息。具體的指令內容可參考協議文檔。

SDK收到設備的回復以后，會回調didDiscoverd接口。

從該日志可以看出SDK發出廣播后，是否有設備回復。如果沒有收到回復，說明有幾點原因：

本地沒有設備

路由器不支持UDP廣播

可根據實際情況定位問題和解決問題。

小循環登錄設備

小循環登錄即是手機與設備在同一路由器內，通過設備IP建立TCP連接。登錄的過程如下圖：

由圖中的“Connected to server 192.168.1.102:12416”可以看出SDK發起的是小循環登錄，連接的是設備的IP地址，端口號為12416。

登錄成功后，SDK內部會打印“OnLogin（int）： 0”，返回值0說明登錄成功了，會回調“didLogin”接口通知UI進行處理。

通過該日志，可以判斷設備是進行大循環還是小循環連接，并且可以看出連接成功或者失敗，以及失敗的原因。具體失敗的原因會在本文檔后面進一步描述。

大循環登錄設備

大循環登錄即是手機與設備不在同一路由器（網段）內，通過機智云云端建立MQTT連接。登錄的過程如下圖：

由圖中的“Connected to server m2m.gizwits.com:1883”可以看出SDK發起的是大循環登錄，連接的是機智云云端域名地址，端口號為1883。

登錄成功后，SDK內部會打印“OnLogin（int）： 0”，返回值0說明登錄成功了，會回調“didLogin”接口通知UI進行處理。

通過該日志，可以判斷設備是進行大循環還是小循環連接，并且可以看出連接成功或者失敗，以及失敗的原因。具體失敗的原因會在本文檔后面進一步描述。

小循環收發指令

小循環發送指令通過TCP/IP進行收發。開發者調用SDK方法，傳入JSON格式的指令，由SDK內部解析成為二進制指令，并發送給設備。設備收到后做出狀態改變，按照機智云串口協議要求，把自己的狀態用二進制指令返回，SDK收到后再封裝為JSON格式，回調給相關接口。詳見下圖：

其中“writePi（）”說明是通過IP的方式發送的指令，也即是小循環發送。

通過該日志，可以看出二進制指令是否按照協議文檔收發，是否能正常解析為JSON格式，解析的JSON格式是否正確。具體的分析過程會在本文檔后面進一步描述。

大循環收發指令

小循環發送指令通過MQTT方式進行收發。開發者調用SDK方法，傳入JSON格式的指令，由SDK內部解析成為二進制指令，并發送給設備。設備收到后做出狀態改變，按照機智云串口協議要求，把自己的狀態用二進制指令返回，SDK收到后再封裝為JSON格式，回調給相關接口。詳見下圖：

其中“writePm（）”說明是通過MQTT的方式發送的指令，也即是大循環發送。

“readPm（）”說明時通過MQTT的方式接收到指令，也就是大循環接收。

通過該日志，可以看出二進制指令是否按照協議文檔收發，是否能正常解析為JSON格式，解析的JSON格式是否正確。具體的分析過程會在本文檔后面進一步描述。

收發指令詳解

SDK收發指令的過程，均在SDK中打印顯示，App的調試，也可以從日志中獲得大量很有用的信息。一個收發指令的過程如下圖：

一次指令的收發，具體經過了以下幾個步驟：

1.調用SDK的“write（）”方法發送JSON指令

如上圖日志中的JSON指令，包含了“fan_speed”這個數據點。通過該日志，可以看出發送的JSON格式是否正確，數據點是否正確，數據點的key跟value是不是目標數據。

2.SDK把JSON指令解析為原始業務指令

“writeP0（）”代表了SDK把JSON格式的指令解析為二進制指令，下面會打印出字節格式的指令。

3.SDK把二進制指令小循環發往設備或大循環發往云端

“writePm（）”代表了SDK加入了機智云協議的包頭后把指令發往云端。

如果是“writePi（）”，則說明是小循環發送指令。

通過該日志，可以看出當前發送的指令屬于大循環還是屬于小循環。

4.SDK接收到本地或云端的二進制指令

“readPm（）”代表了SDK接收到了云端返回的二進制指令，如果是”readPi（）”，則說明SDK接收到了本地設備返回的二進制指令。

通過該日志，可以看出當前接收的指令屬于大循環還是屬于小循環。

5.SDK把二進制指令去除包頭后變為原始業務指令

如果SDK接收到了云端的指令，會去除機智云協議的包頭，保留原始的字節業務指令并打印在控制臺中。

6.SDK把原始業務指令封裝為JSON格式

SDK獲取到二進制指令后會根據自動加載的配置文件解析為JSON格式指令。如上圖的“receive data”中打印出的JSON指令。通過該日志，可以看出解析是否正常以及具體每個數據點的key和value。

7.SDK把JSON格式指令通過接口回調給UI層

SDK解析結束后會通過回調接口把數據回調到UI層，TAG為“XPGWiFiSDK”，接口名一般是”did”開頭，例如圖中的”didReceiveData”。

通過該日志可以看出SDK是否已經成功調用了回調接口，以及調用的回調接口具體的接口名。

編輯：jq