本文介绍了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-venvWindows
根据系统位宽选择安装:
下载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)