环境要求与配置

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

  1. 获取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
  2. 安装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

  1. 创建和激活VirtualEnvironments。

  2. mkdir work_dir
    cd work_dir
    python3.6 -m venv test_env
    source test_env/bin/activate
    pip install wheel            
  3. 安装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 ..
        

Windows

  1. 创建和激活VirtualEnvironments。

    mkdir work_dir
    cd work_dir
    python3.6 -m venv test_env
    test_env\Scripts\activate.bat            
  2. 安装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)