本文介紹了Python Link SDK推薦的開發環境以及開發環境的設定。
環境配置
推薦使用Python 3.6及以上版本。
Python Link SDK在下面的作業系統上進行了驗證,為了避免開發與運行時出錯,請盡量選用與阿里雲一致的軟體環境。
Linux:Ubuntu 18.04 64-bit及以上版本。
Windows:Windows 7 64-bit及以上版本。
macOS:High Sierra。
使用前必讀
本文以Python 3.6版本為例,介紹環境的安裝和配置。如果安裝更高版本,只需將相關命令中
python3.6
的版本號碼換成對應的高版本號碼。例如:python3.9
。本文操作命令以普通使用者權限為例。如果您在操作過程中涉及到管理員權限才能執行的操作,可嘗試使用
sudo
命令執行。
安裝Python 3.6
Linux和macOS
步驟一:安裝Python3工具
如果已安裝python 3.6或更高版本,請跳過此步驟。
Linux
您可通過命令列或源碼安裝:
命令列安裝:適用於Ubuntu 18.04及以上版本。
sudo apt-get update sudo apt install software-properties-common sudo add-apt-repository ppa:deadsnakes/ppa sudo apt-get install wget python3.6
源碼安裝:不支援命令安裝的作業系統推薦使用源碼安裝。
sudo apt-get install wget gcc make zlib1g-dev wget https://www.python.org/ftp/python/3.6.7/Python-3.6.7.tgz tar -xf Python-3.6.7.tgz cd Python-3.6.7 ./configure make -j sudo make install
macOS
通過此連結進行下載:macOS下載。
步驟二:安裝PIP
擷取PIP指令碼。
Python 3.6版本:
wget https://bootstrap.pypa.io/pip/3.6/get-pip.py
Python 3.7及以上版本:
wget https://bootstrap.pypa.io/get-pip.py
安裝PIP。
以安裝Python 3.6的PIP為例,更高版本,只需替換命令中
python3.6
的版本號碼。例如:python3.9
。sudo apt-get install python3-distutils sudo python3.6 get-pip.py
步驟三:安裝setuptools、wheel和venv
裝置端SDK編譯運行需要安裝包管理工具setuptools、編譯依賴包wheel和venv(Virtual Environment)。
執行以下命令:
python3.6 -m pip install --upgrade pip setuptools wheel
sudo apt-get install python3.6-venv
Windows
根據系統位寬選擇安裝:
下載Demo
通過此連結下載Demo檔案:擷取exmaple範例程式碼。
配置環境
建議使用者使用paho-mqtt的1.4.0或1.5.1版本,這兩個版本已經做過壓力測試,可使用pip list
命令查看paho-mqtt的版本號碼。
Linux和macOS
建立和啟用VirtualEnvironments。
安裝Link SDK:可選擇自動安裝或者手動安裝。
自動安裝
執行以下命令安裝paho-mqtt 1.4.0版本。
pip install paho-mqtt==1.4.0
執行以下命令安裝Link SDK最新版本。
pip install aliyun-iot-linkkit
手動安裝
下載Link SDK以及需要使用到開源的MQTT庫:擷取最新版本的Python Link SDK、擷取開源MQTT庫paho。
當前linkkit最新版本為1.2.13。
將aliyun-iot-linkkit-1.2.13.tar.gz和paho-mqtt-1.4.0.tar.gz放到work_dir目錄下,然後執行以下命令:
tar zxvf paho-mqtt-1.4.0.tar.gz cd paho-mqtt-1.4.0 python3 setup.py install cd .. tar zxvf aliyun-iot-linkkit-1.2.13.tar.gz cd aliyun-iot-linkkit-1.2.13 python3 setup.py install cd ..
mkdir work_dir
cd work_dir
python3.6 -m venv test_env
source test_env/bin/activate
pip install wheel
Windows
建立和啟用VirtualEnvironments。
mkdir work_dir cd work_dir python3.6 -m venv test_env test_env\Scripts\activate.bat
安裝Link SDK:可選擇自動安裝或者手動安裝。
自動安裝
執行以下命令安裝paho-mqtt 1.4.0版本。
pip install paho-mqtt==1.4.0
執行以下命令安裝Link SDK最新版本。
pip install aliyun-iot-linkkit
手動安裝
下載Link SDK以及需要使用到開源的MQTT庫:擷取最新版本的Python Link SDK、擷取開源MQTT庫paho。
當前linkkit最新版本為1.2.13。
將paho-mqtt-1.4.0.tar.gz和aliyun-iot-linkkit-1.2.13.tar.gz放到work_dir目錄下並操作解壓,再執行以下命令。
cd paho-mqtt-1.4.0 python setup.py install cd .. cd aliyun-iot-linkkit-1.2.13 python setup.py install cd ..
日誌開關
開啟SDK內部日誌輸出開關。
import logging
__log_format = '%(asctime)s-%(process)d-%(thread)d - %(name)s:%(module)s:%(funcName)s - %(levelname)s - %(message)s'
logging.basicConfig(format=__log_format)
如果需要開啟Debug開關,方法如下:
lk_auth.enable_logger(logging.DEBUG)