本文介绍了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)